Installation

Welcome to Koja-Carmarket, a player-driven car market with auctions, exchange zones, rentable parking slots and test drives. This guide walks you through the install end-to-end.

📋 Requirements

Before installing Koja-Carmarket, make sure the following resources are present and start before koja-carmarket:

• koja-lib — framework bridge (ESX / QBCore detection, money helpers, callback API)

• oxmysql — database driver

• ox_target (optional) — targeted interactions; falls back to draw-text + key if missing

Load order matters. koja-lib, oxmysql and ox_lib must be ensured in your server.cfg before koja-carmarket, or the resource will fail to start.

🚀 Installation

1

Drop the resource into resources

Place the unpacked koja-carmarket folder anywhere inside resources/ (e.g. resources/[koja]/koja-carmarket).

resources/
└── [koja]/
    ├── koja-lib/
    └── koja-carmarket/

2

Install dependencies

Follow the install instructions for each:

• koja-lib

• oxmysql

• ox_target (optional)

3

Database setup

Option A — Automatic (recommended)

Tables are created automatically on first start. Confirm this in shared/config.lua:

shared/config.lua

Config.Database = {
    AutoCreateTable = true,
}

Option B — Manual SQL import

Run database.sql against your database manually and set AutoCreateTable = false.

Both options produce the same schema. See Database for the full table reference.

4

Configure server.cfg (order matters)

server.cfg

ensure oxmysql
ensure ox_target      # optional
ensure koja-lib
ensure koja-carmarket

koja-lib must start before koja-carmarket. If load order is wrong, you'll see attempt to index a nil value (field 'Server') at startup.

5

First-run smoke test

1. Start the server.

2. Look for [koja-carmarket] Table … created. or … already exists lines in the console.

3. Go to one of the default market zones (e.g. Mark, coords -2187, -409, 13) — there should be an NPC with a Car Market interaction.

4. Open the tablet and verify the UI loads in your Config.Locale.