Deployable Pickup
A downloadable mod
Deployable Pickup
Pick up deployables that vanilla Rust will never let you reclaim. Vending machines, large furnaces, small oil refineries, water catchers and more — recovered with a single chat command.
Reclaim What Rust Refuses to Return
Misplaced a vending machine? Need to relocate that large furnace?
Aim at the deployable, type /pickup,
and it returns to your inventory as the original item — vanilla-style empty checks included.
Features
|
♻️
One-Command Pickup
Aim at a supported deployable within 5 meters and run |
📝
Shortname-Based Config
Define the eligible deployables by Rust item shortname — the same identifier used by
|
|
🔐
Permission-Based
Uses Oxide's permission system. Only players with |
📦
Vanilla-Like Empty CheckPickup is refused while the deployable still holds items, fuel, or burnable contents — the same rule Rust applies to natively pickupable structures. |
|
🌐
EN / JA Chat Messages
All player-facing messages are localized through Oxide's |
🔧
Debug Subcommand
Run |
How It Works
| → A player with the required permission aims at a configured deployable. |
→
The player runs /pickup
in chat.
|
| → The plugin scans up to 5 meters along the view ray and identifies a configured target deployable. |
| → If the deployable still has contents (inventory items, fuel, burnables), pickup is refused with a chat reply. |
| → Otherwise, the entity is removed and the matching item is granted to the player. Wear is preserved when the prefab supports condition-from-health. |
| → Entities not listed in the config are completely ignored — no inspection, no side effects. |
Configuration
A configuration file is automatically generated at
oxide/config/DeployablePickup.json
on first load. List the Rust item shortnames you want to be pickupable.
{
"Command name": "pickup",
"Pickupable item shortnames": [
"vending.machine",
"furnace.large",
"small.oil.refinery",
"cursedcauldron",
"water.catcher.small",
"water.catcher.large"
]
}
| Option | Type | Description |
|---|---|---|
Command name
|
string
|
Top-level chat command name. Default pickup.
Change this if it conflicts with another plugin. |
Pickupable item shortnames
|
string[]
|
Rust item shortnames that should become pickupable. Unknown shortnames or items without a deployable component are silently skipped at load time. |
Default Targets
| Display Name | Shortname |
|---|---|
| VENDING MACHINE | vending.machine
|
| LARGE FURNACE | furnace.large
|
| SMALL OIL REFINERY | small.oil.refinery
|
| CURSED CAULDRON | cursedcauldron
|
| SMALL WATER CATCHER | water.catcher.small
|
| LARGE WATER CATCHER | water.catcher.large
|
Chat Commands
The default top-level command name is pickup
(configurable via Command name).
| Command | Action |
|---|---|
/pickup
|
Pick up
the configured deployable within 5 meters along the view ray (alias of pick).
|
/pickup help
|
Show subcommand help. |
/pickup pick
|
Pick up the configured deployable within 5 meters along the view ray (explicit form). |
/pickup debug
|
Print target-resolution diagnostics to the server console. No pickup is performed and no chat reply is sent. |
Installation
|
1
Copy the plugin file Place DeployablePickup.cs
into your server's oxide/plugins/
directory.
|
|
2
Start or restart your server The config file will be generated automatically at oxide/config/DeployablePickup.json.
|
|
3
Edit the configuration Add or remove shortnames in the Pickupable item shortnames
list to match the deployables you want pickupable.
|
|
4
Reload the plugin Run oxide.reload DeployablePickup
in the server console to apply changes.
|
|
5
Grant permission Give deployablepickup.use
to the players or groups that should be able to use /pickup.
|
Permission
Required to run /pickup
and /pickup debug.
Players without the permission receive a localized denial message and nothing happens to the targeted
deployable.
Grant Permission
oxide.grant user <SteamID> deployablepickup.use oxide.grant group <groupName> deployablepickup.use
Revoke Permission
oxide.revoke user <SteamID> deployablepickup.use oxide.revoke group <groupName> deployablepickup.use
Important Notes
Pickup follows vanilla rules: the deployable must be empty. Storage inventories, fuel slots and burnable child slots all need to be cleared first or the pickup is refused with a chat message.
The plugin only resolves targets within 5 meters of the player's view origin. Stand close to the deployable and aim directly at it for the best result.
Only items that ship with a deployable component can be added to Items.
Non-deployable shortnames are skipped silently at load and never become pickup targets.
Adding shortnames widens what players can recover from the world.
Review the configured list against your server's economy and PvP rules,
and grant deployablepickup.use
only to roles you trust.
Deployable Pickup — An Oxide plugin for Rust dedicated servers.
Made by little method
Download
Click download now to get access to the following files:
Leave a comment
Log in with itch.io to leave a comment.