- Updated HomeView and RegistrationView to reflect the new $50,000 registration fee for organizations. - Enhanced actor onboarding process to include sending welcome emails and messages, along with initializing bank accounts with $2,000 starting credit. - Added functionality to change bank PINs, including validation and persistence of new PINs. - Updated bank and organization modules to handle registration fee charges and refunds appropriately. - Enhanced documentation to reflect changes in organization registration and bank operations.
Forge Server Bank
Overview
The bank addon owns the SQF bridge for player accounts, cash and bank balances, PIN/session handling, transfers, checkout charging, earnings deposits, and credit-line repayment. It also verifies and persists player-requested ATM PIN changes.
Account truth lives in the extension hot cache. SQF handles Arma-facing validation, client messaging, session state, and payment integration with other server addons.
Dependencies
forge_server_mainforge_server_commonforge_server_extensionat runtime for bank extension callsforge_server_orgat runtime for credit-line repaymentforge_client_bankandforge_client_notificationsfor response RPCs
Main Components
fnc_initBank.sqfinitializes all bank stores and helpers.fnc_initModel.sqfdefines account defaults and migration behavior.fnc_initPayloadBuilder.sqfbuilds UI, checkout, and organization payment context.fnc_initSessionManager.sqfmanages PIN and authorization session state.fnc_initMessenger.sqfsends account syncs, alerts, and notifications.fnc_initStore.sqfwraps hot bank calls and account mutations.
Supported Operations
- initialize and hydrate player bank state
- deposit, withdraw, transfer, and deposit earnings
- validate PIN-backed sessions and change ATM PINs
- charge checkout previews and committed purchases
- repay organization credit lines with rollback on failure
- save hot bank state to durable storage
Runtime Notes
forge_server_main_fnc_saveHotState saves bank hot state on disconnect and
mission shutdown. Store checkout and task rewards use this addon for
authoritative player balance changes.
Account syncs and notifications route through the event bus:
bank.account.sync.requested- client-facing account syncnotification.requested- alerts and transaction notifications
These events are emitted and listened to by the notifications addon.