- 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.
1.3 KiB
1.3 KiB
Forge Server Garage
Overview
The garage addon is the server-side bridge for player vehicle storage and owner-scoped vehicle unlock storage.
Garage hot state is owned by the extension. SQF validates Arma-facing requests, serializes vehicle payloads, sends client syncs, and marks editor-placed garage objects.
Dependencies
forge_server_mainforge_server_commonforge_server_extensionat runtime for garage extension callsforge_client_garagefor response RPCs
Main Components
fnc_initGarage.sqfinitializes garage world objects.fnc_initGarageStore.sqfmanages player garage hot state.fnc_initVGStore.sqfmanages owner-scoped vehicle unlock state.
Supported Operations
- initialize player garage data
- save player and owner-scoped garage state
- store and retrieve player vehicles
- initialize and save owner-scoped vehicle storage
Runtime Notes
forge_server_main_fnc_saveHotState saves both GarageStore and
VGarageStore on disconnect and mission shutdown.
Garage listens for sync events through the event bus:
garage.vgarage.sync.requested- updates client vehicles and unlock state when granted by store/task checkoutnotification.requested- storage and vehicle modification alerts
The store module emits these events when granting vehicles; garage applies the changes to player state.