> For the complete documentation index, see [llms.txt](https://devmosaic.gitbook.io/devmosaic/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://devmosaic.gitbook.io/devmosaic/resources/devmosaic-banking/troubleshooting.md).

# Troubleshooting

### No Bank Target Or No ATM Target

Check:

* target resource is started
* `Config.Bridge.target = 'auto'`
* target resource is supported
* `Config.ATMs` contains the ATM models
* `Config.Peds` contains valid peds

Enable:

```lua
Config.Debug = true
```

### No Bank Peds

Check:

* ped models are valid
* coordinates are valid
* client console has no model loading errors
* `dm-banking` started after framework and target

### ATM Card List Is Empty

Check:

* `Config.Cards.enabled = true`
* `Config.Cards.inventory.enabled = true`
* `Config.Cards.inventory.item = 'bank_card'`
* player has the physical item
* inventory bridge is detected
* card metadata exists

### Card Opens The Player Account Instead Of Card Account

Use:

```lua
Config.Cards.atm.openAccountFromCard = true
Config.Cards.atm.allowPhysicalCardHolder = true
```

### Frozen Card Still Works

Check:

* card row has `frozen = 1`
* resource was restarted
* player is not using an old item with bad metadata
* server console has no card validation errors

### Loans Unavailable

Check:

* `server/loans.lua` exists
* `server/loans.lua` is listed in `fxmanifest.lua`
* `Config.Loans.enabled = true`
* server console has no Lua syntax error

### Locale Not Working

Check:

* `Config.Locale` is correct
* locale file exists
* locale key exists in the selected JSON file
* resource restarted after locale edits

### Theme Not Working

Check:

* `data/ui.lua`
* `activeTheme` exists inside `themes`
* resource restarted after changing theme

### Web Changes Not Showing

Rebuild:

```powershell
cd path\to\dm-banking\web
npm run build
```

Then restart:

```
restart dm-banking
```

### Recommended Debug Info

When reporting issues, include:

* framework resource name
* inventory resource name
* target resource name
* `Config.Framework`
* `Config.Bridge`
* server console error
* client F8 error
* reproduction steps