client/addons/bank

Forge Bank Module

Overview

The Bank module provides a comprehensive banking system for the Forge client. It includes features for managing player finances, transfers, and timesheet functionality, with a modern web-based interface for seamless user experience.

Dependencies

• forge_client_main

Authors

• J. Schmidt
• Creedcoder
• IDSolutions

Features

Banking System

1. Bank Initialization (fnc_initBank.sqf)

   • Initializes the banking system
   • Sets up necessary configurations and account structures
   • Configures player account data and balances
   • Handles server-side synchronization

2. Bank Interface (fnc_openBank.sqf)

   • Opens the banking user interface
   • Provides access to all banking functions
   • Modern web-based UI with real-time updates
   • Responsive design for optimal user experience

3. Transaction Management

   • Deposit (fnc_deposit.sqf)
     • Handles money deposits into bank accounts
     • Validates transaction amounts
     • Updates account balances in real-time
   • Withdraw (fnc_withdraw.sqf)
     • Manages money withdrawals from bank accounts
     • Ensures sufficient funds
     • Updates wallet balance immediately
   • Transfer (fnc_transfer.sqf)
     • Handles money transfers between players
     • Validates recipient and amount
     • Supports both account-to-account and wallet transfers
   • Submit (fnc_submit.sqf)
     • Processes transaction submissions
     • Handles timesheet submissions
     • Manages pending payments
   • Refresh (fnc_refresh.sqf)
     • Updates account information and balances
     • Synchronizes with server data
     • Updates UI elements

User Interface

The module includes a modern web-based interface with:

1. Account Overview

   • Current wallet balance
   • Bank account balance
   • Pending payments
   • Transaction history

2. Transaction Features

   • Transfer between wallet and account
   • Player-to-player transfers
   • Timesheet submission
   • Transaction history view

3. UI Components

   • Real-time balance updates
   • Transaction notifications
   • Input validation
   • Error handling
   • Responsive design

Timesheet System

1. Rating Integration

   • Tracks player rating
   • Calculates pending payments
   • Automatic payment processing
   • Rating reset after submission

2. Payment Processing

   • Automatic calculation based on rating
   • Configurable payment multiplier
   • Pending payment tracking
   • Instant payment processing

Event Handlers

The module uses several event handlers for initialization and execution:

• XEH_preInit.sqf: Pre-initialization setup
• XEH_postInit.sqf: Post-initialization tasks
• XEH_preStart.sqf: Pre-start configuration
• XEH_postInit_client.sqf: Client-specific post-initialization
• XEH_preInit_server.sqf: Server-specific pre-initialization

Usage

To use the bank module:

1. Ensure the module is properly loaded in your mission
2. Access the bank through the provided UI
3. Perform transactions using the appropriate functions:
   • Transfer money between wallet and account
   • Send money to other players
   • Submit timesheets for payment
   • View transaction history
4. Monitor account status and transactions in real-time

Debugging

Debug mode can be enabled by uncommenting the following in script_component.hpp:

#define DEBUG_MODE_FULL

Version Information

Version information is managed through the main Forge client system configuration.

Technical Details

• Web-based interface using HTML5, CSS3, and JavaScript
• Real-time data synchronization with server
• Secure transaction processing
• Client-server event system
• Persistent data storage
• Rating-based payment system
• Transaction history tracking
• Input validation and error handling
• Responsive UI design
• Cross-browser compatibility