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.pedDefaults#Default ped model and scenario used when the addon spawns a bank teller.
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.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.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.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 |
Set enabled = false to skip confirmation and execute transactions immediately.
BankingConfig.matching#Per-intent similarity thresholds. Lower values allow less exact matches.
BankingConfig.zoneGeometry#| Field | Type | Default | Description |
|---|---|---|---|
height | number | 3.0 | Height of the box zone in meters |
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.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.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.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).
Last updated 3 months ago