Skip to main content

​
Asset download

Once you buy from our official website, the asset lands in your Cfx.re portal. Download it from there. The asset must sit on the keymaster account that made the purchase, or transfer it across first.

​
What you need

Required

ox_lib and oxmysql. Database tables are created automatically.

Optional

ox_target (or the built-in prompt) to walk up to tellers and ATMs, and an inventory for physical bank-card items.
Awoken Banking works on QBox, QBCore, and ESX and detects your framework automatically.

​
Remove your old bank first

Awoken Banking replaces your existing bank and the society money store. It answers to the same names other scripts call (Renewed-Banking, qb-banking, qb-management, esx_society), so running the originals alongside it will clash. Delete or comment out those ensure lines before you start.
  • Renewed-Banking / qb-banking - the player bank. Awoken Banking replaces it completely.
  • qb-management / esx_society - the society money store: the shared cash behind each job and gang. Awoken Banking becomes that store, so job and gang balances, boss deposits and withdrawals, and automatic paychecks all flow through it.
You do not lose hiring, firing, or rank management. Those are part of your framework (qbx_core / qb-core / es_extended), not the bank. Awoken Banking only takes over the money side of job and gang accounts, so your job system keeps working exactly as before.
Prefer to keep your own society money system and use Awoken Banking only for player accounts? Set Config.SocietyBridge = false and remove the provide 'qb-management' / provide 'esx_society' lines from fxmanifest.lua. See Business & shared accounts.

​
Install

1

Drop the folder in place

Put the awoken_banking folder (the one from releases/) into your server’s resources/. Keep the folder name exactly awoken_banking.
2

Add the bank-card item (optional)

Only needed for physical bank cards in the inventory. Virtual cards and ATMs work without it.
  • Copy the item block from install/inventories/ into your inventory’s item list.
  • Copy install/inventories/images/bank_card.png into your inventory’s images folder.
To skip cards entirely, set Config.Cards.inventory.enabled = false in config/cards.lua. See Bank cards.
3

Grant the admin permission

Lets your staff use the setup and management commands. In server.cfg:
server.cfg
4

Set the ensure order

server.cfg
5

Start the server

On first launch the database tables build themselves - there is no SQL file to import. Watch the console for a clean start with no oxmysql errors. A set of default bank tellers is placed on the map automatically; move or add your own later. See Bank locations.

​
Point it at your framework

Open config/core.lua. Auto-detection handles most setups; override by hand if it guesses wrong:
config/core.lua
Set Config.Inventory = 'none' if you don’t use physical cards, and Config.Interaction = 'drawtext' for a simple [E] prompt instead of ox_target.

​
What’s inside

Everything in config/ (including config/locales/) is left open by asset escrow - those are the files you’re meant to touch. Everything else is protected. See FiveM asset escrow.

​
Moving from another bank

Awoken Banking can do a one-time import of existing balances and history from Renewed-Banking, qb-banking, ESX, DM Banking, Bablo, Snipe, and Nano Banking. Run it automatically on first start (Config.AutoImport) or manually from the console with a dry-run preview. See Moving from another bank.

​
Updating

Re-download the asset from your Cfx.re portal, replace the folder, and restart with ensure awoken_banking.
Replacing the folder overwrites everything in config/. If you’ve tuned your settings, back the config/ folder up first, then re-apply your changes.

​
First check

Once you’re in-game, walk up to a bank teller or an ATM and open the app. If it shows your balance, you’re live. From here:

Set your options

Money limits, currency, language, and which features are on.

Place your banks

Move the default tellers or add your own with the in-game creator.