Dealership config and API reference

Buy 9AM Dealership on the store. Install steps are in the setup guide. This page is the config and API reference.

Open Source edition

The Open Source edition ships the full, unencrypted source for servers that don’t run escrowed scripts and want to modify and maintain the script themselves. It is on sale to everyone through the store — no invitation needed.

Price — €89.90.
How to buy — open the store page and pick Open Source next to the price.
Delivery & licensing — Cfx.re rules apply to the Open Source edition too, so the purchase is registered to your Cfx.re server key and shows up in your Keymaster like any other asset.
GitHub access — you get access to the script’s GitHub repository, including the main release branch. You can open issues and pull requests and contribute to the main version, within the contributor rules.
Direct support — 24/7 access to the script’s contributor and product owner, MustafaAta, for questions, modifications, and integration help.

Contributor rules

Repository and contribution access are granted under the studio’s contributor rules. In short: the source is yours to modify for your own server, but it stays private to buyers — redistribution, resale, and public mirrors are not permitted. Issues and pull requests are welcome; merges into the main version are at the studio’s discretion. The full rules are shared with your purchase.

Overview

9AM Vehicle Shop is the studio’s most complete vehicle-sales system for roleplay servers that want more than a basic buy menu. Players walk into a dealership, browse a live 3D catalog, test drive, pay by cash, bank, or financing, and drive away in a car registered to their name. Staff run the whole business from a per-shop management tablet — sales, wallet, stock, coupons, orders, employees, and settings — all gated by granular per-employee permissions. Admins place and configure new dealerships live, in-game, with no config editing. Everything is written against QBox shapes, with QBCore and ESX supported through an auto-detecting framework bridge. Vehicle-key, garage, and phone integrations are also auto-detected at startup — install only what you use.

Current version: 1.4.0. Frameworks: QBox · QBCore · ESX. Author: 9AM Studios — MustafaAta.

Public features

3D showroom catalog — walk into the dealership and browse vehicles in a live preview with a seated driver ped (a clone of the player), rotate and inspect each model, switch paint colors, and read specs pulled straight from the game.
Purchasing — pay by cash or bank; the vehicle is registered to the player and either spawned at the shop or delivered to a garage. Coupon / discount codes are supported.
Custom currencies — accept VIP coins, tokens, crypto, or an inventory item, enabled per dealership, with automatic reward delivery from your webstore.
Financing — configurable down payment, interest, and installment count, with automatic real-time bank deductions plus manual and early payoff.
In-person sales — employees with the sales permission send a purchase offer to a nearby player and earn commission on the sale.
Management dashboard — a per-shop tablet UI: sales history, case (shop wallet) balance & ledger, stock, coupons, orders, employees, and settings — every panel gated by per-employee permissions.
Stock & delivery logistics — order stock, then run a truck-and-trailer delivery mission to bring it in, sized by vehicle category and trailer type.
Physical showroom displays — place real display vehicles in the showroom, with optional in-world info stands rendered as DUI textures.
In-game shop creator — admins place and configure new dealerships live with /dealerships; each inherits its catalog from a source shop.
Phone app — employees open the dashboard from lb-phone or cylex_phone (auto-detected); permissions still apply.
Multi-framework bridge — QBox, QBCore, and ESX auto-detected; vehicle-key, garage, and phone integrations auto-detected at startup.
Localization — all in-game and UI text is keyed, with 30 languages shipped and per-key fallback for partial translations.

Dependencies

Required

ox_lib
oxmysql
A supported framework: qbx_core (QBox), qb-core (QBCore), or es_extended (ESX)
On QBox: qbx_vehicles — used to register purchased vehicles

Optional (auto-detected — install only what you use)

Interaction & prompts

ox_target — required only when Config.InteractionMode = 'target'.
9am-textui — enhances prompts when present; falls back to ox_lib showTextUI automatically.

Vehicle keys

qbx_vehiclekeys, qb-vehiclekeys, qs-vehiclekeys, ak47_qb_vehiclekeys, 0r-vehiclekeys, Renewed-Vehiclekeys, MrNewbVehicleKeys, mk_vehiclekeys.

Garages

jg-advancedgarages, cd_garage, okokGarage, esx_garage, plus the framework defaults qbx_garages / qb-garages. Set Config.DefaultGarage to a garage name your garage script recognizes.

Phone

lb-phone, cylex_phone — the running one is detected automatically; nothing to configure.

The showroom info stands use custom prop models (vehicle_info_stand1–4). If they aren’t in your build, disable the Info Stands option for the affected shop(s) in the /dealerships editor, or install the companion props resource.

Compatibility and editions

Type	Details
Compatibility	QBox · QBCore · ESX
Editions	Escrow (encrypted) and Open Source
Open source price	`EUR 89.90`
Database	19 tables auto-created on first start — no SQL import

Both editions ship the config, vehicle catalog, currency definitions, and framework bridges unencrypted so you can edit them; see the store for current escrow pricing. For what the Open Source edition includes, see Open Source edition.

Editable files

File	Purpose
`config.lua`	Global options — interaction mode, tax, commission, finance, plates
`vehicles.lua`	The vehicle catalog
`currencies.lua`	Custom currency definitions
`bridge/client.lua`, `bridge/server.lua`	Framework, vehicle key, and garage integration
`locales/*.json`	All user-facing text, 30 languages

Keep your copies of these files when you update — everything else is replaced by the new build. Note that several of them moved in 1.3.0; see Version history.

Installation

Drop the resource in

Place 9am-vehicleshop into your resources folder (a [9am] sub-folder is fine).

Ensure it after your framework

ensure ox_lib
ensure oxmysql
ensure qbx_core        # or qb-core / es_extended
ensure 9am-vehicleshop

Database

No SQL import is required — all 19 tables are created automatically on first start. The MySQL user oxmysql uses must have CREATE and ALTER privileges.

Create the jobs your shops use

Add the dealership jobs your shops reference to your framework. QBox/QBCore ship cardealer; add any others (e.g. airdealer) yourself. The boss grade grants full dashboard access.

Create shops in-game

There are no default shop locations to edit. Run /dealerships (admin) to place and configure dealerships. Use config.lua for global options only.

Configuration

All global settings live in config.lua. Shops themselves are not configured here — they are database-driven and managed in-game (see Shops & the creator).

Setting	Type	Default	Description
`Config.Locale`	`string`	`'en'`	UI/game language; must match a `locales/<code>.json` file.
`Config.InteractionMode`	`string`	`'textui'`	How players open shops: `'textui'`, `'target'` (needs ox_target), or `'marker'`.
`Config.DefaultGarage`	`string`	framework-based	Garage purchased cars are stored in. Auto-set per framework; override as needed.
`Config.SpawnOnPurchase`	`boolean`	`true`	`true` spawns the car at the shop and warps the buyer in; `false` saves to garage only.
`Config.ShowPreviewDriverPed`	`boolean`	`true`	Show a clone of the player seated in the catalog preview vehicle.
`Config.GlobalVAT`	`number`	`0.1`	Tax rate on all purchases (`0.1` = 10%).
`Config.SalesCommission`	`number`	`0.10`	Commission paid to sales staff on in-person sales.
`Config.VehicleImageUrl`	`string`	fivem CDN	Catalog image URL template (`%s` = model). Per-vehicle override via `image` in `vehicles.lua`.
`Config.PlateFormat`	`string`	`'AAAA0000'`	Plate pattern: `A` = random letter, `0` = random digit, other characters literal (max 8).
`Config.ReportErrors`	`boolean`	`false`	Send runtime errors to 9am.dev for diagnostics.
`Config.Debug`	`boolean`	`false`	Gate debug commands (`/openshop`, `/opendash`, …).

NPC suppression

Inside dealership zones, ambient pedestrians and traffic can be suppressed so the showroom stays clean. Player vehicles, dealer peds, and showroom vehicles are unaffected.

Config.NpcSuppression = {
  enabled  = true,  -- master toggle
  radius   = 60.0,  -- meters around each shop's dealer ped
  peds     = true,  -- block ambient pedestrians & scenario peds
  vehicles = true,  -- block ambient traffic & parked vehicle generators
}

Finance

Config.Finance = {
  minDownPaymentPercent = 0.25,   -- 25% minimum down payment
  maxDownPaymentPercent = 0.90,   -- highest down payment allowed
  interestRate          = 0.10,   -- 10% interest on the financed amount
  totalPayments         = 12,     -- default number of installments
  minPayments           = 2,      -- fewest installments allowed
  maxPayments           = 24,     -- most installments allowed
  paymentIntervalHours  = 12,     -- real-time hours between auto-deductions
  autoDeductFrom        = 'bank', -- account type auto-deductions pull from
}

Test drive

Config.TestDrive = {
  duration         = 60,    -- seconds the player can drive
  useRoutingBucket = false, -- true = isolated bucket; false = normal world
  endKey           = 73,    -- control index to end early (73 = X)
  cooldownSeconds  = 60,    -- per-player cooldown between test drives
}

Phone app

Config.PhoneApp = {
  enabled    = true,
  identifier = '9am-dealership',
  icon       = nil, -- nil = bundled icon; set any https:// URL to customize
}

lb-phone and cylex_phone are both supported and detected automatically. Employees open the dashboard from the app; permissions apply as usual.

Orders & delivery

Config.Orders controls stock ordering and the delivery mission. Highlights:

preparationTime — minutes until an ordered stock delivery is ready (lower it for testing; default 30).
delivery.enabled — when false, ready orders add to stock directly via a Receive button instead of running a mission.
delivery.truckModel, carTrailer, containerTrailer — the truck and two trailer types (car trailer holds S/M/L, container holds everything including XL).
vehicleSizes / slotCosts — map each vehicle category to a size (S/M/L/XL) and a trailer-slot cost.
containerOnlyModels — models too large for the car trailer, forced to container-only.
delivery.shops[shopId] — per-shop truck spawn and delivery destination.

Config.CatalogColors (colorIndex → GTA paint index) must stay in sync with web/src/constants/catalogColors.ts. Only change both together.

Shops and the in-game creator

Config.Shops is intentionally empty. Shops live in the database (9am_vehicleshop_dynamic_shops) and are created, edited, and deleted in-game — never by editing config.

Run /dealerships (alias /dealershipcreator) as an admin to open the creator.
Place the shop on the map (a live blip preview uses GTA minimap tiles), set the dealer ped, showroom slots, blip, and the Vehicle Source (which catalog the shop sells).
The Garage Override dropdown lists garages detected from your garage script; unsupported scripts fall back to garages already in use on stored vehicles, and a Custom option always lets you type any name.
On first boot, the former static shops (pdm, air, boats) are seeded once into the database, then loaded server-side into Config.Shops and published to clients via GlobalState. So Config.Shops[shopId] works at runtime on both sides, but its contents come from the DB.

The vehicle catalog

vehicles.lua is the catalog (~150 KB). Each entry defines the spawn code, brand, price, category, and which shop(s) sell it — a vehicle may belong to multiple shops via its shop tag.

Images load from Config.VehicleImageUrl (default https://docs.fivem.net/vehicles/<model>.webp). Add-on / custom vehicles FiveM doesn’t host should set a per-vehicle image = 'https://...', or they show a broken image.
Blocked models — oversized models in Config.BlockedModels are never spawnable for safety.
The truck catalog — 32 heavy/commercial vehicles ship tagged shop = 'truck' that no default dealership sells. To sell them, create a dealership and pick truck as its Vehicle Source.

Management dashboard & permissions

Staff open the dashboard with /dealertablet, from the phone app, or (with Config.Debug) the debug command. The UI is one React app with dashboard, catalog, sale-offer, finance, and shop-creator pages. Access is gated by granular per-employee permissions that appear in both the server (gating) and the UI. Boss grades and shop owners bypass all checks.

Permission	Grants
`sales`	Open the tablet; view sales records.
`case`	Shop wallet balance and ledger.
`stock`	Stock levels and ordering.
`coupons`	Create and manage discount codes.
`orders`	Stock orders and delivery.
`employees`	Hire, fire, and set permissions.
`settings`	Shop settings.

Sales, financing & coupons

In-person sales — a staffer with sales sends an offer to a nearby player; on acceptance the buyer pays and the staffer earns Config.SalesCommission. Price, coupon, stock, and job checks are all re-derived server-side.
Financing — the buyer chooses a down payment and installment count within the Config.Finance bounds; the balance auto-deducts from their bank on a real-time interval, with manual and early payoff available.
Coupons — percentage or fixed discount codes, created and managed from the dashboard.

All money, price, permission, and stock validation happens server-side — client input is never trusted.

Stock, orders & delivery

Staff order stock from the dashboard; after preparationTime the order is ready.
With delivery enabled, a truck-and-trailer mission spawns at the shop’s truckSpawn; the driver hauls the trailer to the deliveryPoint.
Each ordered vehicle occupies trailer slots sized by category (S/M/L/XL); the car trailer holds S/M/L, the container holds everything.
On delivery the stock is added and becomes purchasable.

With delivery disabled, ready orders are added to stock directly via a Receive button — no mission.

Showroom displays & info stands

Each shop can show physical display vehicles in its showroom slots, edited in-game with the showroom editor. Optional info stands render a standalone page (web/showroom_stand.html) as a DUI texture on in-world stand props, showing the model’s name, price, and specs. Disable info stands per shop if you don’t have the prop models.

Framework & integration bridges

Two bridge files auto-detect your stack and ship unencrypted so you can edit them:

bridge/server.lua — player lookup, money, vehicle registration, and keys/garage integration. Auto-detects the framework and errors if none is found. Plates are trimmed before being handed to key/garage scripts (GTA pads plates to 8 chars).
bridge/client.lua — synthesizes QBX.PlayerData in QBox shape for all three frameworks.

Vehicle keys, garages, and phones are matched to whatever you have installed. To audit exactly what’s detected vs. active, run dealership_audit in the server console — it lists every supported integration per feature with installed vs. active state.

Custom currencies

Dealerships can take payment in something other than cash and bank — VIP coins, car tokens, crypto, an inventory item. Currencies are defined in currencies.lua and enabled per dealership, so one showroom can be VIP-only while the rest stay on cash. The file ships fully commented out. Leave it alone and nothing changes.

The registration API is drop-in compatible with JG Dealerships. An existing Currencies.Server.Register block pastes in unchanged, including calls to Framework.Server.GetPlayerIdentifier(src) inside its callbacks.

currencies.lua

Currencies.Server.Register({
    id = 'vip_coins',
    label = 'VIP Coins',
    format = '%s coins',      -- how it displays: "1,250 coins"
    conversionRate = 10000,   -- 1 coin = $10,000, so a $50,000 car costs 5 coins
    allowFinance = false,
    backend = { type = 'db' },
})

Field	Required	Description
`id`	Yes	Unique key — lowercase letters, digits, underscores
`label`	Yes	What players see
`format`	Yes	Display template with exactly one `%s`
`conversionRate`	Yes*	How many dollars one unit is worth
`flatCost`	No	Every vehicle costs this many units, whatever its price. Overrides `conversionRate`
`allowFinance`	No	Reserved — see the limitation below
`decimals`	No	`0`, `1`, or `2`. Defaults to `0`
`icon`	No	`coins`, `wallet`, `card`, or `gem`

* Not required when using flatCost. Prices convert after tax and coupons and always round up, so a vehicle can never come out free at a high conversion rate. Coupons do not apply to flat-cost purchases.

Where the balance lives

Write fetchBalance / addBalance / removeBalance yourself, or add a backend block and let the script generate them:

`backend.type`	Balance source	Offline players
`db`	A table owned by the script — nothing else to install	Yes
`account`	A named framework account, i.e. `xPlayer.getAccount('viptoken')` on ESX	Yes
`export`	Another resource’s exports	Only if it exposes identifier-based exports
`metadata`	Framework player metadata	QB and QBox yes; ESX needs 1.10+
`item`	The player’s count of an inventory item	No — rewards queue until they log in

Pick db if you have no existing currency resource, or account if your tokens already live in an ESX account. Both support offline players, which is what makes webstore rewards land immediately instead of queuing.

ESX account (viptoken)

Currencies.Server.Register({
    id = 'viptoken',
    label = 'VIP Token',
    format = '%s VIP',
    conversionRate = 25000,
    backend = { type = 'account', account = 'viptoken' },
})

Flat-cost token

One token buys any vehicle, whatever it costs.

Currencies.Server.Register({
    id = 'car_token',
    label = 'Car Token',
    format = '%s Token(s)',
    flatCost = 1,
    backend = { type = 'db' },
})

Another resource owns the balance

Currencies.Server.Register({
    id = 'premium_points',
    label = 'Premium Points',
    format = '%s pts',
    conversionRate = 1000,
    backend = {
        type = 'export',
        resource = 'premium-shop',
        fetch = 'GetPoints',
        add = 'AddPoints',
        remove = 'RemovePoints',
    },
})

Hand-written callbacks (JG form)

Currencies.Server.Register({
    id = 'vip_coins',
    label = 'VIP Coins',
    format = '%s coins',
    conversionRate = 10000,
    allowFinance = false,

    fetchBalance = function(src)
        return exports['vip-system']:GetCoins(src) or 0
    end,

    addBalance = function(src, amount)
        exports['vip-system']:AddCoins(src, amount)
        return true
    end,

    removeBalance = function(src, amount)
        exports['vip-system']:RemoveCoins(src, amount)
        return true
    end,
})

Enabling a currency

Open /dealerships as an admin, edit a dealership, and use the Payment Methods section. The same section controls whether that dealership accepts cash, bank, and finance at all. Payments taken in a custom currency are held in that dealership’s case in the same currency, alongside its dollar balance, and staff withdraw them from the Case tab. Stock orders and case deposits stay dollar-only.

Financing in a custom currency is not supported. allowFinance and the offline callbacks are accepted and stored so JG definitions load cleanly, but financed purchases always charge the bank account.

Webstore rewards

Sell VIP coins on Tebex and let the script deliver them. Run this from the server console, or as a Tebex command package:

dealership_grant <identifier> <currencyId> <amount> [txId] [note...]
dealership_grant license:110000112345678 vip_coins 5 tebex-8842119 Gold Package

identifier accepts license:..., cid:<citizenid>, a bare citizenid, or #<serverId> for an online player. Substitute your own store’s placeholder tokens — the exact tokens differ per store plugin.

Always pass a transaction id. It is the primary key of the grant table, so re-running the same line grants nothing and prints REPLAY. That makes a webstore retry safe.

Offline players are credited directly when the currency supports it, and queued for their next login when it cannot — an inventory item can’t be handed to someone who isn’t connected. Every movement is recorded for auditing. Sibling commands: dealership_balance <identifier> <currencyId> and dealership_grants <identifier|txId|flush>.

Exports

Server-side. Use these to wire the script into a society account, a payslip system, a Discord bot, or your own store handler.

Player balances

Work for any registered currency.

local balance = exports['9am-vehicleshop']:getCurrencyBalance(source, 'viptoken')
local ok, err = exports['9am-vehicleshop']:addCurrencyBalance(source, 'viptoken', 100)
local ok, err = exports['9am-vehicleshop']:removeCurrencyBalance(source, 'viptoken', 100)

-- Reward delivery. Replay-safe, works for offline players.
local ok, err = exports['9am-vehicleshop']:grantCurrency(identifier, 'viptoken', 100, txId, note)

exports['9am-vehicleshop']:getCurrencies()
exports['9am-vehicleshop']:getPendingGrantCount()

Dealership balances

Each dealership keeps its own case rather than an esx_addonaccount society, because a dealership is not always a job — a player-owned shop belongs to one character with no society to point at, and two shops can share a job. These exports expose the balance so you can mirror it into a society account or read it elsewhere.

local balance = exports['9am-vehicleshop']:getCompanyBalance('pdm')              -- dollars
local coins   = exports['9am-vehicleshop']:getCompanyBalance('pdm', 'viptoken')  -- one currency
local all     = exports['9am-vehicleshop']:getCompanyBalances('pdm')             -- every balance

local ok, err = exports['9am-vehicleshop']:depositCompanyMoney('pdm', 1000)
local ok, err = exports['9am-vehicleshop']:withdrawCompanyMoney('pdm', 1000)

exports['9am-vehicleshop']:getCompanies()  -- every dealership id

The currency id is optional everywhere — omit it for dollars. Withdrawals fail rather than overdrawing, and both directions write to the dealership’s ledger, so the movement appears in the in-game Case tab. Mutating exports return boolean, string?. The error string is one of unknown_shop, unknown_currency, invalid_amount, insufficient_funds, duplicate, missing_tx_id, or delivery_failed. You can also register a currency from another resource instead of currencies.lua:

exports['9am-vehicleshop']:RegisterCurrency({ id = 'viptoken', label = 'VIP Token', conversionRate = 25000 })

Commands

Command	Access	Description
`/dealertablet`	Dealership staff	Open the management dashboard remotely.
`/dealerships` (alias `/dealershipcreator`)	Admin	Place and configure a dealership in-game.
`debug_dealership_info`	Server console only	Dump framework, dependency states, server info, and DB status for support.
`dealership_audit`	Server console only	List every supported integration per feature (installed vs. active).
`dealership_seed`	Server console only	Seed mock data into the default shops for testing/demos.
`dealership_grant`	Server console only	Grant a custom currency to a player by identifier. Replay-safe.
`dealership_balance`	Server console only	Read a player’s currency balance, online or offline.
`dealership_grants`	Server console only	Inspect grants, or `flush` to retry queued deliveries.

Debug commands (/openshop, /opendash, /finance, /trailerspawn, …) are gated behind Config.Debug and off by default.

Database

These 19 tables are auto-created on startup — do not import them manually:

9am_vehicleshop_sales            9am_vehicleshop_visits
9am_vehicleshop_case             9am_vehicleshop_case_balance
9am_vehicleshop_stock            9am_vehicleshop_coupons
9am_vehicleshop_mugshots         9am_vehicleshop_permissions
9am_vehicleshop_settings         9am_vehicleshop_orders
9am_vehicleshop_showroom         9am_vehicleshop_finance
9am_vehicleshop_finance_payments 9am_vehicleshop_dynamic_shops
9am_vehicleshop_jobs             9am_vehicleshop_migrations
9am_vehicleshop_currency_balances
9am_vehicleshop_currency_log     9am_vehicleshop_currency_grants

The resource also reads/writes your framework’s own vehicle tables (player_vehicles on QB/QBox, owned_vehicles / users on ESX) when registering a purchased vehicle. Schema upgrades run as guarded ALTER TABLE migrations in the MySQL.ready block — never add a SQL import file.

Localization

All user-facing text is keyed, English is the fallback, and 30 languages ship: en, ar, cs, da, de, es, fi, fr, he, hi, hu, id, it, ja, ko, lt, ms, nl, pl, pt, pt-br, sl, sv, th, tl, tr, uk, vi, zh-cn, zh-tw. locales/en.json is the source of truth. Each file has two namespaces — game.* (Lua) and ui.* (React). To add a language, copy en.json, translate the values (keys identical; partial files fall back per-key), and set Config.Locale. No web rebuild is needed.

Version history

Custom currencies

Custom currencies. Dealerships can be paid in VIP coins, tokens, crypto, or an inventory item, enabled per dealership. The registration API is drop-in compatible with JG Dealerships, and five backends (db, account, export, metadata, item) cover the common setups with no callbacks to write.Webstore rewards. dealership_grant delivers currency by player identifier from Tebex or RCON — replay-safe on the store’s transaction id, so a retried delivery grants nothing. Offline buyers are credited directly where the currency allows it, and queued for their next login where it physically cannot be handed over, such as an inventory item.Per-currency case. Each dealership holds its currency balances alongside its dollar balance, with a switcher and per-currency withdrawal in the Case tab. Deposits and stock orders stay dollar-only.Per-dealership payment methods. A new Payment Methods section in /dealerships controls cash, bank, finance, and each currency.Exports. New company-balance and currency-balance exports for integrating with society accounts and external systems. Withdrawals fail with insufficient_funds rather than overdrawing, and both directions write a ledger row.Audit log. Every currency movement is recorded in 9am_vehicleshop_currency_log, including webstore grants and case withdrawals.Financing in a custom currency is not supported in this release. allowFinance and the offline callbacks are accepted, validated, and stored so JG definitions load cleanly, but financed purchases always use the bank account.Fixes. Three pre-existing bugs were found and fixed while building this release:

A credit to a dealership that had no balance row yet was silently discarded. The shop case is now written as an upsert.
Renaming a shop while its catalog was open reset the test-drive toggle, and would also have cleared that shop’s payment methods.
The sale-offer page failed to render in browser development because its state was never seeded.

Schema changes are additive and apply automatically on first start; the per-currency case arrives as the one-time case_currency_v1 migration. Do not downgrade to 1.3.x after a dealership has taken a custom-currency payment — the older version’s case queries cannot tell currencies apart.

With an untouched currencies.lua, every existing dealership keeps accepting cash, bank, and finance and behaves exactly as it did in 1.3.x.

Shop creator polish

Redesigned the dealership list in /dealerships with a clearer hierarchy and filters, and tidied the editor header.

File layout — action required

Customer-editable files moved. Copy your customizations to the new paths before starting 1.3.0 — the old filenames are no longer loaded, so edits left behind are silently ignored.

Old path	New path
`shared/config.lua`	`config.lua`
`client/framework.lua`	`bridge/client.lua`
`server/bridge.lua`	`bridge/server.lua`

Also relocated, though usually not customized: shared/locale.lua → modules/locale.lua, server/helpers.lua → modules/helpers.lua, server/data.lua → modules/data.lua, client/utils.lua → modules/utils.lua, client/state.lua → modules/state.lua.Server-only files are no longer included in the client download, so permission checks and SQL builders stay on the host.

Build tooling

Internal build tooling only — no gameplay or configuration changes.

Phone fix

Fixed the phone dashboard bottom sheet sitting in the wrong position after the build toolchain upgrade.

Interface refresh

Moved the interface onto the shared 9AM UI Kit so components stay consistent across scripts.

30-language pack

Completed the localization pack — 30 languages now ship, with English fallback for any missing key. Set Config.Locale and restart; no rebuild required.

Packaging

Customer builds are now produced with the production pipeline, which strips development seed data, mock data, and console noise from the shipped interface.

Best for

Choose this script if your server wants:

A believable vehicle-sales loop instead of a flat buy menu
Staff-driven dealership gameplay with real permissions
A business players can own and operate
Financing, coupons, stock, and delivery logistics
Live, in-game dealership creation with no config edits
A donation currency that buys cars, delivered automatically from your store

Buy link

Open Dealership in the store

​Open Source edition

​Contributor rules

​Overview

​Public features

​Dependencies

​Required

​Optional (auto-detected — install only what you use)

​Compatibility and editions

​Editable files

​Installation

​Configuration

​NPC suppression

​Finance

​Test drive

​Phone app

​Orders & delivery

​Shops and the in-game creator

​The vehicle catalog

​Management dashboard & permissions

​Sales, financing & coupons

​Stock, orders & delivery

​Showroom displays & info stands

​Framework & integration bridges

​Custom currencies

​Where the balance lives

​Enabling a currency

​Webstore rewards

​Exports

​Player balances

​Dealership balances

​Commands

​Database

​Localization

​Version history

​Best for

​Buy link

Open Source edition

Contributor rules

Overview

Public features

Dependencies

Required

Optional (auto-detected — install only what you use)

Compatibility and editions

Editable files

Installation

Configuration

NPC suppression

Finance

Test drive

Phone app

Orders & delivery

Shops and the in-game creator

The vehicle catalog

Management dashboard & permissions

Sales, financing & coupons

Stock, orders & delivery

Showroom displays & info stands

Framework & integration bridges

Custom currencies

Where the balance lives

Enabling a currency

Webstore rewards

Exports

Player balances

Dealership balances

Commands

Database

Localization

Version history

Best for

Buy link