ATMs

An ATM is a limited version of the bank app for quick cash - withdraw, check a balance, and go. Anything more (deposits, transfers, moving money between accounts) needs a full teller at a bank. Turn ATMs off with Config.Atm.enabled = false. Everything here is in config/atm.lua.

The two ways in

Target the ATM - walk up and use it. With ox_target you get a Use ATM prompt; the built-in drawtext prompt uses the nearest ATM.
Use a bank card - use a card near an ATM to open it against that card’s account. See Bank cards.
A custom ATM spot - add extra ATM points anywhere with the in-game creator (a walk-up [E] prompt or a drawn zone). They open the same ATM UI - no props, no ownership, just an interaction point where you need one. The withdrawFeePercent below applies to these too.

By default an ATM is card-driven: pick a card you’re carrying, enter its PIN, and it works against only that card’s account. Steal someone’s card and PIN and you can use their ATM - deliberate, like real life. Set requireCard = false for cardless ATMs, where players open their own accounts by identity.

What you can do at an ATM

Each action can be switched on or off. A disabled action is enforced on the server and its tab is hidden, so players never see it. Anything off here still works at a teller.

config/atm.lua

actions = {
    withdraw = true,
    deposit  = false,   -- off by default: ATMs are cash-out only
    transfer = false,
    balance  = true,
}

Action	What it does	Default
`withdraw`	Take cash out.	On
`deposit`	Put cash in.	Off
`transfer`	Move money to another account.	Off
`balance`	View the account balance.	On

Limits and fees

ATMs have their own caps, separate from teller limits (Config.Money). These apply only at ATMs.

Setting	What it does	Default
`maxWithdraw`	Most cash a player can take out in a single withdrawal.	`5000`
`dailyLimit`	Total a character can withdraw from ATMs per day. `0` = unlimited.	`0`
`withdrawFeePercent`	Fee on each withdrawal, as a fraction `0`-`1` (e.g. `0.05` = 5%). `0` = free.	`0.0`

The settings

Setting	What it does	Default
`enabled`	Target world ATM props to open the UI. `false` = ATMs off, tellers only.	`true`
`models`	ATM prop models that open the app. Add or remove to support more props.	fleeca + standard ATMs
`requireCard`	Every ATM action needs a card. `false` = cardless.	`true`
`requirePin`	Ask for the card’s PIN before opening.	`true`
`allowPhysicalHolder`	Bearer model - whoever holds the card may use it, not just its owner.	`true`
`target.label` / `target.icon`	Wording and icon of the ox_target prompt.	`Use ATM`
`target.distance`	ox_target interaction distance.	`1.5`
`range`	Metres a player must stay within; every action re-confirms it.	`3.0`
`animation`	Play the card-insert pose before the UI. `false` = open instantly.	`true`

Good to know

Standing check - wherever a player opens it, the server re-confirms they’re within range metres on every action. Walk away mid-session and the ATM stops serving you.
Physical cards - whether cards are inventory items is set in Bank cards (Config.Cards.inventory.enabled). This file only decides whether the ATM asks for one.
Steering players to banks - a modest maxWithdraw plus a small withdrawFeePercent keeps ATMs handy for quick cash but makes the teller the better deal for big amounts.

Get Started

Awoken Scripts

The two ways in

What you can do at an ATM

Limits and fees

The settings

Good to know

​The two ways in

​What you can do at an ATM

​Limits and fees

​The settings

​Good to know

The two ways in

What you can do at an ATM

Limits and fees

The settings

Good to know