> ## 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.

# Bank locations

> Place and manage banks in-game with the built-in creator - no config file.

Banks live in your database, not a config file. You place, move, and delete them entirely in-game with a built-in creator - no coordinate-hunting, no restart to move one. There is deliberately no bank list in `config/`.

On a **fresh install**, Awoken Banking seeds starter tellers so the bank works immediately: **Legion Square**, **Vinewood**, **Burton**, **Hawick**, **Great Ocean Hwy**, **Route 68 / Sandy**, **Paleto Bay**, and **Pacific Standard**. Each is a teller NPC with a **Bank** blip.

## Open the creator

The creator is admin-only, gated behind `command.awoken_banking` (the same permission from [Installation](/resources/awoken-banking/installation)). Grant it in `server.cfg`, then run `/bank_creator` in-game:

```cfg server.cfg theme={"dark"}
add_ace group.admin command.awoken_banking allow
```

The menu lists every bank plus a **New** option. Pick a bank to teleport to it, **Change** to re-place it (or switch its placement type), **Edit** to change its name and blip, or **Delete** to remove it.

## Place a bank

<Steps>
  <Step title="Choose New">
    Run `/bank_creator`, select **New**, then **Bank**.
  </Step>

  <Step title="Pick a placement type">
    A **teller NPC**, a **walk-up prompt**, or a **drawn zone** (see below).
  </Step>

  <Step title="Position it">
    Aim your camera and press **\[E]** to drop it. Nudge with **arrow keys**, spin a teller with the **scroll wheel**, then **\[Enter]** to save or **\[Backspace]** to cancel. For a drawn zone, press **\[E]** for each corner (at least three), **\[Enter]** to close the shape, **scroll** to set its height, and **\[Enter]** to confirm.
  </Step>

  <Step title="Name it and set the blip">
    Fill in the **name** and **blip** options, then confirm. The bank appears live for every player - no restart.
  </Step>
</Steps>

## Placement types

<CardGroup cols={2}>
  <Card title="Teller NPC" icon="person">
    An NPC clerk you walk up to. This is what the default banks use. You choose its ped model and idle animation.
  </Card>

  <Card title="Walk-up prompt" icon="hand-pointer">
    A spot with an **\[E]** prompt and no NPC - good for counters, kiosks, or anywhere a ped would look out of place.
  </Card>

  <Card title="Drawn zone" icon="draw-polygon">
    An area you outline corner-by-corner with a height. The whole zone is the bank - ideal for wrapping an interior or a large counter.
  </Card>
</CardGroup>

## Settings

| Setting         | What it does                                              | Default                       |
| --------------- | --------------------------------------------------------- | ----------------------------- |
| **Name**        | The bank's label, shown in the app and creator list.      | `Bank`                        |
| **Blip name**   | Text on the map at the blip.                              | `Bank`                        |
| **Show on map** | Turn the blip on or off.                                  | On                            |
| **Blip colour** | Green, red, yellow, blue, purple, orange, cyan, or white. | Green                         |
| **Blip icon**   | Map-marker icon (a GTA blip sprite number).               | `108`                         |
| **Ped model**   | Teller NPC model (teller placement only).                 | `ig_bankman`                  |
| **Scenario**    | Teller idle animation (teller placement only).            | `WORLD_HUMAN_STAND_IMPATIENT` |

## ATMs are separate

ATMs are **not** placed here. Awoken Banking attaches to the game's world ATM props automatically, so every ATM on the map works out of the box. Configure them on their own page.

<Card title="ATMs" icon="money-bill-transfer" href="/resources/awoken-banking/configuration/atms">
  How world ATMs are detected and configured.
</Card>

## Reset to the defaults

Because defaults only seed into an empty table: clear your `awoken_bank_locations` table, then restart `awoken_banking`. On start it sees the empty table and re-seeds the starter banks.

<Warning>
  This wipes **all** banks, including any you added - a full reset, not a repair. To fix one bank, edit or re-place it in `/bank_creator` instead.
</Warning>
