Features#
Hand Wash#
A full hands-on wash instead of a progress bar.
- Take the pressure hose off the machine and walk around the car with it
- Foam stage - cover the body until every panel is white
- Rinse stage - blast the foam off, section by section
- The hose is a real rope: walk too far and it snaps, then you go back and pick it up again
- Other players see your spray, your foam and your hose in real time
Drying & Polishing#
After the rinse the car is wet, and that is its own mini game.
- Drying - water drops are scattered over the bodywork, you wipe them off with a cloth using a free camera
- Polishing (premium wash only) - spray the panel, then buff the polish spots until the paint shines
- Left and right sides are handled as separate stages
- The vehicle visibly dries and shines as you work
Automatic Wash#
Drive-through bays for players in a hurry.
- Drive in, pick a package, sit back
- Animated rollers and sprayers with foam, water and drying passes
- Fully synced, so everyone nearby watches the same animation
Realistic Dirt#
Vehicles get dirty on their own while being driven.
- Dirt builds up based on the ground you drive on - mud, sand, grass, dirt tracks or tarmac
- Speed, rain and ground type all change how fast it happens
- Tarmac is slow, off-road is fast, and every value is configurable
- Waxed vehicles stay clean until the wax is washed off
- Other scripts can set or clear dirt through exports
Parking Guidance#
Players never have to guess where to stop.
- A parking box is painted on the ground of every hand wash bay
- It turns green the moment a vehicle is parked inside it
- It turns red while that bay is in use or reserved for an NPC customer
- A small marker next to the machine appears once a car is standing there
Touch Screen Menu#
Each wash machine carries a working screen in the world.
- Take the token, drop it into a slot and pick your package
- Cash or card payment, priced per business
- Rendered in world, no full screen menu covering the game
Businesses#
Car washes are player-owned companies.
- Buy an unowned car wash for a configurable price
- Set standard, premium and automatic prices within admin limits
- Hire and fire employees, or bind the business to a framework job
- Vault with deposits, withdrawals and a full transaction log
- Water and foam stock that has to be refilled
- Business menu opens at the office prop
Levels & Upgrades#
Every wash earns the business XP.
| Level | Water / Foam | Wash Speed | NPC Reward |
|---|---|---|---|
| 1 | 100 | 1.0x | 1.0x |
| 2 | 150 | 1.25x | 1.2x |
| 3 | 250 | 1.5x | 1.5x |
Upgrades are paid from the business vault, the owner's cash or their bank - your choice in the config.
NPC Customers#
Work for the business without waiting for real players.
- A customer drives in, parks at a bay and waits
- The employee washes the vehicle exactly like a player car
- Payment goes to the employee, XP goes to the business
- The customer drives away with a short cinematic
Mobile Wash Missions#
Take the wash to the customer.
- Drive the Speedo van out to a marked vehicle
- Wash it on location with the van's own equipment
- Return the van to get paid
Public Car Washes#
Ownerless car washes that always exist.
- Defined in the config, no database entry and no owner
- Nobody can buy, manage or delete them
- Prices are set per location in the config
- Perfect together with
frkn-carwashmap, which replaces the vanilla GTA car washes
In-Game Builder#
Build car washes without touching a single coordinate.
/carwashesopens the admin menu- Fly around and place the office, wash bays and the automatic wash
- Fine tune with a gizmo, move or delete zones later
- Give a single player build permission with
/givewash [id]
Multiplayer Sync#
Everything a player does is visible to everyone else nearby.
- Foam props, spray effects, the hose and the cleaning cloth are shared
- Players who arrive in the middle of a wash still see the current state
- Bays are locked while in use, so two players cannot wash the same car
Framework Support#
| Area | Supported |
|---|---|
| Frameworks | QBCore, QBX, ESX |
| Menus | Built-in UI, ox_lib, qb-menu, ESX menu |
| Text UI | ox_lib, qb, esx |
| Languages | English, Turkish, German, French, Italian, Spanish, Portuguese, Russian, Arabic |
| Vehicle keys | t1ger_keys, qs-vehiclekeys, Renewed-Vehiclekeys |
Languages#
Nine fully translated languages ship with the script, every single text included:
English · Turkish · German · French · Italian · Spanish · Portuguese · Russian · Arabic
- Set the server default in the config
- Players can switch language for themselves from the business menu
- Adding your own language is one file, no code changes
Performance#
- Markers, boxes and screens only render close to the player, at configurable distances
- The dirt system tracks only the vehicles it manages instead of scanning every vehicle in the world
- Wash effects are budgeted and cleaned up automatically when players walk away