Browse/Rust/Plugins/Fuel Monitor

Fuel Monitor

Khaled★ 0.0 (0)v4.5.4OxideCarbon#fuel #minicopter #hud #warning

1 / 5

Description

FuelMonitor is a lightweight and fully customizable Rust plugin that displays a clean, modern fuel HUD while driving fuel-powered vehicles.

The plugin features a real-time updating fuel bar, low fuel popup notifications, sound alerts when fuel is running low, and a clear OUT OF FUEL warning when the tank is empty.

FuelMonitor now also includes a built-in speedometer, allowing players to view their current speed directly from the HUD, with support for both Km/h and MPH display modes.

An in-game Admin Settings UI is included, allowing server owners to manage the plugin directly in-game through a clean and safe workflow. With the settings panel, admins can:

Preview changes live before applying them

Adjust the Global Max Fuel value

Reposition the main Fuel UI using Move Mode

Reposition popup warning notifications using Warning Move Mode

Customize all UI colors

Enable or disable the speedometer

Switch speed units between Km/h and MPH

FuelMonitor also includes a dedicated Vehicles tab inside the Admin Settings UI, allowing full per-vehicle customization. Server owners can create and manage vehicle-specific profiles for all supported vehicles, including:

Enable or disable the HUD per vehicle

Enable or disable warning sounds per vehicle

Set a custom max fuel value per vehicle

Choose whether low fuel warnings use Amount or Percent mode

Configure custom low fuel warning thresholds

Configure custom fuel bar gradient thresholds

Preview each vehicle profile live before applying changes

Reset a single vehicle profile or apply one vehicle profile to all vehicles

All changes are handled through a safe pending workflow with Apply / Cancel controls, ensuring nothing is pushed live until the admin confirms it. Once applied, changes affect all players server-wide.

-

#Admin
Commands : /fui

FuelMonitor works automatically in the background, is performance-friendly, and requires no player commands.

Need Support?

Default configuration

FuelMonitor.json

{
  "UI Position": {
    "Anchor Min (x y)": "0.4 0.11",
    "Anchor Max (x y)": "0.58000004 0.159",
    "Offset (x y)": {
      "x": 0.0,
      "y": 0.0
    }
  },
  "Move Mode": {
    "Force cursor while moving": true,
    "Preview fuel amount while moving": 500,
    "Allow command /fui (admin only)": true
  },
  "VIP Only (Requires permission fuelmonitor.vip)": false,
  "UI Max Fuel Override (0 = Auto)": 1000,
  "UI Theme": {
    "Background Hex": "#1A1A1A99",
    "Out of fuel Background Hex": "#660000E6",
    "Number Box Hex": "#141617E6",
    "Bar Outline Hex": "#000000D9",
    "Bar Slot Hex": "#141617E6",
    "Fuel Bar High Hex": "#00FF00E6",
    "Fuel Bar Mid Hex": "#FF8000E6",
    "Fuel Bar Low Hex": "#FF0000E6",
    "Fuel Label Hex": "#FFFFFF",
    "Fuel Amount Hex": "#FFFFFF",
    "Warning Hex": "#FF0000"
  },
  "Speedometer": {
    "Enabled": true,
    "Show Label": true,
    "Display Unit": 1
  },
  "Low Fuel Sound": {
    "Enabled": true,
    "Trigger percent (0.0 - 1.0)": 0.15,
    "Trigger amount (0 = disabled)": 0,
    "Repeat interval seconds": 20.0,
    "Show Center Warning": true,
    "Center Warning Duration Seconds": 2.6,
    "Center Warning Fade Seconds": 0.35,
    "Center Warning UI Position": {
      "Anchor Min (x y)": "0.36 0.56",
      "Anchor Max (x y)": "0.64 0.64",
      "Offset (x y)": {
        "x": 0.0,
        "y": 0.0
      }
    },
    "Effect prefab": "assets/prefabs/locks/keypad/effects/lock.code.denied.prefab"
  },
  "Vehicle Gauge Rules": {
    "Default Enabled (if vehicle not listed)": true,
    "Vehicles (In-Game Name -> Enabled)": {
      "Minicopter": true,
      "Scrap Transport Helicopter": true,
      "Attack Helicopter": true,
      "Hot Air Balloon": true,
      "Rowboat": true,
      "RHIB": true,
      "Tugboat": true,
      "Patrol Boat": true,
      "Player Boat": true,
      "Submarine": true,
      "Submarine Duo": true,
      "Modular Car": true,
      "Snowmobile": true,
      "Motorbike": false,
      "Motorbike Sidecar": false,
      "Work Cart": true,
      "Armored Work Cart": true,
      "Locomotive": true
    }
  },
  "Vehicle Profiles": {
    "Vehicles (In-Game Name -> Profile)": {
      "Minicopter": {
        "Enabled": true,
        "Use Custom Max Fuel": false,
        "Max Fuel Override": 0,
        "Warning Mode": 2,
        "Low Fuel Percent (0.0 - 1.0)": 0.15,
        "Low Fuel Amount": 0,
        "Sound Enabled": true,
        "Use Custom Gradient": false,
        "Mid Threshold (0.0 - 1.0)": 0.6,
        "Low Threshold (0.0 - 1.0)": 0.2
      },
      "Scrap Transport Helicopter": {
        "Enabled": true,
        "Use Custom Max Fuel": false,
        "Max Fuel Override": 0,
        "Warning Mode": 2,
        "Low Fuel Percent (0.0 - 1.0)": 0.15,
        "Low Fuel Amount": 0,
        "Sound Enabled": true,
        "Use Custom Gradient": false,
        "Mid Threshold (0.0 - 1.0)": 0.6,
        "Low Threshold (0.0 - 1.0)": 0.2
      },
      "Attack Helicopter": {
        "Enabled": true,
        "Use Custom Max Fuel": false,
        "Max Fuel Override": 0,
        "Warning Mode": 2,
        "Low Fuel Percent (0.0 - 1.0)": 0.15,
        "Low Fuel Amount": 0,
        "Sound Enabled": true,
        "Use Custom Gradient": false,
        "Mid Threshold (0.0 - 1.0)": 0.6,
        "Low Threshold (0.0 - 1.0)": 0.2
      },
      "Hot Air Balloon": {
        "Enabled": true,
        "Use Custom Max Fuel": false,
        "Max Fuel Override": 0,
        "Warning Mode": 2,
        "Low Fuel Percent (0.0 - 1.0)": 0.15,
        "Low Fuel Amount": 0,
        "Sound Enabled": true,
        "Use Custom Gradient": false,
        "Mid Threshold (0.0 - 1.0)": 0.6,
        "Low Threshold (0.0 - 1.0)": 0.2
      },
      "Rowboat": {
        "Enabled": true,
        "Use Custom Max Fuel": false,
        "Max Fuel Override": 0,
        "Warning Mode": 2,
        "Low Fuel Percent (0.0 - 1.0)": 0.15,
        "Low Fuel Amount": 0,
        "Sound Enabled": true,
        "Use Custom Gradient": false,
        "Mid Threshold (0.0 - 1.0)": 0.6,
        "Low Threshold (0.0 - 1.0)": 0.2
      },
      "RHIB": {
        "Enabled": true,
        "Use Custom Max Fuel": false,
        "Max Fuel Override": 0,
        "Warning Mode": 2,
        "Low Fuel Percent (0.0 - 1.0)": 0.15,
        "Low Fuel Amount": 0,
        "Sound Enabled": true,
        "Use Custom Gradient": false,
        "Mid Threshold (0.0 - 1.0)": 0.6,
        "Low Threshold (0.0 - 1.0)": 0.2
      },
      "Tugboat": {
        "Enabled": true,
        "Use Custom Max Fuel": false,
        "Max Fuel Override": 0,
        "Warning Mode": 2,
        "Low Fuel Percent (0.0 - 1.0)": 0.15,
        "Low Fuel Amount": 0,
        "Sound Enabled": true,
        "Use Custom Gradient": false,
        "Mid Threshold (0.0 - 1.0)": 0.6,
        "Low Threshold (0.0 - 1.0)": 0.2
      },
      "Patrol Boat": {
        "Enabled": true,
        "Use Custom Max Fuel": false,
        "Max Fuel Override": 0,
        "Warning Mode": 2,
        "Low Fuel Percent (0.0 - 1.0)": 0.15,
        "Low Fuel Amount": 0,
        "Sound Enabled": true,
        "Use Custom Gradient": false,
        "Mid Threshold (0.0 - 1.0)": 0.6,
        "Low Threshold (0.0 - 1.0)": 0.2
      },
      "Player Boat": {
        "Enabled": true,
        "Use Custom Max Fuel": false,
        "Max Fuel Override": 0,
        "Warning Mode": 2,
        "Low Fuel Percent (0.0 - 1.0)": 0.15,
        "Low Fuel Amount": 0,
        "Sound Enabled": true,
        "Use Custom Gradient": false,
        "Mid Threshold (0.0 - 1.0)": 0.6,
        "Low Threshold (0.0 - 1.0)": 0.2
      },
      "Submarine": {
        "Enabled": true,
        "Use Custom Max Fuel": false,
        "Max Fuel Override": 0,
        "Warning Mode": 2,
        "Low Fuel Percent (0.0 - 1.0)": 0.15,
        "Low Fuel Amount": 0,
        "Sound Enabled": true,
        "Use Custom Gradient": false,
        "Mid Threshold (0.0 - 1.0)": 0.6,
        "Low Threshold (0.0 - 1.0)": 0.2
      },
      "Submarine Duo": {
        "Enabled": true,
        "Use Custom Max Fuel": false,
        "Max Fuel Override": 0,
        "Warning Mode": 2,
        "Low Fuel Percent (0.0 - 1.0)": 0.15,
        "Low Fuel Amount": 0,
        "Sound Enabled": true,
        "Use Custom Gradient": false,
        "Mid Threshold (0.0 - 1.0)": 0.6,
        "Low Threshold (0.0 - 1.0)": 0.2
      },
      "Modular Car": {
        "Enabled": true,
        "Use Custom Max Fuel": false,
        "Max Fuel Override": 0,
        "Warning Mode": 2,
        "Low Fuel Percent (0.0 - 1.0)": 0.15,
        "Low Fuel Amount": 0,
        "Sound Enabled": true,
        "Use Custom Gradient": false,
        "Mid Threshold (0.0 - 1.0)": 0.6,
        "Low Threshold (0.0 - 1.0)": 0.2
      },
      "Snowmobile": {
        "Enabled": true,
        "Use Custom Max Fuel": false,
        "Max Fuel Override": 0,
        "Warning Mode": 2,
        "Low Fuel Percent (0.0 - 1.0)": 0.15,
        "Low Fuel Amount": 0,
        "Sound Enabled": true,
        "Use Custom Gradient": false,
        "Mid Threshold (0.0 - 1.0)": 0.6,
        "Low Threshold (0.0 - 1.0)": 0.2
      },
      "Motorbike": {
        "Enabled": false,
        "Use Custom Max Fuel": false,
        "Max Fuel Override": 0,
        "Warning Mode": 2,
        "Low Fuel Percent (0.0 - 1.0)": 0.15,
        "Low Fuel Amount": 0,
        "Sound Enabled": true,
        "Use Custom Gradient": false,
        "Mid Threshold (0.0 - 1.0)": 0.6,
        "Low Threshold (0.0 - 1.0)": 0.2
      },
      "Motorbike Sidecar": {
        "Enabled": false,
        "Use Custom Max Fuel": false,
        "Max Fuel Override": 0,
        "Warning Mode": 2,
        "Low Fuel Percent (0.0 - 1.0)": 0.15,
        "Low Fuel Amount": 0,
        "Sound Enabled": true,
        "Use Custom Gradient": false,
        "Mid Threshold (0.0 - 1.0)": 0.6,
        "Low Threshold (0.0 - 1.0)": 0.2
      },
      "Work Cart": {
        "Enabled": true,
        "Use Custom Max Fuel": false,
        "Max Fuel Override": 0,
        "Warning Mode": 2,
        "Low Fuel Percent (0.0 - 1.0)": 0.15,
        "Low Fuel Amount": 0,
        "Sound Enabled": true,
        "Use Custom Gradient": false,
        "Mid Threshold (0.0 - 1.0)": 0.6,
        "Low Threshold (0.0 - 1.0)": 0.2
      },
      "Armored Work Cart": {
        "Enabled": true,
        "Use Custom Max Fuel": false,
        "Max Fuel Override": 0,
        "Warning Mode": 2,
        "Low Fuel Percent (0.0 - 1.0)": 0.15,
        "Low Fuel Amount": 0,
        "Sound Enabled": true,
        "Use Custom Gradient": false,
        "Mid Threshold (0.0 - 1.0)": 0.6,
        "Low Threshold (0.0 - 1.0)": 0.2
      },
      "Locomotive": {
        "Enabled": true,
        "Use Custom Max Fuel": false,
        "Max Fuel Override": 0,
        "Warning Mode": 2,
        "Low Fuel Percent (0.0 - 1.0)": 0.15,
        "Low Fuel Amount": 0,
        "Sound Enabled": true,
        "Use Custom Gradient": false,
        "Mid Threshold (0.0 - 1.0)": 0.6,
        "Low Threshold (0.0 - 1.0)": 0.2
      }
    }
  }
}