Changelog
Released version and their changes.
#Changes
- Unlocked parts of the repair flow code to allow customization.
- New wheel repair mode configuration, allowing various realism requirements, view config for explanations.
- Hardened the syncing of wheels during the repair flow.
#Files Affected
- client/*
- server/unlocked/interactions.lua
- server/unlocked/main.lua
- shared/unlocked/config.lua
- README.md
- types.lua
- fxmanifest.lua
2026-06-02 03:36 CET
#Changes
- Introduced a more robust simulated wheel failure and pickup: detached wheels now become interactive props that players can collect as inventory items, with configurable animation and prop lifetime.
- Configurable wheel visual models and pickup distance.
- Target integration via zyke_lib exports for custom interactions.
- Added two usable repair items: a tirekit (wheel-only repairs), both configurable for consume behavior, duration and distance.
- Tirekit restores tyres, wheel health, failed wheels and wheel integrity.
- Repairkit repairs deformation, engine, body, petrol tank and extinguishes fires.
- Overhauled terrain sinking with smoother handling debuffs and new visual effects including per‑wheel tire size reduction and optional ground cues.
- Improved network sync across players via statebag replication.
- Configurable sink rate, max depth, visual update intervals and suspension refresh options.
- Admin and debug commands are now restricted by a configurable permission string (commandPermission) to prevent unauthorized use.
#Files Affected
- client/*
- server/unlocked/main.lua
- shared/unlocked/config.lua
- shared/unlocked/presets.lua
- README.md
- extras/items/ox_inventory.lua
- extras/items/qb-core.lua
- fxmanifest.lua
#Changes
- Vehicles now respond to different terrain materials (grass, dirt, sand, mud) with realistic handling changes, including suspension sink and traction adjustments.
- Terrain sink visually lowers the vehicle on soft surfaces.
- Acceleration, top speed and traction are affected based on surface material.
- Introduced wheel integrity notifications and a wheel inspection tool.
- Players receive warnings when wheel health drops below thresholds.
- The 'wheel_scanner' item opens a wheel integrity overview menu.
- Fixed vehicles becoming incorrectly undriveable at low fuel levels.
- The resource now prevents the native engine stalling bug and properly disables the engine when fuel runs out.
- Added an export for repair scripts to properly clear wheel and deformation damage after full repairs.
- RepairVehicleDamage export resets synced damage data to prevent detached wheels from reappearing.
- Integration instructions for popular mechanic scripts like JG Mechanic are included in the documentation.
#Files Affected
- client/*
- server/unlocked/main.lua
- shared/config.lua
- shared/unlocked/config.lua
- shared/unlocked/presets.lua
- AGENTS.md
- README.md
- fxmanifest.lua
#Changes
- Added a wheel loss system: wheels can detach on hard landings and impacts, with integrity checked per wheel.
- Fixed vehicle damage multiplier stacking that could cause excessive damage after reloading or exiting vehicles. Damage multipliers (including weapon damage) are now properly saved and restored, resetting correctly on vehicle entry.
- Improved deformation handling to prevent deformity from progressively accumulating after repairs and made deformation calculations more reliable by caching target data.
- Realistic presets now restrict airborne tilting, preventing vehicles from flipping unrealistically in the air.
- Added a wheel scanner item for checking wheel integrity, with inventory definitions and images for ox_inventory and qb-core.
- Added full locale support for 16 languages (ar, cs, de, en, es, fr, it, ja, nl, pl, pt, ro, sv, th, tr, zh).
- The resource now requires the zyke_lib dependency. Ensure it is installed for the resource to function.
- Added server exports GetVehicleDamageData and SetVehicleDamageData, enabling frameworks to persist vehicle damage data. Integration instructions for ESX, QBCore and Qbox are provided in the README.
#Files Affected
- client/*
- server/main.lua
- shared/config.lua
- shared/presets.lua
- README.md
- extras/items/images/wheel_scanner.png
- extras/items/ox_inventory.lua
- extras/items/qb-core.lua
- fxmanifest.lua
#Changes
- Slower intervals for checking if your vehicle is flipped.
- Refactored the process to ensure the vehicle isn't being reset when you enter it & it's almost destroyed.
- Added a debug hud for the vehicle health.
- Limit debug prints.
- Adjusted some defaults for the presets to make vehicles last longer on average.
- Replaced the frame-loop native to set the vehicle torque to simulate the vehicle dying with editing the entities' handling data for better performance.
#Files Affected
- Replace all
Initial release