> ## Documentation Index
> Fetch the complete documentation index at: https://docs.awokenlabs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting

> Fixes for the handful of things that trip people up on first setup.

Most first-setup problems are one of three things: an old bank still running, a config value pointed at the wrong backend, or a missing `bank_card` item. Find your symptom below.

<AccordionGroup>
  <Accordion title="It picked the wrong framework or inventory">
    Auto-detection guessed wrong. Set them by hand in `config/core.lua` and restart:

    ```lua config/core.lua theme={"dark"}
    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.
  </Accordion>

  <Accordion title="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](/resources/awoken-banking/configuration/cards).

    <Note>
      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.
    </Note>
  </Accordion>

  <Accordion title="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`.
  </Accordion>

  <Accordion title="The app is in the wrong language, or stays English">
    Set `Config.Locale` in your **deployed** config (`resources/awoken_banking/`, not `dev/`) and restart:

    ```lua config/core.lua theme={"dark"}
    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](/resources/awoken-banking/configuration/language).
  </Accordion>

  <Accordion title="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:

    ```lua config/core.lua theme={"dark"}
    Config.Debug = false
    ```
  </Accordion>

  <Accordion title="A society boss menu or paycheck stopped working">
    Awoken Banking takes over the shared **business account** and answers to `qb-management` and `esx_society`. If a boss menu or paycheck broke after install, you still have the old society resource ensured - remove it like you removed the old bank. See [Society accounts](/resources/awoken-banking/configuration/society).
  </Accordion>
</AccordionGroup>

## Still stuck?

<Card title="Get support on Discord" icon="discord" href="https://discord.gg/awokenlabs">
  Bring your `server.cfg` ensure order, your framework and inventory, and anything from the server console. That's usually enough for us to spot it fast.
</Card>