🏦 Xrisma Banking | Advanced Bank Ownership & Economy System

Welcome to Xrisma Banking, the ultimate and most feature-rich banking & economy system for your FiveM server.
Designed specifically for high performance enterprise level servers with full branch ownership, vault economy, loans, missions, and more.

✨ Key Features :

🏢 Enterprise-Grade UI/UX

• Dynamic Dashboard: Real-time vault balance, capacity monitoring, employee overview, upgrade status, and branch statistics all in one beautiful interface.
• Inspired from Lation Modern UI.

🏛️ Bank Branch Ownership System

• Purchase & Own Branches: Players can buy ownership of 8 unique bank locations across the map (Legion Square, Rockford Hills, Paleto Bay, Sandy Shores, and more).
• Dynamic Pricing: Each branch has a unique price based on location ($300K–$800K).
• Ownership Limits: Configurable max banks per player (default 2) with 24-hour cooldown between purchases.
• Branch Selling: Resell branches for a configurable return percentage (default 60%).
• Admin Override: Admins can set/remove ownership, lock/unlock branches, and adjust vault balances remotely via `/bankadmin`.
  
  

💰 Complete Vault Economy

• Shared Vault Per Branch: All deposits at a branch feed into the owner's vault with real-time balance tracking.
• Vault Capacity System: Default 50K per branch, upgradeable to 275K+ through the upgrade system.
• Automatic Vault Drain Cycle: Configurable periodic money removal (5% per hour default) with minimum balance protection ($1,000).
• Custom Withdrawal Fees: Branch owners can set withdrawal fees (0–25%) per location fees collected feed the economy.
  
  

💳 Full Banking & Transactions

• Multi-Account System: Players can create and manage multiple personal bank accounts per character.
• Deposits, Withdrawals & Transfers: Full player-to-player transfers with custom descriptions and transaction history.
• 11 Transaction Types: Deposit, Withdrawal, Transfer In/Out, Fee, Restock, Salary, Upgrade, Purchase, Loan Payment, Loan Disbursement.
• Account Freezing: Admins can freeze/unfreeze player accounts with reason logging.
  
  

📊 Loan System

• Flexible Loan Origination: Players can apply for loans with configurable duration and compound interest (default 5%).
• Loan Status Tracking: Track active, overdue, paid, and defaulted loans with full history.
• Partial Payment Support: Pay down loans in installments or pay in full.
• Account Locking on Default: System automatically locks accounts when loans default.
• Configurable Limits: Min/max loan amounts, max active loans per player, max duration, and custom interest rates.
  
  

👥 Employee Management System

• Two Employee Types: Security Guards (max 4, reduce negative events) and Bank Tellers (max 6, increase positive events).
• 4 Role-Based Permissions: Viewer, Teller, Manager, Director each with a granular permission matrix.
• Automatic Payroll: Configurable hourly salary cycle with different base salaries per employee type.
• NPC Employees: Unique NPC models and scenarios at each branch with target/interaction support.
  
  

⬆️ Branch Upgrade System

• 4 Upgrade Types with Multiple Levels:
  • Vault Capacity (5 levels) Increase max vault storage up to 275K+.
  • Security System (5 levels) Reduce robbery and theft event damage.
  • Reinforced Doors (3 levels) Reduce vault breach and robbery losses.
  • Camera System (3 levels) Reduce counterfeit/ATM skimming, increase audit rewards.
• Dynamic Pricing: Each level costs more with multiplier scaling.
• Employee Synergy: Upgrades work with employees to maximize effect.
  
  

⚡ Dynamic Bank Events System

• 10 Unique Event Types: 6 negative events (Robbery Attempt, Counterfeit Cash, Vault Breach, Insider Theft, ATM Skimming, Equipment Failure) and 4 positive events (Security Bonus, Customer Surge, Federal Audit Reward, VIP Client Deposit).
• Automatic Triggers: Periodic checks every 30 minutes per branch with weighted probability (40% base chance).
• Upgrade & Employee Mitigation: Upgrades reduce negative event damage by up to 95%, employees reduce losses by up to 80%.
  
  

🚛 Restock Missions System

• Bank-Funded Restocks: Request cash directly from the bank's central reserve no out-of-pocket cost for owners. Money is delivered into your vault upon mission completion.
• Restock Limit System: Configurable limit on how many restocks a branch can perform per cycle (daily, weekly, monthly) persisted in SQL with automatic reset via ox_lib cron.
• Dedicated Vehicle Spawns: Each bank branch has its own armored truck spawn point for clean, collision-free mission starts.
• Immersive Multi-Phase Gameplay: Board armored truck → Drive to facility → Talk to NPC → Grab money cart → Load truck → Drive to branch → Deposit into vault.
• Configurable Payloads: Quick selection ($50K, $100K, $250K, $500K) or custom amounts ($5K–$500K).
• Police Integration: Configurable minimum police requirement with dispatch alerts when missions start.
• Cooldown System: 30-minute cooldown between missions per player (configurable).
  
  

🏧 ATM System

• Deposit, Withdraw & Balance Check: Full banking functions at ATM locations across the map.
• Purchasable ATM Slots: 3 locations available for purchase ($15K–$30K).
• Proximity Detection: Auto-detection of nearby ATMs within 1.5m with map blips.
  
  

🚀 Optimization & Security

• 0.00ms Resmon: Highly optimized with in-memory caching for upgrades, employees, and permissions async database operations and efficient indexed SQL queries.
• Server-Side Webhook Protection: Discord webhook URLs are stored server-only never exposed to the client, preventing webhook abuse and exploitation.
• Airtight Server Validation: Every action (deposits, withdrawals, transfers, hiring, firing, missions) is validated server-side. Exploiters cannot bypass restrictions.
• Distance Validation: All transactions validate player proximity to branch (2.5m + buffer).
• Advanced Debug System: 3 debug levels (Critical, Detailed, Full Diagnostic) zero console spam when turned off.
• Clean Database Footprint: Optimized, indexed SQL tables with automatic schema creation on startup.
  
  

🔌 Massive Bridge Integration System

• Inventory: ox_inventory, qb-inventory, qs-inventory, ps-inventory, origen_inventory, codem-inventory.
• Notifications: ox_lib, esx_notify, qb-core, okokNotify, mythic_notify, pNotify, wasabi_notify.
• Vehicle Keys: qb-vehiclekeys, qs-vehiclekeys, wasabi_carlock, vehicles_keys, cd_garage, jaksam, renewed-vehiclekeys.
• Fuel: ox_fuel, LegacyFuel, ps-fuel, lj-fuel, cdn-fuel, okokGasStation, x-fuel.
• Target: ox_target, qb-target, qtarget.
• Dispatch: ps-dispatch, cd_dispatch, qs-dispatch, core_dispatch, linden_outlawalert, op-dispatch.
• Phone: lb-phone, qs-smartphone, gksphone, npwd.
• Society: esx_society, qb-management, qb-banking, okokBanking, Renewed-Banking.
• Custom Bridge Overrides: Hook into existing scripts via custom exports.
  
  

🛠️ Developer Friendly

• `shared/config.lua`: Extensive configuration economy settings, vault tuning, ownership rules, upgrade pricing, employee limits, mission cooldowns, and more.
• `bridge/*.lua`: Fully open-source bridge system override any integration with your own exports.
• Server & Client Exports: Full export API for external resource integration.
• Admin Commands: `/bankadmin` with ACE permission system (`group.dev`) for full override access.
  
  

🌍 21 Languages Supported

• English, Spanish, French, German, Italian, Portuguese, Russian, Polish, Dutch, Swedish, Norwegian, Danish, Finnish, Czech, Hungarian, Turkish, Romanian, Japanese, Korean, Chinese, Arabic.
• Flexible locale system with fallback to English and parameter substitution support.
  
  

Framework Support:

• ESX
• QBCore
• QBOX

Discord Support: Join our Discord