Realistic Offroad Physics

This script brings realistic offroad driving dynamics to your FiveM server by restricting standard vehicles on difficult terrain. Vehicles visually sink into mud, sand, dirt, and soft surfaces, making off-roading impossible without appropriate vehicles and setups. Each surface material operates on distinct parameters for traction, softness, and depth.

Calculation Factors

Off-road vehicle performance is dynamically calculated using these factors:
- Wheel size
- Suspension height
- Vehicle weight
- Driven wheels (AWD or not)
- Vehicle class
- Wheel count
- Off-road tires
- Weather

Core Mechanics

• Traction: Defines surface grip. Low traction reduces acceleration, braking, and turning, leading to skidding on materials like gravel or rocks.
• Softness: Affects how quickly vehicles sink. Harder surfaces like gravel slow sinking, while soft surfaces like wet sand or mud cause rapid sinking.
• Depth: Determines how deep vehicles sink into a surface. Deeper sinking increases driving difficulty and can leave vehicles stuck in mud or wet sand.

Feature Overview

• Visual vehicle sinking on soft ground
• Loss of traction on slippery surfaces
• Realistic handling behavior for each vehicle class
• Low resource usage with optimized player synchronization
• Fully standalone with zero required dependencies
• Deeply configurable material settings
• Does not modify vehicle runtime handling.meta files, maintaining compatibility with custom vehicle resources
• Allows server owners to enforce off-road driving limits naturally without manual staff rules

Compatibility

Works out of the box on all FiveM server setups:
- ESX
- QBCore
- Qbox
- vRP
- Standalone

Installation

1. Place the resource folder in your server's resources directory.
2. Add an ensure line for it in server.cfg.
3. Restart the server, then drive a standard vehicle onto mud or sand to confirm the sinking behaviour applies.
4. Tune the traction, softness and depth values per surface material until the handling suits your map.

Requirements

Nothing else is needed. The resource is standalone and reads what it needs from the vehicle itself — wheel size, suspension height, weight, driven wheels, class and tyres — so an ESX, QBCore or Qbox server behaves identically.