A complete and immersive, banking system for RedM servers running Vorp Core. Players open personal and shared accounts, write and redeem paper checks, issue invoices to other players, and manage everything.

[SHOWCASE VIDEO]

Key Features

Bank Accounts: Players open personal bank accounts directly from any bank NPC. Each account has a configurable name, tracks its full transaction history, and can be locked or unlocked by the owner. Account balances persist in the database and survive restarts.

Shared Accounts: Account owners invite other players to share access. Configurable per-account permissions control who can deposit, withdraw, or manage members. Shared accounts appear in every member's bank UI under a dedicated tab.

Paper Check System: Players purchase blank check booklets at the bank. A check is filled out with a payee name, amount, and memo, and becomes a physical inventory item. The recipient redeems it at any bank for the full value. Checks are one-use and expire after a configurable number of hours.

Invoice / Billing System: Players with a bank account purchase invoice booklets from the teller. Using a booklet opens a form to specify a target player, the receiving account, an amount, and a description. The issued invoice appears as a physical item in the debtor's inventory. Debtors pay directly from the bank UI under the "My Bills" tab. Withdrawals are blocked while any pending invoice remains unpaid. A configurable CRON job auto-expires overdue invoices and notifies the debtor.

Multiple Bank Locations: Define as many bank locations as you need in config. Each spawns a configurable NPC, a map blip, and a target interaction zone. Prompt-based interaction keeps the experience fully RP-friendly.

Withdraw Protection: When blockWithdrawOnDebt is enabled, any player with at least one pending unpaid invoice is blocked from withdrawing cash until all invoices are settled. The error message shows the total outstanding debt.

Full Export API: Expose account and billing data to your other resources , query balances, deposit or withdraw programmatically, check pending invoices, and more via documented server-side exports.

Multi-Language Ready: English and Spanish locales included. Every UI label, notification, and system message is locale-driven. Adding a new language requires only a new JSON file.

Requirements

• Framework: vorp_core
• Database: oxmysql
• Library: ox_lib
• Inventory: vorp_inventory
• Optional: sleepless_interact

Installation

1. Download and place the ys_banking folder in your resources directory.
2. Add ensure ys_banking to your server.cfg.
3. Execute database.sql and items.sql on your database.
4. Configure bank locations, permissions, and feature flags in config.lua.

Configuration

Bank Locations: Add as many banks as your map needs. Each entry sets the NPC model, spawn coords, heading, blip style, and interaction radius independently.

Check System: Toggle on/off, set the blank check item name, filled check item name, check price, and expiry window in hours.

Billing System: Toggle on/off, configure the booklet item name, invoice item name, booklet price, invoice expiry in hours, maximum invoice amount, minimum invoice amount, and whether pending invoices block withdrawals.

Permissions: Fine-grained ACE permission nodes for account creation, shared account management, and admin maintenance mode.

Debug Mode: Enable verbose console logging to trace every callback, database query, and item interaction during development or troubleshooting.