Jacob Schmidt 8117e6ffa6 feat(economy): Enhance economy system with service charges and medical billing

- Expanded README.md to detail economy addon functionalities including refueling, medical services, and service charges.
- Updated XEH_PREP.hpp to include initSEconomyStore preparation.
- Modified XEH_postInit.sqf to ensure MEconomyStore initializes only if not nil.
- Adjusted XEH_preInit.sqf to initialize SEconomyStore correctly.
- Updated config.cpp to include forge_server_common as a required addon.
- Enhanced fnc_initFEconomyStore.sqf to manage fuel refueling sessions and organization charges.
- Improved fnc_initMEconomyStore.sqf to handle medical billing and fallback to organization funds.
- Created fnc_initSEconomyStore.sqf for organization-funded service charges and repairs.
- Updated org.rs and org.rs service layer to support member debt recording and organization fund charging.
- Added ECONOMY_USAGE_GUIDE.md for comprehensive documentation on economy functionalities.
- Updated MODULE_REFERENCE.md and README.md to include links to the new economy guide.

2026-04-18 13:37:09 -05:00

2.6 KiB

Raw Blame History

Economy Usage Guide

The economy server addon owns Arma-world service behavior for fuel, medical, and repair interactions. It does not own money state. Money mutations go through extension-backed bank and organization hot state before the world effect is applied.

Dependencies

forge_server_common for logging, formatting, and player lookup.
forge_server_bank for personal medical billing.
forge_server_org for organization-funded services and medical fallback debt.
forge_client_actor and forge_client_notifications for targeted client responses.

Fuel

Fuel is organization-funded.

When refueling stops, fnc_initFEconomyStore.sqf calculates the fuel delta and cost, charges the player's organization through OrgStore chargeCheckout, and syncs the organization patch to online members. If organization funds cannot cover the refuel, the vehicle is rolled back to the fuel level it had when the session started.

Repair

Repair is organization-funded.

Use the repair service event:

[QEGVAR(economy,RepairService), [_target, _unit, _cost]] call CBA_fnc_serverEvent;

_cost is optional. Passing -1 uses the configured service repair cost. The target is only repaired after the organization charge succeeds.

Medical

Medical is player-funded first.

When a heal is requested, fnc_initMEconomyStore.sqf uses this billing order:

Charge the player's bank balance when it can cover the medical fee.
Otherwise charge the player's cash when it can cover the fee.
If neither personal balance can cover the fee, charge organization funds.
When organization funds cover the fallback charge, record the same amount as debt on the player's organization credit line.

The heal only completes after one of those charges succeeds. If personal billing is unavailable, the heal does not fall back to organization funds because the server cannot verify that the player is unable to cover the fee.

Medical Debt Repayment

Medical fallback debt uses the existing organization credit-line repayment flow. The organization treasury is reduced when the service is rendered, and the player's credit-line amount_due increases by the medical fee. When the player repays through the bank credit-line repayment action, player bank funds are moved back into the organization treasury.

Hot-Cache Boundary

The economy addon should stay server-authoritative for world effects such as vehicle fuel, vehicle repair, healing, respawn placement, and death inventory movement. Bank and organization balances should continue to mutate through the extension-backed hot-cache services.

2.6 KiB Raw Blame History