Admin Guide
The 19 /dealership subcommands, the in-game admin dashboard, player commands, and per-framework permission setup.
Everything an administrator does to set up and run dealerships: the /dealership commands, the in-game admin dashboard, the player commands, and how to grant yourself permission.
Everything here works on live dealerships stored in the database. The config files set the rules; the commands and dashboard create and edit the actual shops on your map. After install you have four NPC shops seeded automatically — the rest is up to you.
Permissions
Admin access is decided by your framework, through o-link. If you are not recognized as an admin, every /dealership command replies "You do not have permission." and does nothing else.
A player is an admin if they have the command ACE permission — which QBCore grants to its admin/god permission groups automatically. To grant it directly, add to your server.cfg:
add_ace group.admin command allowThen make sure the player is in the admin group through QBCore's permission system (or your server.cfg add_principal lines).
Identical to QBCore: a player is an admin if they have the command ACE permission, granted through qbx_core's admin groups. The same line applies:
add_ace group.admin command allowA player is an admin if their ESX account is in an admin group (typically admin or superadmin). Set the player's group in your ESX users table or however your setup manages groups — there is nothing dealership-specific to add. Once ESX considers them an admin, /dealership works.
There is no separate dealership permission to set — if the commands refuse you, your framework doesn't yet consider you an admin.
Commands Overview
There is a single command, /dealership, with 19 subcommands. All of them require admin permission.
| Command | Description |
|---|---|
/dealership admin | Opens the visual admin dashboard (recommended for most tasks). |
/dealership create <shopId> <name> | Create an NPC dealership at your feet. |
/dealership createplayer <shopId> <playerId> <name> | Create a dealership owned by a specific player. |
/dealership createforsale <shopId> <price> <name> | Create an unowned plot players can buy. |
/dealership list | List every dealership. |
/dealership delete <shopId> | Delete a dealership permanently. |
/dealership setowner <shopId> <playerId> | Assign or change a dealership's owner. |
/dealership setprice <shopId> <price> | Set or clear a plot's for-sale price. |
/dealership setjobs <shopId> <job1,job2,...> | Restrict a shop's greeter to certain jobs. |
/dealership balance <shopId> <amount> | Set a shop's reserve balance to an exact amount. |
/dealership financeadvance <plate> [count] | Fast-forward a finance contract's next payment (testing). |
/dealership forcerepo <plate> | Immediately repossess a financed vehicle. |
/dealership testdrive <shopId> [on|off|setspawn] [limit] | Configure test drives at a shop. |
/dealership setgreeter <shopId> [model] [scenario] | Move the greeter NPC to your location. |
/dealership addslot <shopId> <model> | Add a showroom display slot at your location. |
/dealership removeslot <shopId> <slotIndex> | Remove a showroom display slot. |
/dealership listslots <shopId> | List a shop's showroom slots. |
/dealership rotateslot <shopId> <slotIndex> <on|off> [speed] | Turn the turntable spin on a display slot on or off. |
/dealership ownerrotation <shopId> <on|off> | Let a shop's owner control display rotation from the tablet. |
Stand where you want things to go
Many of these commands use your current position — create places the new shop where you are standing, setgreeter moves the NPC to your exact spot, addslot drops the display car at your feet. Stand exactly where you want the thing to go, and always run these in-game (not from the server console, which has no position).
In the details below, <shopId> is a short id you choose for the shop (e.g. pdm) — stick to lowercase letters, numbers, dashes, and underscores, the format the dashboard's create form enforces. <playerId> is a player's current server ID (the number in your player list), not their character name.
Creating and Managing Shops
/dealership create
Creates a new NPC-operated dealership at your current position.
/dealership create downtown Downtown MotorsSuccess replies Created dealership downtown.; a taken id replies Dealership 'downtown' already exists.. After creating it, open the dashboard to draw its lot zone, place the greeter, and set spawn points.
/dealership createplayer
Creates a dealership owned by a specific player (their server ID — they must be online) at your current position.
/dealership createplayer eastside 12 Eastside AutoIf the player isn't online: Player ID 12 is not online or has no character.
/dealership createforsale
Creates an unowned plot that players can buy to become the owner. It automatically gives the plot a starter greeter and map blip at your position. The price must be greater than 0.
/dealership createforsale westport 500000 Westport Motors/dealership list
Lists every dealership with its id, name, type, owner, and reserve balance in your chat box.
Dealerships (5):
[pdm] Premium Deluxe Motorsport | npc=yes owner=- bal=$0
[eastside] Eastside Auto | npc=no owner=<id> bal=$12000
.../dealership delete
Permanently deletes a dealership and everything attached to it — showroom slots, employees, inventory, and sales history. Active finance contracts are forgiven (the cars stay with their buyers). This cannot be undone.
/dealership delete downtown/dealership setowner
Assigns or changes a dealership's owner by server ID (must be online). This converts an NPC shop into a player-owned one automatically; existing employees and inventory stay attached. The new owner is told immediately and gains tablet access without relogging.
/dealership setowner eastside 8/dealership setprice
Sets a plot's for-sale price, or clears it. Pass 0 to take the plot off the market.
/dealership setprice westport 750000/dealership setjobs
Restricts a shop's self-serve greeter to one or more jobs, separated by commas or spaces. Pass nothing to clear the restriction. The restriction affects the greeter (browsing, buying, trading in) and hides the shop's map blip from players who don't qualify; the sales desk and management tablet are unaffected.
/dealership setjobs trucker_yard trucker,mechanic/dealership balance
Sets a shop's reserve balance to an exact amount — it replaces the current balance, it does not add to it. Useful for seeding a player-owned shop with starting funds or correcting a balance.
/dealership balance eastside 50000Finance Testing
/dealership financeadvance
A testing tool. Fast-forwards a finance contract's next-payment time by one or more payment intervals (default 1), so you can see a payment come due — or be missed — without waiting an hour each time.
/dealership financeadvance ABC123 3/dealership forcerepo
Immediately repossesses a financed vehicle — the same outcome as defaulting on a loan. The car is taken back and re-listed as used. If there's no active contract for the plate: No active/defaulted contract found for plate ABC123.
/dealership forcerepo ABC123World Placement
/dealership testdrive
Configures test drives at a shop. The behavior depends on the action:
- No action, or
setspawn— enables test drives and sets the spawn point to where you are standing. on— enables test drives without moving the spawn point.off— disables test drives (the greeter hides the Test Drive button).
The optional final argument sets the time limit in minutes.
/dealership testdrive downtown setspawn 2/dealership setgreeter
Moves the greeter NPC for a shop to your current location and heading. Optionally pass a ped model and idle scenario to change its appearance.
/dealership setgreeter downtown a_m_y_business_03 WORLD_HUMAN_CLIPBOARDShowroom Slots
/dealership addslot
Adds a showroom display slot at your current location, showing the model you name. Stand exactly where you want the display car to sit.
/dealership addslot downtown adderReplies Added showroom slot #<n> to downtown displaying adder at your coords. — note the slot number for later.
/dealership removeslot
Removes a showroom display slot by its number (use listslots first to find it).
/dealership removeslot downtown 2/dealership listslots
Lists a shop's showroom slots with their numbers, displayed models, and coordinates.
downtown — 3 showroom slots:
[#1] adder @ -45.7, -1093.7, 25.4
[#2] schafter2 @ -48.3, -1101.9, 25.4
.../dealership rotateslot
Turns the turntable spin on a single display slot on or off, with an optional custom spin speed in degrees per second.
/dealership rotateslot downtown 1 on 10/dealership ownerrotation
Lets a player-owned shop's owner (or manager) toggle display rotation themselves from the management tablet. Turn this on so owners manage their own showroom spin; leave it off to keep rotation admin-controlled.
/dealership ownerrotation eastside onAdmin Dashboard (NUI)
Run /dealership admin to open the visual dashboard — the recommended way to build and tune dealerships, because it lets you place things by clicking in the world instead of typing coordinates. It opens with a roster of every dealership on the left; pick one (or hit New Dealership) and work through its panels.
| Panel | What you can do |
|---|---|
| Overview | A snapshot of the selected shop with quick actions (edit greeter, manage slots, view sales, transfer owner), plus an editable Display Name field for renaming. |
| Greeter | Move the greeter, and choose its ped model and idle scenario from drop-downs. |
| Showroom | Add, move, swap, and remove display slots; toggle each slot's rotation; allow owner-managed rotation. (To change a slot's spin speed, use /dealership rotateslot <shopId> <slotIndex> on <speed>.) |
| Test Drive | Enable or disable test drives, set the spawn point, set a time limit, and choose what happens when time runs out (teleport back or delete the vehicle). |
| Spawns | Set where purchased vehicles appear and where test drives return the player. |
| Map Blip | Move the map icon and set its sprite, color, and scale. |
| Lot Zone | Draw the polygon outlining the lot (used for on-site and on-duty checks) with a free-camera editor — click to drop points, save with Space. |
| Finances | View and set the reserve balance, set the default employee commission rate, advance a finance schedule, or force a repossession. Also holds the Accepted Payments card (choose which methods this shop accepts) and the Access Control card (restrict the greeter to specific jobs). If the shop is already listed for sale you can edit or clear its price here; to put an unlisted shop up for sale, use /dealership setprice. |
| Inventory | For player-owned shops: add and remove listings, set retail prices, and buy stock on the New tab; manage trade-in and repossessed vehicles (re-price or delist) on the Used tab. NPC shops sell from the catalog and have no inventory. |
| Sales | View the most recent transactions (newest 50). |
| Employees | A read-only view of the shop's staff and their commission rates. (Owners hire and fire from their own tablet.) |
| Coupons | Create global or shop-scoped promo codes, and deactivate existing ones. |
| Danger Zone | Transfer ownership to another player, or permanently delete the dealership (type the shop id to confirm). |
When you create a new shop from the dashboard you choose its type — NPC, Player (assigned by server ID), or For Sale (with a listing price) — and it's anchored at your current location.
Player Commands
These are the commands ordinary players use — no admin permission required.
| Command | Description |
|---|---|
/myloans | Opens the financing panel showing the player's active vehicle loans, where they can make a payment or pay one off early. |
/managedealership | Opens the management tablet, but only while the player is standing in a lot they own or work at. The command name is set by Config.Tablet.command. |
See Financing and Ownership and the Management Tablet for what these screens contain.
Typical Admin Workflows
Create a buyable plot
- Stand where you want the lot's center.
/dealership createforsale westport 500000 Westport Motors— this also drops a starter greeter and blip./dealership admin, selectwestport, and draw the Lot Zone, fine-tune the Greeter, and add Spawns.- Adjust the price any time with
/dealership setprice westport <amount>.
A player can now walk up and buy it, becoming the owner.
Hand a shop to a player
- Have the player online and note their server ID.
/dealership setowner <shopId> <playerId>.
The shop becomes player-owned, keeping any existing inventory and staff. The player is notified instantly.
Test the financing lifecycle quickly
- Have a player finance a vehicle and note its plate.
/dealership financeadvance <plate>to bring a payment due now — repeat to simulate misses.- After three misses the loan defaults and the car is repossessed. To jump straight to repossession, use
/dealership forcerepo <plate>.
Set up a showroom display with a spinning car
- Stand where you want the display car.
/dealership addslot <shopId> <model>and note the slot number it reports./dealership rotateslot <shopId> <slotNumber> onto make it spin.
Enable the Luxury dealership
The Luxury shop ships disabled because it expects a custom map (MLO) at Rockford Hills. To turn it on, see the Installation Guide.