TLL_VirtualGarage WIP

TLL_VirtualGarage – The Last Light Vehicle Storage & Security

Claim your vehicle, manage its access and store it for another journey. TLL_VirtualGarage combines vehicle ownership, PIN security and console-based virtual storage for compatible Arma Reforger scenarios. Developed for The Last Light and Project Ashfall.

VEHICLE OWNERSHIP & SECURITY
Claim supported vehicles and associate them with a player identity. Owners can manage locking and PIN access through the TLL vehicle interactions. Correct PIN entry can authorize other players to access a locked vehicle. Security changes are handled on the server, with caller identity resolved through the player controller.

The security registry works with standard Vehicle entities; supported vehicle prefabs do not require a separate TLL security component to be added individually.

CONSOLE-BASED VIRTUAL STORAGE
Use a configured garage console to view your stored vehicles, store an owned vehicle or retrieve one from your records.

To store a vehicle:
- You must be its owner.
- It must be within 10 metres of the console.
- Everyone must leave the vehicle.
- The vehicle must be stopped and not destroyed.
- The scenario's required persistence systems must be available.

Stored records belong to their owner. PIN access to a deployed vehicle does not grant ownership or permission to retrieve another player's garage records.

CARGO & NESTED INVENTORY
New vehicle snapshots record supported trunk/deposit cargo and nested item contents, including bags and magazine ammunition. Supported item default-hit-zone health is also recorded.

Retrieval rebuilds the saved cargo from its original prefabs, then verifies the reconstructed contents before the transfer can finish. An intentionally empty trunk is restored as empty rather than receiving extra default cargo.

CANTEEN WATER
Remaining water is saved inside supported cargo containers, including canteens stored inside bags. Empty, partially filled and full quantities remain distinct. Verification checks explicitly saved water amounts, helping prevent a retrieved canteen from silently returning with the wrong quantity.

FUEL & VEHICLE CONDITION
Snapshots preserve native fuel quantities, supported named damage zones and engine-drowned state. Retrieval restores these supported values and leaves the engine stopped. This is storage, not an automatic refuel or repair service.

SECURITY STATE
Vehicle UID, owner identity, PIN, lock state and authorized identities are included in the snapshot for restoration alongside the supported vehicle contents and condition.

VERIFIED TRANSFERS & RECOVERY
Garage transfers use durable prepared states and native checkpoints. Only one transfer is finalized at a time. A pending message means the operation is still in progress; wait for its completion message.

If a required prefab is missing, the cargo layout has changed, restoration fails or verification does not match, retrieval is blocked and the stored record is retained for recovery. Pending files and backups support recovery from damaged save generations. Retrieval receipts help prevent an older index backup from issuing an already retrieved vehicle again.

EXISTING SAVES
The existing garage index format remains compatible. Older prefab-only records cannot recover cargo or condition that was never recorded; retrieving and storing the vehicle again creates a new snapshot.

Older cargo snapshots without water fields remain readable. Those items use prefab defaults because their previous water quantity was not saved. No generation change or wipe is required for this update.

SCENARIO REQUIREMENTS
Requires a configured garage console, active native session persistence and SCRIPTED saves enabled. Preserve the garage index together with its snapshots, pending/backup generations and retrieval receipts.

Player inventory and base-storage persistence are separate systems. Avoid competing vehicle ownership or garage restoration systems unless compatibility has been tested.

CURRENT LIMITS
Clear the retrieval area before using the console: the current build does not reliably block output against players, vehicles or obstacles.

Exact inventory grid positions, chambered rounds, mounted weapon ammunition, detached vehicle parts, custom batteries and arbitrary mod-specific vehicle state are not guaranteed. Test the vehicle addons used by your scenario.

Updated and compiled for Arma Reforger 1.9.0.37. Local M151 cargo/status validation passed 25 checks, including nested contents, ammunition, water, fuel, damage, backup recovery and empty-trunk restoration. Full console store/retrieve transactions, native checkpoints, dedicated-server restarts and remote multiplayer testing remain pending.

COMMUNITY & FEEDBACK
Report issues and follow Project Ashfall:
https://discord.gg/GH6vQzQ7en