c176837a2c
- Add missing forge_server_actor runtime dependency to phone module (critical) - Clarify that garage and locker are event bus listeners, not emitters - Document economy runtime-only dependencies (bank, org) - Add TaskStore public API documentation (27 methods organized by category) - Update task module event emissions and hooks documentation All documentation now aligns with actual implementation verified against codebase.
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.
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
- 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.