madhatterflava
← Back to catalog
195979c6ec7cc4be6040510daa9d4790155ab508.jpg
Packages

Terrain Speed — Tyre & Surface Limits

$8.99

FiveMKeymasterEscrow

Description

Tyre-based speed limits on asphalt, gravel & offroad. jg-mechanic ready, standalone fallback, burst tyres, soft decel. ox_lib only dependency. 0.00ms.

Terrain Speed — Realistic Tyre & Surface Limits

Stop players from racing slicks through the mountains. Terrain Speed applies configurable km/h caps based on tyre type and ground surface — without heavy offroad physics or FPS drops.

Why your server needs this

  • Slicks on highway? Full speed.

  • Slicks in dirt? Hard cap — RP makes sense, not just a server rule.

  • jg-mechanic tyre tuning (slicks / semi-slicks / offroad) works out of the box.

  • No jg? Standalone mode uses GTA wheel categories (LSC).

  • Burst tyres slow the car down — bare rim only, configurable.

  • Smooth deceleration when leaving asphalt (no violent 140→40 snap).

  • Does not break engine tuning — highway speed comes from handling, not a fake 180 km/h cap.

Features

Feature
Details
Surface detection
Road, gravel, offroad (per-wheel materials)
Tyre profiles
Slick, semi-slick, offroad, street — fully configurable
jg-mechanic
Reads tuningConfig.tyres via state bag
Standalone
GetVehicleWheelType fallback
QB / ESX
Export bridges + state bag API
Burst tyres
Priority over surface limits
Soft decel
Gradual speed cap reduction
Performance
~0.00ms idle, lightweight poll loop
Debug
Admin command + F8 output
Escrow
Encrypted core, open config.lua


Requirements

  • ox_lib

  • OneSync (state bags)

  • Optional: jg-mechanic (recommended)

Frameworks: Standalone, QBCore, Qbox, ESX — no framework dependency.

Integrations

  • jg-mechanic — enabled by default

  • Vanilla / LSC — wheel type mapping

  • Custom mechanic — state bag terrainTyreProfile or exports

  • RegisterTyreProvider — hook your own logic from any resource

Exports (for developers)

Server

  • SetVehicleTyreProfile(vehicle, profile)

  • ClearVehicleTyreProfile(vehicle)

  • GetVehicleTyreProfile(vehicle)

Client

  • GetTyreProfile(vehicle)

  • GetTyreProfileSource(vehicle)

  • GetSpeedLimit(vehicle)

  • RegisterTyreProvider(id, callback)

Full configuration in config.lua — limits, surfaces, integrations, provider order.

Support

Discord ticket — installation help and compatibility questions.

Not a replacement for full offroad physics (mud sinking, etc.). A focused, lightweight tyre & terrain speed limiter — perfect alongside jg-mechanic.