Installation

Follow these steps to install JK Billing on your FiveM server.

Step 1: Download & Extract

Download the JK-Billing resource from your purchase.
Extract the folder into your server's resources directory (e.g. resources/[standalone]/JK-Billing).
Make sure the folder is named exactly JK-Billing.

Step 2: Database Setup

Import the SQL file located at sql/jk_billing.sql into your MySQL database. This creates the required tables:

-- Tables created:
-- jk_billing_invoices   → Stores all invoices (received, sent, society)
-- jk_billing_categories → Product catalog categories per job
-- jk_billing_products   → Product catalog items per job
-- jk_billing_tablets    → Placed in-world tablet locations

Note: The invoices table is also auto-created on resource start if it doesn't exist. However, it's recommended to import the full SQL file to ensure all tables (including products, categories, and tablets) are ready.

Step 3: Server Configuration

Add the resource to your server.cfg:

# Ensure your database resource starts first
ensure oxmysql

# Ensure your framework (if applicable)
ensure es_extended   # or qb-core / qbx_core

# Start JK Billing
ensure JK-Billing

Tip: JK Billing auto-detects your framework and banking system. In most cases, no manual configuration is needed beyond ensure JK-Billing.

Step 4: Configure (Optional)

Edit config.lua to customize language, keybinds, job permissions, and more. See the Configuration page for full details.

Step 5: Verify Installation

Start your server and check the console for:

[JK-Billing] started | framework=esx | banking=esx_society | db=oxmysql
[JK-Billing] Loaded 0 catalog tablets

In-game, press F5 (default) or type /invoices to open the billing UI.

Supported Database Drivers

oxmysql — recommended, auto-detected
mysql-async — auto-detected
ghmattimysql — auto-detected