- Updated README.md files for extension, garage, locker, main, organization, phone, store, and task addons to provide clearer overviews, dependencies, main components, and usage notes. - Improved task module documentation to clarify timer semantics and server task flows, ensuring accurate usage of time limits. - Adjusted default values for task time limits and IED timers to enforce positive countdown requirements. - Added new CAD addon for dispatch coordination, including its overview, dependencies, main components, and event handling.
1.6 KiB
1.6 KiB
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.