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

  1. Wash Vehicle: The vehicle must be completely clean (Dirt Level 0) before wax can be applied. Use a Cleaning Kit or a car wash.

  2. Apply Wax: Use a wax item from your inventory while standing near the vehicle.

  3. Active Protection: Once applied, the script automatically reduces the dirt accumulation rate in the background.

  4. 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.

Last updated