History

Jacob Schmidt aad36ddd8d Return bank existence lookup errors to callers

- Make `bank_exists` surface backend/UID resolution failures instead of returning `false`
- Add SQF guard to log and alert on unexpected existence responses
- Prevent duplicate/default bank records after failed lookups

2026-05-21 22:39:22 -05:00

functions

Return bank existence lookup errors to callers

2026-05-21 22:39:22 -05:00

$PBOPREFIX$

Initial commit

2025-11-26 18:33:09 -06:00

CfgEventHandlers.hpp

Initial commit

2025-11-26 18:33:09 -06:00

config.cpp

feat: implement complete Forge framework with Rust/Redis backend and Arma 3 integration

2026-01-04 12:52:15 -06:00

README.md

feat: Implement organization registration fee and bank PIN change functionality

2026-05-16 12:13:13 -05:00

script_component.hpp

Initial commit

2025-11-26 18:33:09 -06:00

stringtable.xml

Initial commit

2025-11-26 18:33:09 -06:00

XEH_postInit.sqf

Emit task and CAD state changes on the event bus

2026-05-15 19:57:19 -05:00

XEH_preInit.sqf

feat: Implement organization registration fee and bank PIN change functionality

2026-05-16 12:13:13 -05:00

XEH_PREP.hpp

Bootstrap new actors from bank account creation

2026-05-17 11:12:22 -05:00

XEH_preStart.sqf

Refactor Store system to use BaseStore and update Actor/Org initialization

2026-01-10 15:42:33 -06:00

README.md

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_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 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 sync
notification.requested - alerts and transaction notifications

These events are emitted and listened to by the notifications addon.