Dashboard LEDs - user-grinch/ModelExtras GitHub Wiki

Available from v2.1+

🧭 Overview

Dashboard LEDs are miniature indicators embedded in the vehicle’s dashboard mesh. Each LED reflects a specific vehicle state β€” from engine health to lighting β€” and toggles automatically based on gameplay conditions. No dummy is required; the plugin reads the material color and adjusts brightness accordingly.

Each LED material has two states:

Off – the LED remains unlit, blending with the dashboard.

On – the LED glows brightly, signaling an active or alert state.

πŸ’‘Tip: These LEDs are purely visual and ideal for immersive dashboards, HUD-style cockpits, or custom interiors. Use small quads or dots with emissive textures for extra glow.

✨ Variants

πŸ”§ Engine Status

  • 🟒 Engine On: Lights up when the engine is running normally. Material Color: 255 200 100 (engine_on)
  • πŸ”΄ Engine Broken: Activates when the engine is critically damaged. Material Color: 255 200 101 (engine_broken)

🌫️ Lighting Indicators

  • 🌁 Fog Light: Illuminates when fog lights are active. Material Color: 255 200 102 (fog_light)
  • πŸ”† High Beam: Activates when high beam headlights are turned on. Material Color: 255 200 103 (high_beam)
  • πŸ”… Low Beam: Activates when low beam headlights are turned on. Material Color: 255 200 104 (low_beam)

πŸ”„ Turn Signals

  • ⬅️ Indicator Left: Flashes when the left turn signal is active. Material Color: 255 200 105 (indicator_left)
  • ➑️ Indicator Right: Flashes when the right turn signal is active. Material Color: 255 200 106 (indicator_right)

🚨 Emergency & Utility

  • πŸš“ Siren Lights: Flashes when sirens are active (e.g. police, ambulance). Material Color: 255 200 107 (siren)
  • πŸ“¦ Boot Open: Lights up when the trunk is open. Material Color: 255 200 108 (boot_open)
  • πŸ”§ Bonnet Open: Lights up when the hood is open. Material Color: 255 200 109 (bonnet_open)
  • πŸšͺ Door Open: Activates when any door is open. Material Color: 255 200 110 (door_open)
  • 🌀️ Roof Open: Activates when the roof is expanded. Material Color: 255 200 111 (roof_open)

βš™οΈ JSONC Configuration (Custom LED Colors)

You can customize the active (color) and inactive (color_off) material tint for each LED indicator in your vehicle's .jsonc file:

{
  "leds": {
    "engine_on": {
      "material": {
        "color": { "red": 0, "green": 255, "blue": 0 },        // Glowing LED color when active
        "color_off": { "red": 25, "green": 25, "blue": 25 }    // Darkened LED color when off
      }
    },
    "high_beam": {
      "material": {
        "color": { "red": 0, "green": 120, "blue": 255 },
        "color_off": { "red": 20, "green": 20, "blue": 30 }
      }
    }
  }
}