JaGGeR Controller

JaGGeR Vehicle Controller

The JaGGeR Vehicle Controller is the required backbone engine that powers all vehicle add-ons created for this ecosystem. It manages all physics calculations, manual and automatic transmissions, central security, custom HUD displays, turn signals, and refueling stations.

⚠️ IMPORTANT COMPATIBILITY NOTICE

This add-on does NOT contain vehicles by itself!
To get vehicles, you must install at least one compatible vehicle pack alongside this controller:

• Nuckem Vehicles Pack
• Mercedes-Benz Sprinter Minibus Add-On

🛠️Core Engine Features

1. Advanced Vehicle Physics
   1. Terrain Alignment (Pitch & Roll): Vehicles dynamically lean forward, backward, and sideways to smoothly conform to uneven hills, terrain slopes, and ramps.
   2. Slope Speed Reduction: Realistic incline drag causes heavy vehicles to lose speed when driving uphill, requiring gear shifting.
   3. Drifting & Boost Physics: Press and hold Jump while turning to initiate a drift with tire smoke and exhaust backfire. Release to trigger a brief boost.
2. Dual Transmission System (Manual & Automatic)
   1. Manual Sequential Gearbox: Shift through Gears 1 to 5, Neutral, and Reverse with realistic RPM drops during gear changes.
   2. Automatic Transmission (AKPP): Switch to full automatic mode (P - R - N - D) via settings. The vehicle automatically handles gear changes based on speed and throttle.
   3. Speed Limiter (Cruise Control): Set an exact maximum speed limit for automatic driving in the settings menu.
3. Physical Keys & Central Locking
   1. Vehicle-Bound Keys: When a vehicle is spawned, an individual key bound to that specific vehicle is generated. Only the matching key will start the engine!
   2. Universal Master Key: A special key variant that starts and opens any vehicle (ideal for admins and creative mode).
   3. Exterior Central Locking: Right-click the vehicle from the outside with its key to lock or unlock it. Locking triggers alarm sounds and automatically closes all open doors, trunks, and hoods. Locked cars cannot be entered by unauthorized players!
   4. Auto Key Cleanup: Dismantling a vehicle with a wrench automatically removes its corresponding keys from nearby player inventories.
4. Turn Signals & Hazard Lights
   Signal your turns and alert other drivers on the road:
   1. Touch Screen (Mobile): Dedicated on-screen interactive buttons for Left Turn, Hazard, and Right Turn.
   2. Hotbar Shortcuts (PC/Console): Quickly switch between hotbar slots 1, 2, and 3 while driving to toggle blinkers.
   3. Keybind Commands (PC): You can bind commands or run /scriptevent in chat/macros:
      • /scriptevent jagger:left — Toggle Left Turn Signal
      • /scriptevent jagger:right — Toggle Right Turn Signal
      • /scriptevent jagger:hazard — Toggle Hazard Lights

5. Fuel & Refueling Mechanics

1. 1. Fuel Pumps: Grab the fuel nozzle from the pump to refuel nearby vehicles directly to 100%. Moving too far snaps the hose and resets the nozzle.
   2. Fuel Canisters: Portable canisters that store up to 20L of fuel. Each canister features an item description tracking its remaining liters and individual ID. Canisters can also be placed on the ground as physical objects.
   3. Explosive Collisions: Ramming fuel pumps at high speed triggers massive, fiery explosions!

6. Sub-Entity Interactive Hierarchy

1. 1. Passenger Seats: Multi-seat support allowing friends to sit in passenger compartments and operate their own doors.
   2. Storage Trunks & Hoods: Interactive storage compartments.
   3. Auto-Close on Drive: Shifting into gear and moving automatically closes all open doors, hoods, and trunks for driving safety.

7. Custom Cameras, HUD & Graphics Settings

1. 1. Settings Menu: Use the Settings to open global server toggles (fuel consumption, vehicle damage, ramming damage to mobs, explosive pumps).
   2. Camera Modes: Standard, dynamic chase camera, reversing front view, and an advanced Collision-Free Free Camera that glides behind the vehicle without clipping into blocks.
   3. Customizable HUD: Switch speedometers between KM/H and MPH and choose between 6 screen layout presets.
   4. Performance (FX) Settings: Toggle drift trails, tire smoke, backfire sparks, sand spray, and crash sounds for weaker devices.

🛡️ Multiplayer & Server Permissions (Player Tags)

The controller includes a built-in role system designed specifically for Dedicated Servers, Realms, and Roleplay projects, allowing server owners to lock down driving settings and prevent cheating:

1. Regular Player (default_player):

• Command: /tag <player> add default_player
• Players with this tag have restricted access inside the Settings. Critical gameplay toggles (fuel depletion, fuel consumption rates, collision damage, mob ramming damage, slope slowdown, and explosive pump toggles) are hidden.
• All default players are forced to follow the global server rules set by administrators.
• Note: They can still freely customize their personal client preferences (automatic/manual transmission choice, HUD layout, camera presets, and FX performance toggles).

1. Administrator (admin_player):

• Command: /tag <player> add admin_player
• Administrators gain full access to all gameplay, fuel, damage, and server-wide toggles.
• Any setting adjusted by an administrator is automatically saved as a global server rule, instantly applying to everyone tagged with default_player.

🔨 Survival Crafting Recipes

All core tools and items can be crafted in Survival Mode:

Vehicle Base (Frame):
(Used in the Stonecutter to craft individual vehicles)

Vehicle Key:

Wrench (Setup, Color Cycling & Dismantling):

Repair Kit:

Fuel Canister:

Fuel Pump:

Settings:

⚠️ Required World Settings

To run the controller scripts, enable the following **Experiments** in your world settings:

1. Beta APIs
2. Upcoming Creator Features (recommended)