Rust Vehicles GUI 1.0.5

Rust Vehicle GUI​

Overview​

Modern GUI for vehicle purchasing and management in Rust.
Replaces chat commands with a visual interface and supports ServerPanel integration.
Works with free VehicleLicense plugin on Umod but recommended to use my version
RustVehicles which is 8K lines of code shorter and adds vehicles dynamically only adding the vehicles you have and not 300+ vehicles you don't, like the free version which can cause packet flooding if you reload it on a live server. Also, my version has a /pickup command for players to pick vehicles up when done and not persist on your server using up resources.

Features​

• Visual Vehicle Shop — Browse vehicles by category (Air, Land, Water, Train, Siege)
• Vehicle Management — View owned vehicles and spawn/recall them
• Category Filtering — Filter by Air, Land, Water, Train, or Siege
• Pagination — Navigate large vehicle lists
• Image Support — Vehicle images with local file support
• Mevents ServerPanel Integration — Accessible from ServerPanel menu
• Permission System — Supports VIP-only vehicles
• Economy Integration — Works with Scrap, Economics, and ServerRewards

Commands​

• /license - Open vehicle GUI
• /vehiclebuy - Open vehicle shop
• /l - Quick access shortcut
• /vb - Quick access shortcut
• /rv - Quick access shortcut
• /rustvehicles - Quick access shortcut

Configuration​

• Customizable chat commands
• Image throttling settings
• Debug logging toggle
• Auto-register local images

Requirements​

• RustVehicles OR VehicleLicence plugin (one required)

Required Dependencies

• RustVehicles
• OR VehicleLicence
• Vehicle Images Zip

Optional Dependencies

• Economics
• ServerRewards
• Server Panel

Installation Instructions​

Automatic Setup​

The plugin loads automatically when placed in your oxide/plugins folder. No manual configuration is required for basic functionality.

Step-by-Step Installation​

1. Upload Plugin​

• Place RustVehiclesGUI.cs in your oxide/plugins folder
• Restart your server or use oxide.reload RustVehiclesGUI

2. Required Dependencies

• Ensure RustVehicles OR VehicleLicence plugin is installed and loaded
• The plugin will automatically detect which one is active

3. Configuration File

• On first load, a config file is automatically created at oxide/config/RustVehiclesGUI.json
• Default settings work out of the box
• Customize chat commands, ServerPanel tab name, and other options as needed

4. Vehicle Images (Optional)

• Create directory: oxide/data/RustVehiclesGUI/images/
• Place vehicle images as PNG files (e.g., MiniCopter.png, Sedan.png)
• Vehicle Images ZIP
• Image names match vehicle display names (spaces removed, PascalCase)
• Enable auto-registration in config
• "Auto Register Local Images": true
• Images are automatically registered on server start if enabled

6. ServerPanel Integration (Optional)

Using ServerPanel UI

• Open ServerPanel in-game (requires: ServerPanel edit permission)
• Click 'Add Category' button
• In the Edit Category window, fill in:
• Title: {Desired Nane} Example: VEHICLES
• Commands: Click the open button and in pop up type vehicles then click the X
• Show Pages: true
• Chat Button: false

In the Pages section, set:

• Type (Plugin/UI): Plugin
• Plugin Name: RustVehiclesGUI
• Plugin Hook: API_OpenPlugin
• Click Create
  

Verification​

• Type /license or /vehiclebuy in-game to open the GUI
• If ServerPanel is installed, check for the "Rust Vehicle" tab in the ServerPanel menu
• Check server console for any error messages

Troubleshooting​

• GUI doesn't open: Ensure RustVehicles or VehicleLicence is loaded
• ServerPanel tab missing: Check that ServerPanel is loaded and Enable ServerPanel Integration is true in config
• No vehicle images: Verify images are in oxide/data/RustVehiclesGUI/images/ and Auto Register Local Images is enabled
• Permission errors: Ensure players have RustVehicles.use or VehicleLicence.use permission