Rust Vehicles 2.0.4

RustVehicles — Full Vehicle Licensing + Spawn System

This is a re-write to a free version offered here VehicleLicense.

• My version offers new features, optimizations and support for future updates or request.
• 27+ Built-in Vehicles: Supports all standard Rust vehicles including bikes, boats, helicopters, trains, modular cars, submarines, siege weapons, and more
• Custom Vehicle Support: Dynamically discover and configure custom vehicles from config folders
• License System: Players purchase vehicle licenses that persist across sessions
• Spawn & Recall: Spawn vehicles on demand and recall them when needed
• Vehicle Pickup: Pick up and store your vehicles using the `/pickup` command (requires permission)
• Cooldown System: Configurable cooldowns for spawn/recall with bypass options
• Permission System: Granular permissions for different vehicle types and actions
• Fuel & Inventory Management: Automatic fuel spawning and inventory refunds on crash/kill
• Team/Clan/Friends Integration: Share vehicle access with teammates, clan members, or friends
• Zone Protection: Prevent spawning in safe zones or custom-protected areas
• Damage Control: Configurable damage prevention for vehicles and collisions
• Modular Car Support: Full support for modular vehicles with engine and module customization
• Train System: Complete train component system with engines, wagons, and cabooses
• GUI Support: Compatible with *RustVehiclesGUI* for enhanced user experience


Commands

• /license — Show help menu
• /buy [vehicle] — Purchase a vehicle license
• /spawn [vehicle] — Spawn your vehicle
• /recall [vehicle] — Recall your vehicle
• /kill [vehicle] — Destroy your vehicle
• /pickup — Pick up nearby vehicles (with permission)

Configuration

Highly configurable with settings for:

• Purchase, spawn, and recall prices
• Cooldown timers
• Vehicle health, speed, and behavior
• Permission requirements
• Zone restrictions
• Damage prevention
• Fuel and inventory management
• And much more!

All dependencies are optional — the plugin works standalone but integrates with popular plugins for enhanced functionality.


Step-by-Step Guide: Populating Custom Karuza Vehicles into RustVehicles Config

Prerequisites

• RustVehicles plugin installed
• Karuza vehicle files ready (KaruzaCatalog or custom JSON configs)

Step 1: Create the KaruzaCatalog folder

Create:

oxide\config\KaruzaCatalog


Step 2: Place KaruzaVehicleItemManager.cs

Copy into:

oxide\config\KaruzaCatalog\KaruzaVehicleItemManager.cs


This file provides prefab paths + skin IDs for custom vehicles.


Step 3: Enable custom vehicle population

Open:

oxide\config\RustVehicles.json

Find:

"Populate the config with Custom Vehicles (CANNOT BE UNDONE! Will make config much larger)": false,


Change to:

"Populate the config with Custom Vehicles (CANNOT BE UNDONE! Will make config much larger)": true,


Step 4: Save and reload the plugin

1. Save the config
2. Reload plugin:
• Console: oxide.reload RustVehicles
• Or restart server


Step 5: Verify the process

On load, the plugin will:

1. Load catalog from KaruzaVehicleItemManager.cs
2. Discover custom vehicles from:
• RustCar
• RustHelicopter
• RustPlane
3. Populate them into Custom Vehicle Settings
4. Automatically set useCustomVehicles back to false
5. Save the updated config


Step 6: Check the results

Look for console messages like:
And verify:

• Custom Vehicle Settings now contains all discovered vehicles
• useCustomVehicles is reset too false


Step 7: Customize settings (optional)

You may edit:

• Prices
• Cooldowns
• Permissions
• Commands
• Vehicle behaviors
• Any other per-vehicle setting


Important Notes

• This is a one-time operation unless you add new vehicles
• Config will become larger after population
• useCustomVehicles resets automatically
• If adding new vehicles later, set to `true` again and reload
• Vehicle types are categorized automatically:
• Planes/helicopters → MiniCopterSettings
• Cars → SedanSettings


Troubleshooting

• No vehicles discovered:
• Catalog file missing or unreadable
• Invalid JSON in custom folders
• Incorrect prefab paths

• Missing PrefabPath:
The plugin attempts to pull from KaruzaCatalog. If not found → vehicle skipped with a warning.

• Config not saving:
Ensure write permissions on the config directory.


Example Custom Vehicle JSON



Default generated settings include:
• Purchase price: 10,000 scrap
• Spawn cooldown: 450 seconds
• Recall cooldown: 30 seconds
• Permission: RustVehicles.vehiclename
• Command: vehicle name (lowercase)

You can freely customize these afterward.

How to Change Currency

In your RustVehicles.json config file, for any vehicle's price section (Purchase Prices, Spawn Prices, Recall Prices, etc.), change the key from an item short name to:

- "economics" - to use the Economics plugin
- "serverrewards" - to use the ServerRewards plugin

Example: Change Tugboat from Scrap to Economics

Before:


After (using Economics):


After (using ServerRewards):

Notes:
1. The key must be exactly `"economics"` or `"serverrewards"` (case-insensitive, but lowercase is standard).
2. You can mix currencies — e.g., require both Economics and items.
3. The `displayName` is what players see in error messages.