> For the complete documentation index, see [llms.txt](https://mz-studio.gitbook.io/muziscripts.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://mz-studio.gitbook.io/muziscripts.com/mz_billing/config.md).

# Config

```lua
Config = Config or {}

Config.Debug = false
Config.Locale = 'en' -- Corresponding language file in locales/ directory, e.g. zh-cn.lua, en.lua

Config.Framework = 'auto'

Config.Billing = {
    commandName = 'billing',
    createpersonal = 'createbill',
    createbusiness = 'createbizbill',
    defaultCurrencySymbol = '$',
    maxAmount = 1000000,
    allowSelfBilling = false,
    requireReason = false,
    -- Radius (in meters) to detect nearby players when creating a bill
    nearbyRadius = 5.0,
    -- Job names considered "unemployed" - these jobs will only show personal finances
    unemployedJobs = { 'unemployed', 'none' },
    -- Whether QB/QBox on-duty status is required to use business bills
    requireOnDuty = false,
    -- Primary account to deduct from when paying: bank or cash
    defaultPaymentAccount = 'bank',
    -- Employee commission/split system
    commissionEnabled = true,
    commissionAllowBossCustomRate = true,
    commissionDefaultRate = 20,
    commissionMaxRate = 50,
    -- Nearby player display mode (for the "TO" dropdown when creating a bill)
    -- 'name_id' : Name + Server ID, e.g. Nick Walker #12 (casual/light RP)
    -- 'id_only' : Anonymous + ID only, e.g. Citizen #12 (hardcore RP, anti-Meta-Gaming)
    nearbyPlayerDisplayMode = 'name_id',
    -- Anonymous label used in id_only mode
    nearbyPlayerAnonymousLabel = 'citizen',
    -- Whether employees can view ALL bills sent BY their business (default false: only view their own; boss always sees all)
    employeesViewAllBusinessSent = false,
    -- Whether employees can view bills RECEIVED by their business (default false: boss only; payments still boss-only)
    employeesViewBusinessReceived = true,
    -- Whether to auto-refresh the list after bill creation/payment (default false; requires reopening billing center to sync)
    autoRefreshList = true,
    -- Whether to enable date and employee filters (true = enabled, false = hidden)
    enableFilters = true,
    -- Start of the week: 'sunday' for Sunday start, 'monday' for Monday start
    startOfWeek = 'monday',
    -- Whether to play tablet holding animation when opening the billing center (true = enabled, false = disabled)
    useTabletAnimationBilling  = true,
    useTabletAnimationCreateBill = true,
    useTabletAnimationIncomingBill = false,
    -- Incoming bill popup position (bottom-right of screen, in pixels)
    incomingBillPopup = {
        right = 32,
        bottom = 80
    }
}

Config.Theme = {
    -- Primary color (teal/cyan theme), used for navigation highlights, buttons, borders, etc.
    primaryColor = '#2dd4bf',
    -- primaryColor = '#14b8a6',
    -- primaryColor = '#06b6d4',
    -- Personal bill color (contrasts with primary), used for personal bill related buttons
    personalColor = '#38bdf8'
}
-- Value Added Tax (VAT)
Config.VAT = {
    Enabled = true,
    Rate = 10,
    -- Jobs exempt from VAT on business bills (job names, matching framework job names, e.g. police, ambulance)
    ExemptJobs = { 'police', 'ambulance' },
    -- Whether personal bills are subject to VAT (business bills always incur VAT when Enabled=true, except ExemptJobs)
    PersonalEnabled = false,
    -- VAT destination: 'society' = transfer to RecipientSociety business account below; 'issuer' = goes to the issuing business
    RecipientMode = 'society',
    RecipientSociety = 'cityhall', --government
    RecipientSocietyType = 'job'
}

```