QuickShopDelivery

QuickShopDelivery

This mod is a client-only mod that lets the player quickly teleport the shop item they are holding into the shop delivery area, or move it back outside if it is already inside the delivery area.

It uses the game's own PhysGrabObject.Teleport() flow instead of adding a custom network RPC. When a non-host player uses it, the vanilla position update request is sent to the host through the game's existing RPC path.

Features

• Teleports the held shop item into the shop delivery area.
• Teleports the held shop item back outside when it is already inside the delivery area.
• Works when only the host has the mod, for the host player's own held item.
• Works when only a client has the mod, for that client's own held item.
• Does not directly edit the shop list, shop total, or purchase state.
• Uses the host's normal shop delivery detection after the item is moved into or out of the delivery area.
• Supports right click, middle click, or custom hotkey activation.
• Allows immediate delivery of the next item after a previous delivery action.

How to use

• Enter the shop.
• Pick up a shop item.
• Press the configured teleport action.
• If the item is outside the delivery area, it is released and teleported into the delivery area.
• If the item is already inside the delivery area, it is released and teleported back outside.

Default action: right click.

Multiplayer behavior

This is a client-only mod, but it only affects the player who installed it.

If the host is the only player with the mod, only the host can use the quick delivery action.

If a non-host client is the only player with the mod, that client can use the quick delivery action for their own held shop items. The host does not need this mod for that player's own delivery action because the mod uses the game's existing item position RPC path.

Players without the mod cannot use the quick delivery action. To make non-modded players use a special delivery action, a separate host-only version would be needed.

Config

General.Enabled

• Description: Enables or disables QuickShopDelivery.
• Default: true
• Minimum: N/A
• Maximum: N/A

Input.TeleportAction

• Description: Selects the action used to teleport the held shop item. Valid values are RightClick, MiddleClick, and Hotkey.
• Default: RightClick
• Minimum: N/A
• Maximum: N/A

Input.Hotkey

• Description: Hotkey used only when TeleportAction is set to Hotkey. Examples: A, Z, 1, 0, T, F1, Space, Minus, Slash, Semicolon, BackQuote.
• Default: T
• Minimum: N/A
• Maximum: N/A

Input.RequireCrouch

• Description: Requires crouching while using the selected teleport action.
• Default: false
• Minimum: N/A
• Maximum: N/A

Delivery.CooldownSeconds

• Description: Cooldown for repeating delivery on the same item after one teleport attempt. Different items can still be delivered immediately.
• Default: 0.15
• Minimum: Effective minimum 0.01
• Maximum: No hard limit

Delivery.ReleaseDelaySeconds

• Description: Delay after releasing the held item before teleporting it.
• Default: 0.08
• Minimum: Effective minimum 0.01
• Maximum: Effective maximum 0.50

Delivery.ReleaseDisableSeconds

• Description: Grab disable time applied when the held item is released.
• Default: 0.05
• Minimum: Effective minimum 0.01
• Maximum: Effective maximum 0.10

Delivery.DropHeightOffset

• Description: Vertical offset from the center of the extraction RoomVolume when moving an item into the delivery area.
• Default: 0.35
• Minimum: No hard limit
• Maximum: Clamped inside the delivery RoomVolume height

Delivery.DropSpreadRadius

• Description: Horizontal spread radius used to reduce item overlap. Set 0 to always use the center. This is also reused as a small spread when moving an item outside.
• Default: 0.25
• Minimum: Effective minimum 0
• Maximum: Clamped inside the delivery RoomVolume bounds when moving inside

Delivery.ToggleIfAlreadyInExtraction

• Description: Teleports the held item outside when it is already inside the extraction area. I