⚙️Configuration

config.lua Overview

The config.lua file contains all configuration options for the Billing System.

Framework Settings

Framework Selection

Config.Framework = 'auto'

Options:

• 'auto' - Automatically detect framework (recommended)

• 'qbox' - Force QBox framework

• 'qb' - Force QBCore framework

• 'esx' - Force ESX framework

• 'custom' - Use custom framework (requires bridge setup)

Auto-detection works in most cases. Only set manually if detection fails.

Job Configuration

Allowed Jobs

Define which jobs can create invoices:

Config.AllowedJobs = {
    'police',
    'ambulance',
    'mechanic',
    'taxi',
    'realestate',
}

Job names must match exactly with your framework's job names (case-insensitive).

Keybind Settings

Tablet Open Key

Config.Keybind = 'F7'

Common Options:

• 'F7' - F7 key (default)

• 'F6' - F6 key

• 'K' - K key

• Any valid FiveM key code

Distance Settings

Nearby Player Detection

Config.NearbyPlayerDistance = 10.0

Maximum distance (in meters) to detect nearby players for invoicing.

Invoice Settings

Amount Limits

Config.InvoiceSettings = {
    MinAmount = 1,
    MaxAmount = 999999,
}

• MinAmount - Minimum invoice amount

• MaxAmount - Maximum invoice amount

Tax Configuration

Config.InvoiceSettings = {
    TaxRate = 0,  -- 0 = no tax
}

Examples:

• 0 - No tax

• 0.18 - 18% tax

• 0.25 - 25% tax

Tax is automatically calculated and added to invoice total.

Payment Methods

Config.InvoiceSettings = {
    AllowBankPayment = true,
    AllowCashPayment = true,
}

Enable or disable payment methods:

• AllowBankPayment - Allow bank transfers

• AllowCashPayment - Allow cash payments

Feature Toggles

Config.InvoiceSettings = {
    AllowMultiRecipient = true,
    AllowPhotoAttachment = true,
    AllowRecurringPayments = true,
}

• AllowMultiRecipient - Allow invoices to multiple players

• AllowPhotoAttachment - Allow photo attachments

• AllowRecurringPayments - Allow installment payments

Notification Settings

Duration and Position

Config.Notifications = {
    Duration = 5000,  -- milliseconds
    Position = 'top-right',
}

Position Options:

• 'top-right'

• 'top-left'

• 'bottom-right'

• 'bottom-left'

Receipt Settings

Print Receipt Feature

Config.ReceiptSettings = {
    Enabled = true,
    RequireOxInventory = true,
    ItemName = 'receipt',
}

• Enabled - Enable receipt printing

• RequireOxInventory - Require ox_inventory

• ItemName - Item name to give player

Receipt printing requires ox_inventory to be installed.

Cashbox Settings

Per-Job Cashbox

Config.CashboxSettings = {
    Enabled = true,
    SharedBetweenJobs = false,
}

• Enabled - Enable cashbox feature

• SharedBetweenJobs - Share cashbox between all jobs

Camera Settings

Photo Attachment Camera

Config.CameraSettings = {
    FOV = 70.0,
    MaxPhotos = 3,
    PhotoQuality = 'high',
}

• FOV - Camera field of view

• MaxPhotos - Maximum photos per invoice

• PhotoQuality - 'low', 'medium', 'high'

Language Settings

Default Language

Config.Language = 'en'

Available Languages:

• 'en' - English

• 'tr' - Turkish

See Translations for adding more languages.

Example Configurations

Police Department

Config.AllowedJobs = {'police'}
Config.InvoiceSettings = {
    MinAmount = 50,
    MaxAmount = 50000,
    TaxRate = 0,
    AllowBankPayment = true,
    AllowCashPayment = false,  -- Police only accepts bank
    AllowMultiRecipient = false,
    AllowPhotoAttachment = true,
}

Mechanic Shop

Config.AllowedJobs = {'mechanic'}
Config.InvoiceSettings = {
    MinAmount = 100,
    MaxAmount = 100000,
    TaxRate = 0.18,  -- 18% tax
    AllowBankPayment = true,
    AllowCashPayment = true,
    AllowMultiRecipient = true,
    AllowPhotoAttachment = true,
}

Hospital

Config.AllowedJobs = {'ambulance', 'doctor'}
Config.InvoiceSettings = {
    MinAmount = 500,
    MaxAmount = 25000,
    TaxRate = 0,
    AllowBankPayment = true,
    AllowCashPayment = false,
    AllowMultiRecipient = false,
    AllowPhotoAttachment = false,
}

Advanced Configuration

Billing Menus

Billing menus are configured per-job in the admin panel or database.

See Admin Guide for details.

Validation

After configuring, restart the resource:

restart src-billing

Check console for any configuration errors.

Configuration complete! Test your settings in-game.