The banking addon provides voice-controlled bank teller interactions — check balance, withdraw, deposit, and view transaction history — at bank NPC locations.
Config file: shared/banking/default.lua
BankingConfig.enabled#| Type | Default |
|---|---|
boolean | true |
Enable or disable the banking addon entirely.
BankingConfig.debug#| Type | Default |
|---|---|
boolean | Config.AddonDebug |
Enable debug logging for the banking addon. Follows the global AddonDebug setting by default.
BankingConfig.spawnPeds#| Type | Default |
|---|---|
string[] | {"qb-banking", "default"} |
Integrations for which the addon spawns its own bank teller peds. Resources listed here do not provide their own NPCs. renewed-banking spawns its own peds and is excluded.
BankingConfig.spawnPeds = { 'qb-banking', 'default' }
BankingConfig.pedDefaults#Default ped model and scenario used when the addon spawns a bank teller.
BankingConfig.pedDefaults = { model = 'cs_bankman', scenario = 'WORLD_HUMAN_CLIPBOARD', }
BankingConfig.proximity#| Field | Type | Default | Description |
|---|---|---|---|
width | number | 3.5 | Box zone width around bank teller (meters) |
length | number | 4.0 | Box zone length around bank teller (meters) |
updateInterval | number | 500 | How often to check proximity (ms) |
BankingConfig.proximity = { width = 3.5, length = 4.0, updateInterval = 500, }
BankingConfig.npcDetection#| Field | Type | Default | Description |
|---|---|---|---|
searchRadius | number | 8.0 | Primary NPC search radius (meters) |
fallbackSearchRadius | number | 10.0 | Fallback radius if primary finds nothing |
waitForSpawn | number | 500 | Max ms to retry NPC detection after zone entry |
greetingDelay | number | 0 | Delay (ms) before NPC delivers automatic greeting |
BankingConfig.npcDetection = { searchRadius = 8.0, fallbackSearchRadius = 10.0, waitForSpawn = 500, greetingDelay = 0, }
BankingConfig.voice#| Field | Type | Default | Description |
|---|---|---|---|
minSimilarity | number | 0.65 | Minimum match score for voice commands (0.0–1.0) |
maxAmount | number | 500000 | Maximum transaction amount per voice command |
BankingConfig.voice = { minSimilarity = 0.65, maxAmount = 500000, }
BankingConfig.confirmation#Voice confirmation step before executing withdraw or deposit.
| Field | Type | Default | Description |
|---|---|---|---|
enabled | boolean | true | Require player to confirm before executing transaction |
timeout | number | 10000 | Ms before unconfirmed transaction is auto-cancelled |
BankingConfig.confirmation = { enabled = true, timeout = 10000, }
Set enabled = false to skip confirmation and execute transactions immediately.
BankingConfig.matching#Per-intent similarity thresholds. Lower values allow less exact matches.
BankingConfig.matching = { balance = 0.70, withdraw = 0.65, deposit = 0.65, transactions = 0.70, confirm = 0.60, cancel = 0.60, }
BankingConfig.zoneGeometry#| Field | Type | Default | Description |
|---|---|---|---|
height | number | 3.0 | Height of the box zone in meters |
BankingConfig.zoneGeometry = { height = 3.0 }
BankingConfig.transactions#| Field | Type | Default | Description |
|---|---|---|---|
maxPerPlayer | number | 20 | Maximum transaction history entries stored per player |
maxDisplayed | number | 3 | Maximum transactions the NPC reads aloud |
BankingConfig.transactions = { maxPerPlayer = 20, maxDisplayed = 3, }
BankingConfig.feedback#BankingConfig.feedback.enabled#| Type | Default |
|---|---|
boolean | true |
Master toggle for NPC TTS speech responses.
BankingConfig.feedback.responseToggles#Individual toggles for each response category.
BankingConfig.feedback.responseToggles = { greeting = true, -- greet player on entry farewell = true, -- farewell on exit balance = true, -- balance inquiry responses withdraw = true, -- withdrawal confirmation/result deposit = true, -- deposit confirmation/result transactions = true, -- transaction history responses confirmation = true, -- "please confirm" prompts errors = true, -- insufficient funds, limit exceeded, etc. }
BankingConfig.feedbackTiming#| Field | Default | Description |
|---|---|---|
responseCooldown | 1000 ms | Minimum time between NPC responses |
duplicatePrevention | 5000 ms | Suppress duplicate responses within this window |
farewellCooldown | 1000 ms | Reduced cooldown after farewell before a new greeting |
BankingConfig.feedbackTiming = { responseCooldown = 1000, duplicatePrevention = 5000, farewellCooldown = 1000, }
BankingConfig.numberWords#Word-to-number mapping used when parsing spoken amounts (e.g. "withdraw five hundred dollars"). Covers standard English number words plus shorthand (k = 1000, grand = 1000, half = 0.5).
BankingConfig.numberWords = { one = 1, two = 2, three = 3, -- ... hundred = 100, thousand = 1000, million = 1000000, grand = 1000, k = 1000, half = 0.5, }
Last updated about 9 hours ago