Jacob Schmidt 9d789440e0 Enhance documentation and functionality across various server addons
- 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.
2026-04-18 11:55:19 -05:00

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_main
  • forge_server_common
  • forge_server_extension at runtime for bank extension calls
  • forge_server_org at runtime for credit-line repayment
  • forge_client_bank and forge_client_notifications for response RPCs

Main Components

  • fnc_initBank.sqf initializes all bank stores and helpers.
  • fnc_initModel.sqf defines account defaults and migration behavior.
  • fnc_initPayloadBuilder.sqf builds UI, checkout, and organization payment context.
  • fnc_initSessionManager.sqf manages PIN and authorization session state.
  • fnc_initMessenger.sqf sends account syncs, alerts, and notifications.
  • fnc_initStore.sqf wraps 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.