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_main
forge_server_common
forge_server_extension at runtime for garage extension calls
forge_client_garage for response RPCs

Main Components

fnc_initGarage.sqf initializes garage world objects.
fnc_initGarageStore.sqf manages player garage hot state.
fnc_initVGStore.sqf manages 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 checkout
notification.requested - storage and vehicle modification alerts

The store module emits these events when granting vehicles; garage applies the changes to player state.

Starting Unlocks

Missions can include CfgStartingEquipment.hpp from description.ext to configure initial virtual garage unlocks for new players.

class CfgStartingEquipment {
    class Unlocks {
        class Garage {
            cars[] = {"B_Quadbike_01_F"};
            armor[] = {};
            helis[] = {};
            planes[] = {};
            naval[] = {};
            other[] = {};
        };
    };
};

The extension virtual garage default is intentionally empty. The server addon seeds CfgStartingEquipment unlocks only when a player does not already have a persistent owner-scoped garage record.

1.9 KiB Raw Blame History