Vehicle Upgrades
A downloadable mod
Vehicle Upgrades
Attach storage, signs, search lights, and oil refineries to your vehicles with a single chat command. Supports helicopters, bikes, boats, and more.
Equip Your Vehicles
Look at a supported vehicle, hold the required items in your inventory,
and run /vehicle upgrade.
Storage, signs, search lights, and refineries snap into place instantly.
Features
|
📦
Storage AttachmentMount a Small Stash onto helicopters, motorbikes, and the Tugboat. Contents drop to the ground when the vehicle is destroyed, so nothing is lost. |
🚫
Bury-Proof StorageStashes attached to vehicles cannot be buried underground. Your gear stays accessible and never disappears into the terrain. |
|
🔋
Search Light SyncSearch lights turn on automatically when the engine starts or a player mounts, and switch off when the engine stops or the vehicle is empty. |
📝
Sign MountingAttach blank Small or Medium Wooden Signs to your vehicle. Draw on them after mounting. Only undrawn signs are accepted. |
|
⚙️
Oil Refinery on TugboatAdd a Small Oil Refinery to your Tugboat. Combined with two Medium Signs and a Search Light, the Tugboat becomes a fully kitted-out mobile base. |
🔐
Code Lock IntegrationWorks with code-locked vehicles (e.g. via Lockable Deployables). Unauthorized players cannot upgrade the vehicle or open attached storage. |
|
🔄
Reload-Safe State RestoreAll vehicles are scanned on plugin load or reload. Bury-proofing and light sync resume immediately with no manual intervention. |
📏
Placement ControlEvery equipment slot has individually configurable position, rotation, and scale. Supports EntityScaleManager for precise sizing when installed. |
Supported Vehicles
| Vehicle | Category | Equipment |
|---|---|---|
| Attack Helicopter | Helicopter | Small Stash ×1, Small Wooden Sign ×1 |
| Minicopter | Helicopter | Small Stash ×1, Small Wooden Sign ×1, Search Light ×1 |
| Scrap Transport Helicopter | Helicopter | Small Stash ×2 (left & right), Small Wooden Sign ×1 |
| Bicycle | Bike | Search Light ×1 |
| Motorbike | Bike | Small Stash ×1 |
| Motorbike With Sidecar | Bike | Small Stash ×1, Small Wooden Sign ×1 |
| Trike | Bike | Search Light ×1 |
| RHIB | Boat | Small Wooden Sign ×1 |
| Tugboat | Boat | Medium Wooden Sign ×2 (left & right), Small Oil Refinery ×1, Search Light ×1 |
How It Works
| → Place the required items (Small Stash, Sign, Search Light, or Small Oil Refinery) in your inventory. |
| → Look directly at a supported vehicle within 5 meters. |
→
Run /vehicle upgrade. The plugin checks which slots are empty and which items you own.
|
| → Items are consumed from your inventory and equipment snaps into the configured positions on the vehicle. |
| → The chat reports what was installed and what items were missing for any remaining empty slots. |
Commands
| Command | Description |
|---|---|
/vehicle help
|
Show the list of available subcommands. |
/vehicle upgrade
|
Attach available equipment to the vehicle you are looking at. |
The top-level command name vehicle can be changed in the configuration file.
Configuration
A configuration file is automatically generated at
oxide/config/VehicleUpgrades.json
on first load.
{
"General settings": {
"Chat command name (1-32 alphanumeric; default: vehicle)": "vehicle"
},
"Vehicle equipment placement settings": {
"Minicopter": {
"Storage": {
"Position offset X (meters; range: -10.0 - 15.0)": 0.0,
"Position offset Y (meters; range: -10.0 - 15.0)": 0.0,
"Position offset Z (meters; range: -10.0 - 15.0)": 0.0,
"Rotation X (degrees; range: -360.0 - 360.0)": 0.0,
"Rotation Y (degrees; range: -360.0 - 360.0)": 0.0,
"Rotation Z (degrees; range: -360.0 - 360.0)": 0.0,
"Scale (1.0 = default; range: 0.1 - 10.0)": 1.0
},
"SearchLight": { "...": "..." },
"Sign": { "...": "..." }
},
"Tugboat": {
"Sign0": { "...": "..." },
"Sign1": { "...": "..." },
"OilRefinery": { "...": "..." },
"SearchLight": { "...": "..." }
}
}
}
| Option | Default | Description |
|---|---|---|
Chat command name
|
vehicle
|
Top-level chat command name. 1–32 alphanumeric characters. |
Position offset X/Y/Z
|
0.0
|
Position offset in meters relative to the vehicle origin. Range: −10.0 – 15.0. |
Rotation X/Y/Z
|
0.0
|
Rotation in degrees (Euler angles). Range: −360.0 – 360.0. |
Scale
|
1.0
|
Equipment scale factor. Requires EntityScaleManager to take effect. Range: 0.1 – 10.0. |
Installation
|
1
Copy the plugin file Place VehicleUpgrades.cs
into your server's oxide/plugins/
directory.
|
|
2
Start or restart your server The config file is generated automatically at oxide/config/VehicleUpgrades.json.
|
|
3
Grant permissions Grant vehicleupgrades.use
to players or groups who should be able to upgrade vehicles.
|
|
4
Adjust placement (optional) Edit position, rotation, and scale values per vehicle in the config, then run oxide.reload VehicleUpgrades.
|
Permissions
Required to use all /vehicle subcommands, including help.
Players without this permission cannot interact with the plugin at all.
Grant Permission
oxide.grant user <SteamID> vehicleupgrades.use oxide.grant group <group> vehicleupgrades.use
Revoke Permission
oxide.revoke user <SteamID> vehicleupgrades.use
Important Notes
Only undrawn (blank) signs can be attached to vehicles. Signs that already have artwork drawn on them will be skipped.
Scale settings only take effect when the EntityScaleManager plugin is also installed. The plugin works normally without it — equipment is placed at default size.
If a vehicle has a code lock attached (e.g. via Lockable Deployables), only players
who are authorized on that lock can upgrade the vehicle or access its storage.
Unauthorized players are blocked even if they hold the
vehicleupgrades.use permission.
Default placement values are pre-tuned but may need adjustment to fit custom server modpacks or vehicle skins. Use the config to fine-tune position, rotation, and scale per vehicle type. Out-of-range values are automatically reset to defaults on load.
Vehicle Upgrades — 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.