ZD5 docs
ZD5: install guide
ZD5 2.0.0 is a four-door performance estate for FiveM: the car, its own recorded V8 and every system in it, in one resource. It needs no framework, no other ZeroDev script and no database, and it only ever acts on the ZD5: other cars are never touched. This guide is the package's own install text: put it on your server, spawn it, the keys, the owner settings and what to do when something does not look right.
1. Who it runs for
Important
Keymaster licence. ZD5 is delivered to the Keymaster (Cfx.re) account you sign in with at checkout, and it only runs on servers whose licence key belongs to that account.
Buying it for someone else's server? The server owner should buy it on the Cfx.re account that owns the server's licence key. Moving an asset between accounts follows Cfx.re's Keymaster rules, so ask in the Discord before buying for someone else.
ZD5 is $10 once: no subscription and no trial. It also comes as a gift with ZeroDev Sound's one-time $45 purchase (not with the Sound monthly plan or the trial).
2. Install
Step 1: Download it from Keymaster
Open Keymaster, go to Granted Assets and download ZD5. Unzip the download.
Step 4: Start it
Restart the server, or without a restart type refresh and then ensure zd5 in the server console. Players who were already on the server when it started rejoin once to get the V8 engine sound. Then join and spawn it by its model name: zd5.
Nothing to edit: every option is set in game by an admin with /zd5admin (section 9). Do not add setr zd5_dev 1 to a real server; it turns on developer test commands.
Updating
Drop the new zd5 folder over the old one and restart the server: a new car model only loads on a fresh start. Your in-game settings are kept.
3. Spawn it
However it is spawned (a /car command, a garage, vMenu, txAdmin or a script), the car fits itself the moment it appears: its running gear, lights and factory finish. You never need to run anything.
| Server | How |
|---|---|
| ESX | /car zd5 (admin, or a group with the car command) |
| QBCore | /car zd5 (admin permission) |
| Qbox | /car zd5 (admin permission) |
| vMenu | Vehicle Spawner > Spawn Vehicle By Model Name > zd5 |
| txAdmin | The in-game menu > Main > Spawn Vehicle > zd5 |
| Standalone | Any spawner you use, model name zd5 |
4. Dealerships and garages (optional)
Spawning with /car needs nothing. Only if you want players to buy the car at a dealership or keep it in a garage, add it to your framework's vehicle list once. Change the price if you like, then restart the server.
QBCore: in qb-core/shared/vehicles.lua, inside the Vehicles list:
{ model = 'zd5', name = 'ZD5', brand = 'ZeroDev', price = 250000, category = 'sports', type = 'automobile', shop = 'pdm' },Qbox: in qbx_core/shared/vehicles.lua, inside the list:
zd5 = { name = 'ZD5', brand = 'ZeroDev', model = 'zd5', price = 250000, category = 'sports', type = 'automobile', hash = `zd5` },ESX: run this once in your database:
INSERT INTO `vehicles` (name, model, price, category) VALUES ('ZD5', 'zd5', 250000, 'sports');5. What it finds on its own
Nothing to configure:
| Part | What happens |
|---|---|
| Glovebox stash (K) | ox_inventory, qb-inventory (new and old), ps-inventory, qs-inventory, lj-inventory. With none of these the lid still opens and closes; it just has no stash. |
| Fuel | LegacyFuel, ox_fuel, cdn-fuel, ps-fuel, lc_fuel, qs-fuel, okok, rcore, Renewed, qb-fuel and others own the fuel level when present. With none, the ZD5 uses its own 68 L tank. |
| ox_target | The third-eye door options open the ZD5's doors with its own sounds. |
| Car HUDs | jg-hud, ps-hud, qb-hud and others: the ZD5's small outside speed readout hides itself. |
| ZeroDev Sound | Optional. If installed, the car's music plays through it (section 6). |
| Pulse Phone | Optional. Calls show on the car screens; a ZD5 app on the phone (in the car: lock, tailgate, doors, windows, air suspension, wipers, music; near it: lock and tailgate); the music on Pulse Drive; Pulse's Garage remote opens the power tailgate. |
| Other media players | A song a supported media player plays on the car shows on the ZD5 Media page, and its keys control it. |
6. Music
The car radio, built in. Without ZeroDev Sound the car's stereo is the game radio. The centre screen shows the station. Press I (ZD5 Command) > Media, the screen controller (Home) > Media, or the steering-wheel keys to switch it on or off and change the station. The driver picks the station. Chat command: /zd5media pause, resume, stop, next, previous. The radio's volume is the game's own: Esc > Settings > Audio.
With ZeroDev Sound (optional). Nothing to set up. The music you pick in Sound for this car plays through Sound's car audio (its car speakers, the bass, the sound with the doors open), and the Media page, the screen controller and the steering-wheel keys control it: play and pause, next, previous, stop and volume. While Sound plays for the car the game radio stays off, so two stereos never play at once. Renamed the zerodev-sound folder? It is usually found anyway; if not, set it in /zd5admin > ZeroDev Sound > Folder name. It needs an up-to-date ZeroDev Sound; with an older one the car keeps the radio.
The car plays song files and the radio only: it has no internet links.
7. Keys and commands
Every key can be changed in Esc > Settings > Key Bindings > FiveM.
| Key | Does |
|---|---|
| U | Lock or unlock |
| I | ZD5 Command: Car, Drive Setup, Climate, Vehicle, Media |
| B | Seat belt |
| K | Glovebox (front seats) |
| Left / Right | Indicators |
\ |
Hazard lights |
| Y | Cruise control on or off |
| = / - | Cruise or limiter speed |
| Left Shift | Paddle up (hold: back to D) |
| Left Ctrl | Paddle down |
| [ / ] | Your Drive 1 / Drive 2 setups |
| ; | Drive mode: Road / Sport / Track |
| ' | Engine sound: Sport / Quiet |
| Home | The screen controller (mouse wheel or arrows to turn, Enter to press, Backspace to go back) |
| Numpad 0 | Start or stop the engine |
| Numpad + / - | Volume up / down |
| Numpad * / / | Next / previous |
| Numpad 5 | Play / pause (radio on or off) |
| Page Down | All windows |
| E (outside) | Doors, bonnet and boot: the hand opens and closes them |
ZD5 Command > Body: central lock, mirrors (fold or out), fuel flap and the power tailgate (press again while it moves to reverse it). ZD5 Command > Car > Wipers: off, auto (in rain), on, single wipe. The mirrors fold when you lock the car and open when you unlock it. Units (mph or km/h, F or C): ZD5 Command > Car > Driver display, saved per player.
| Command | Does |
|---|---|
/zd5ac 21 |
Set the climate to 21 degrees |
/zd5win lf, rf, lr, rr, all |
A window, or all of them |
/zd5mirrors |
Fold or unfold the mirrors |
/zd5fuel |
The fuel flap |
/zd5roof |
The sunroof (no key by default: bind one in Key Bindings) |
/zd5tint clear, frost, front, rear |
The switchable roof glass; no argument cycles |
/zd5air low, normal, high |
Air suspension height |
/zd5wipers on, off, auto, once |
The wipers |
/zd5media pause, resume, stop, next, previous |
The music |
/zd5build |
Fit the running gear again and put the factory lights back (the colours stay) |
/zd5admin |
The owner settings (admins only, section 9) |
8. Colours
Every colour is a normal GTA paint slot, so any mechanic or customs script can change it and your garage saves it:
| Paint slot | On the ZD5 |
|---|---|
| Primary colour | The body |
| Secondary colour | The brake calipers (the ZD5 logo on them stays white) |
| Interior colour | The cabin leather (seats, door cards, steering wheel); pillars, roof and boot stay dark |
Most shops have no interior menu, so the driver can also pick the leather colour in the car: ZD5 Command or the screen controller > Settings > Interior colour (turn that off with Config.InteriorColour = false). The ambient light colour is in the car too: Settings > Ambient light colour.
9. Owner settings in game
/zd5admin opens the owner settings. Only admins can open it: it needs the ACE command.zd5admin, which the usual add_ace group.admin command allow already gives (or add add_ace group.admin command.zd5admin allow).
In it: the language, the engine bay, the live screens, the interior colour in the car, the factory window tint, the ZeroDev Sound link and the air suspension (default height, Low / Normal / High, raise and drop time, air out when parked, raise for kerbs). Press Save and every ZD5 on the server changes at once, for every player, with no restart. The settings are kept on the server through restarts and updates. "Back to zd5_config.lua" and Save uses the file's values again.
Performance switches, in /zd5admin or zd5/zd5_config.lua:
| Setting | What it does |
|---|---|
Config.EngineBay = 'open' |
The detailed V8 (turning belt drive, fans, the engine rocking on its mounts) only while the bonnet is open; the default. 'always' shows it in every ZD5 within 80 m; false always shows the light copy. |
Config.LiveScreens = true |
The live cluster, centre screen and climate panel. false = printed screens only; the radio and ZeroDev Sound still play. |
Config.SubScreens |
The boot displays and the boot lighting: enabled, near = 15.0 and far = 25.0 metres, rate = 30 updates a second while a song plays, bootLights = true with lightRange = 9.0. |
Every ZD5 near you shows the boot displays of the ZD5 you are closest to: GTA swaps a prop's texture for every copy of that prop at once, and live screens on other script vehicles work the same way.
Only two things ever need a restart: a new ZD5 version and a language file you add yourself. What each driver picks (ambient light colour, brightness and mode, the air suspension height) belongs to the car: every player near it sees the same.
10. If something is wrong
| You see | Fix |
|---|---|
| "You lack the required entitlement" | The server's licence key is not from the Cfx.re account that owns ZD5. Use a key from that account. |
| The car does not spawn | Check the F8 console for "zd5"; make sure the folder is named zd5 and server.cfg has ensure zd5, then restart the server fully. |
| An invisible or stock-looking car | The game is still streaming it: wait a few seconds, or type /zd5build (this also resets the paint to factory). |
| The engine sounds like a stock car | The resource was hot-restarted: restart the server and rejoin. |
| Two speed readouts on screen | Your server's HUD is not one it knows: ZD5 Command > Vehicle > Outside view > Off. |
| The glovebox says no stash | The server has no supported inventory (section 5); everything else works. |
No database tables and no SQL to run. Still stuck? Ask in #cars-help on the Discord, or open a ticket in #create-ticket with what you see and your framework.