Changelog
- Version 0.5.0 – early test release, built and tested on BeamNG.drive 0.40.5.0.

Description
Grit gives every car in BeamNG.drive a history. Scrape along a guardrail and the paint shows it. Drive off-road and mud piles up behind the wheels. Fast gravel runs leave a layer of dust on the car. Everything builds up gradually, and the dirt takes its color from the ground you drive on.

Grit is not a preset or a skin. It works on every vehicle, including modded ones, and leaves your paint and liveries untouched.

Features
- Scratches: Body scrapes against walls, guardrails, rocks and other hard surfaces leave scratches exactly where the contact happened. Three depths available: light clear-coat scuff, primer, and bare metal. - Cracks: When a painted plastic part such as a bumper gets dented or breaks, hairline or spiderweb cracks appear right at that spot. - Dirt: Includes Wheel spray (dirt, mud, sand, gravel, grass or snow thrown onto the body), Contact dirt (dirt stays where the car rolls into a ditch or slides along an embankment), and Color by surface (mud is dark brown, sand is light, snow is white). - Dust, Washing & Drying: At speed on dusty ground a fine layer settles on the rear, lower sides and the top. Driving into water cleans the vehicle below the waterline. Fresh mud starts dark and wet, drying lighter over about a minute and a half. - In-game app: Allows users to switch dirt, scratches and cracks on or off, adjust dirt strength (0.25–2) and drying speed (0.25–4), and use Wash or Clear all functions. Settings are saved in settings/grit.json.

Compatibility & performance
- Vanilla and modded cars. Tested on ETK I-Series, Gavril D-Series, Ibishu Covet and the modded Gavril Vertex NA2.
- Uses its own texture layer and skin slot, so paint, liveries and paint designs stay as they are.
- Every car has its own dirt and scratches, even several copies of the same model.
- Other scratch or dirt mods may conflict. Use only one at a time.
- Measured in game: no stutter while driving through mud, washing a step costs about 1 ms, idle well under 1 ms per frame.

Known limitations
- Light scratches and dust are hard to see on white or chrome parts. They show up clearly on dark paint.
- Some vehicles only have collision points low on the body, so guardrail scratches stay near the sills and bumper corners.
- Some models reuse the same spot of their decal texture for several parts. On the Ibishu Covet both bumpers share one stretched area, so a scratch there can show up on both as a large patch. grit_main.uvCheck() in the Lua console shows the layout of any car, grit_main.clear() turns it off.
- Only the player vehicle gets Grit for now.
- Dirt and scratches are not saved yet. They are gone after a reset, a repair or a restart.

Planned
Rain slowly washing the car, optional dirt and scratches on AI traffic.

Installation Instructions
- Put grit_v0.5.0.zip into %LOCALAPPDATA%\BeamNG\BeamNG.drive\current\mods\. Do not unpack it.
- Start the game and make sure Grit is enabled in the mod manager.
- Spawn a vehicle and drive. Grit activates on its own. The car respawns once at the start (under a second).
- Repairing or resetting the vehicle removes all dirt and damage.

Credits
Psydo. Grit uses only the game's own Lua APIs, changes no game files and contains no code or assets from other mods.