Configuration

General Configuration (config.lua)

Framework Detection

Config.Framework = 'auto'

• Automatically detects:
  • ox_core → uses ox
  • es_extended → uses ESX
  • else → QBCore
• You can force:
  • ox, qb, esx

Debug Mode

Config.Debug = true

• Enables client warnings (useful for dev).
• Disable in production.

UI Theme

Config.UiTheme = 'green'

• Available themes:
  • yellow, orange, purple, blue, cyan, green, red, blackandwhite

Config.CustomThemePresets = {}

• Override or create custom UI themes.

Dev Mode

Config.DevModeAllowSelfCharge = true

• Allows billing yourself (for testing UI).

Auto Debit System

Config.AutoDebitSeconds = 5

• Time before invoice auto-deducts if unpaid.

Config.MaxBillDistance = 10.0

• Maximum distance between biller and target.

Interaction Settings

Config.Interaction = 'ox_target'

Supported:

• ox_lib
• ox_target
• qb_target

Config.PointDistance = 2.6

• Default interaction radius.

Billing Desk Interaction

Config.BillingLocationInteractDistance = 2.5

Config.BillingMarker = false

• Show marker on billing desks (only for ox_lib).

Target UI Settings

Config.BillingTarget = {
    icon = 'fas fa-file-invoice-dollar'
}

Config.InvoiceClerkTarget = {
    icon = 'fas fa-receipt'
}

Pay Later System

Config.PayLater = {
    Enabled = true,
    MinDays = 1,
    MaxDays = 90,
    DefaultDays = 7,
    OverdueCheckSeconds = 60
}

Features:

• Players can delay payments
• Auto-check for overdue invoices
• Supports partial payments

Invoice Clerk (NPC)

Config.InvoiceClerk = {
    PedModel = `cs_bankman`,
    Location = vector4(...),
}

• Used to:
  • View invoices
  • Pay invoices

Banking Integration Mode

Config.UsingFinalsBankingInvoice = true

• true:
  • Uses Finals Banking UI
  • No clerk NPC needed
• false:
  • Uses standalone clerk system

Exports available:

• GetPendingInvoices
• PayInvoice
• ConfirmInvoicePayment

Banking System Integration

Config.Banking = 'finals_banking'

Supported:

• finals_banking
• qb-banking
• qb-management
• renewed-banking
• esx_banking

Billing Types (Config.Billing)

Each entry defines a billing system.

Structure

{
    Lable = 'Invoice Name',
    logo = 'image_url',
    AllowedJobs = { 'job' },
    command = 'command_name',
    item = false,
    Locations = { vector3(...) },
    logWebhook = 'discord_webhook',
    societyfunds = true,
    societypersentage = '60%',
    societyAccount = 'job_name',
    Force = true,
    AllowPayLater = true,
    MaxPayLaterDays = 30
}

Key Options Explained

Label & Logo

Lable = 'Police Fine'
logo = 'url'

• UI display name + image.

Job Restriction

AllowedJobs = { 'police' }

• Only specific jobs can use this billing.

Trigger Methods

command = 'polcharge'
item = false
Locations = { vector3(...) }

You can use:

• Command → /polcharge
• Item → usable item
• Location → world interaction

Distance / Interaction

LocationInteractDistance = 2.5
LocationLabel = '[E] Open Billing'

Discord Logs

logWebhook = 'your_webhook'

• Sends billing logs to Discord.

Society Money

societyfunds = true
societypersentage = '60%'
societyAccount = 'police'

• % of invoice goes to job account.

Force Payment

Force = true

If enabled:

1. Try bank
2. Then cash
3. Then allow negative balance

Pay Later Options

AllowPayLater = true
MaxPayLaterDays = 30

• Overrides global PayLater config.

Example Billing Types

Police Billing

• Command: /polcharge
• Society gets 60%
• Force payment enabled

EMS Billing

• Command: /emscharge
• No society share

Mechanic Invoice

• Open billing system for all players

Custom Job Billing (Redline / AutoTech)

• Job-based invoices
• High society share (90%)

Key Features Summary

• Multi-method billing (command, item, location)
• Pay-later invoice system
• Auto debit system
• Society fund integration
• Discord logging
• Full integration with Finals Banking

Notes

• Always secure your webhook URLs
• Tune auto-debit timing for RP balance
• Keep Force = false for realistic servers
• Use UsingFinalsBankingInvoice = true for best UI experience