Troubleshooting

It picked the wrong framework or inventory

Auto-detection guessed wrong. Set them by hand in config/core.lua and restart:

config/core.lua

Config.Framework   = 'auto'         -- 'esx' | 'qbcore' | 'qbx' | 'auto'
Config.Inventory   = 'ox_inventory' -- 'ox_inventory' | 'qb-inventory' | 'ps-inventory' | 'none'
Config.Interaction = 'ox_target'    -- 'ox_target' | 'drawtext'

Use Config.Inventory = 'none' if you don’t use physical cards, and Config.Interaction = 'drawtext' for a simple [E] prompt.

Bank cards don't work, or the item is missing

Physical cards need the bank_card item in your inventory. Not using physical cards? Set Config.Cards.inventory.enabled = false in config/cards.lua and skip this.Otherwise add the item and its image:

ox_inventory - add to ox_inventory/data/items.lua, copy bank_card.png into ox_inventory/web/images/. Item needs consume = 0 and client = { export = 'awoken_banking.useBankCard' }, or using the card deletes it or does nothing.
qb-inventory / ps-inventory - add to qb-core/shared/items.lua, copy the png into qb-inventory/html/images/ (or ps-inventory/html/images/). Item needs useable = true.

Ready-made snippets are in install/inventories/. Each card is unique (carries its own metadata), so make it non-stackable. See Bank cards.

qb-inventory and ps-inventory follow the documented exports but aren’t yet verified on a live server. Mention this first if a card misbehaves there.

Using a card says there's no ATM nearby

Expected. Using the bank_card item opens straight to that card’s PIN, but only when an ATM prop is in range. Walk up to a world ATM and use the card again. Controlled by Config.Atm.useCardItem in config/atm.lua.

The app is in the wrong language, or stays English

Set Config.Locale in your deployed config (resources/awoken_banking/, not dev/) and restart:

config/core.lua

Config.Locale = 'en'   -- en, es, fr, de, pt, cs, it, nl, pl, sv, tr

Untranslated keys fall back to English, so a partly-English app usually means a missing or edited locale key. See Language.

Players can open the bank anywhere

Config.Debug is still on. It’s dev-only: with it enabled, /bank opens anywhere and clients may skip the proximity check. Turn it off for live:

config/core.lua

Config.Debug = false

A society boss menu or paycheck stopped working

Get Started

Awoken Scripts

Still stuck?

Get support on Discord

​Still stuck?

Get support on Discord

Still stuck?