Vehicle Wax & Protection
📄 Config file: shared/wax_config.lua
Vehicle waxes provide a protective layer that slows down dirt accumulation over time. The system supports multiple tiers of wax, each with its own protection factor and durability.
Wax Configuration
Each wax tier is defined in the Config.Waxes table:
Config.Waxes = {
['wax_basic'] = {
label = "Basic Wax",
duration = 8000,
protectionFactor = 0.5, -- Dirt accumulates 50% slower
maxDistance = 50000.0, -- Lasts for 50km
},
-- ...
}Protection Options
| Option | What it does |
|---|---|
label | Name shown on the progress bar. |
duration | Time in milliseconds to apply the wax. |
protectionFactor | A multiplier for dirt accumulation. 0.2 means dirt accumulates at only 20% of the normal rate. |
maxDistance | Total distance (in distance units) the wax remains active. |
Usage Summary
- Wash Vehicle: The vehicle must be completely clean (Dirt Level 0) before wax can be applied. Use a Cleaning Kit or a car wash.
- Apply Wax: Use a wax item from your inventory while standing near the vehicle.
- Active Protection: Once applied, the script automatically reduces the dirt accumulation rate in the background.
- Distance Tracked: The remaining wax durability is tracked via the vehicle's State Bag. You can see the remaining protection distance in the vehicle information menu.
Technical Details (State Bags)
The wax state is stored in the vehicle's state bags:
wax_type: The key of the wax currently applied (e.g.wax_premium).wax_durability: Remaining distance units.wax_factor: The active protection multiplier.