Configuration

Almost everything is tuned from shared/config.lua and a handful of convars. All money- and access-related logic is validated server-side regardless of config.

Convars (server.cfg)

Convar	Default	Purpose
`set orb-phone:framework`	`auto`	`auto` / `qbx` / `esx` / `qb` — force the framework if you run more than one core.
`set orb-phone:locale`	`en`	Default language: `en` / `es` / `fr` / `pt`. Players can override it in Settings.
`set orb-phone:camera_webhook`	—	Upload webhook for the Camera app.
`set orb-phone:debug`	`false`	Verbose console logs.

shared/config.lua

Key	What it controls
`Config.PhoneItem`	The inventory item name (default `phone`).
`Config.PhoneNumberFormat`	The `XXX-XXX` number format.
`Config.PhoneBinding`	`character` (default) or `account` — share the number/data across a player's characters.
`Config.Services`	Maps each service (police/EMS/mechanic) to a framework job + request/respond gates.
`Config.YellowPages`	Seed "official" businesses for the Hub directory.
`Config.Garages`	Coords per garage name for the Garage app's "Set GPS". Adjust to your map.
`Config.Music`	Orb FM catalog (config-driven audio sources).
`Config.Wallet`	Crypto market: `tickSeconds`, the trading `account`, and `coins` (`basePrice` + `volatility`).
`Config.Camera`	Photo upload `webhook` + JPG `quality` (0–1).
`Config.Webhooks`	Discord auditing for the event bus (see below).

Discord webhooks (Config.Webhooks)

The server event bus can mirror events to Discord. Off by default and a complete no-op while URLs are empty.

lua

Config.Webhooks = {
    enabled = false,                       -- master switch
    urls = {                               -- one webhook per logical channel
        audit = '', bank = '', calls = '', chat = '',
    },
    logEvents = {                          -- event -> channel
        ['bank:transfer']      = 'bank',
        ['call:started']       = 'calls',
        ['call:ended']         = 'calls',
        ['message:received']   = 'chat',
        ['service:dispatched'] = 'audit',
    },
    highValueThreshold = 50000,            -- transfers >= this also go to 'audit'
}

See Events & Exports for the full event catalog.