Summary
# LHDF Vehicle Lock
LHDF Vehicle Lock adds vehicle ownership, locks and keys.
Description
# LHDF Vehicle Lock
LHDF Vehicle Lock adds vehicle ownership, locks and keys. It is part of the Lost Hope Dynamic Framework (LHDF) and builds on LHDF Core.
Every vehicle based on the vanilla vehicle base prefab can have an owner. The owner can lock it, give keys to other players and hand it over. Ownership, lock state and keys are saved with the vehicle in the vanilla save, which also keeps its position, damage, fuel and cargo. Players get vehicles by buying them (LHDF Shop), by claiming them (if the server allows it) or from a Game Master.
## Features
- Access: the owner, key holders, the owner's group (optional) and admins (optional). AI act with the access of the player leading their group.
- Locked vehicles refuse getting in, switching seats, doors, storage, refuel, repair and supply loading for anyone without access. The server also puts people without access out again and refuses taking items out of a locked vehicle's storage.
- Interactions on the vehicle: owner info, lock and unlock, manage, claim and give up (claim and give up are 10 s hold actions).
- Manage window (owner and admins): lock, give up, the key holders (offline ones too) with Take key, and the players nearby with Give key and Hand over. Works with mouse and controller.
- Claiming of unowned, empty vehicles, off by default, with a limit per player. Bought vehicles do not count towards the limit.
- Owned vehicles are not removed by the garbage system. A vehicle that is given up is an ordinary vehicle again.
- Game Master attributes on vehicles: Owner (no owner, a connected player, or the offline owner kept) and Locked.
- Vehicle Spawner (Game Master content browser under Systems, or in a world file): keeps one vehicle of a prefab at its spot and replaces it after the respawn delay once it is destroyed, deleted or owned by a player. Its vehicles are not saved until a player owns one, and cannot be claimed unless "Players may claim" is on. Game Master attributes: Respawn delay (10 to 1800 s), Players may claim, Take nearest vehicle (adopts the nearest vehicle within 10 m).
- Works with LHDF Shop: vehicles bought there get their owner through LHDF Core. Vehicle Lock does not need the Shop.
## Required on server and clients
Ownership is replicated with each vehicle, and the interactions, manage window and Game Master attributes run on the clients, so the mod must be loaded on the server and on every client.
## Dependencies
- Arma Reforger
- LHDF Core
## Configuration
Settings live in `$profile:LHDF/<namespace>/VehicleLock.json`. On every start the server writes every key with its default to `_defaults/VehicleLock.md` and `_defaults/VehicleLock.json` in the same folder.
- `lockNewVehicles` (default true): vehicles are locked when they get an owner. Live-editable.
- `groupSharing` (default true): the owner's group may use locked vehicles. Live-editable.
- `allowClaiming` (default false): players may claim unowned, empty vehicles. Live-editable.
- `maxClaimedVehicles` (default 2, 0 to 1000): claimed vehicles per player; 0 is no limit.
- `transferKeepsClaimed` (default true): a claimed vehicle handed over stays claimed; off, it becomes an ordinary owned vehicle like a bought one. Live-editable.
- `adminBypass` (default true): admins use, unlock and manage every vehicle.
- `enforceOnServer` (default true): the server puts anyone without access out of a locked vehicle.
- `interactionRange` (default 15, 3 to 100 m): distance for claim, give key and hand over.
- `respawnDestroyed` (default false): destroyed owned vehicles come back new on the next start next to where they were destroyed, owned and locked as before.
## Known limitations
- Vehicles whose prefab does not inherit the vanilla vehicle base prefab cannot be owned.
- Owned vehicles are never released automatically, also when the owner does not come back (only a destroyed one is released; its wreck goes to the garbage system).
- After a restart, group sharing works again once the owner has joined.
- Do not run it together with another vehicle lock mod (for example the vehicle lock of WCS); switch the other one off.
Beta: feedback welcome on the Lost Hope Survival Discord: https://discord.gg/uDzYTTdsM6
License
CUSTOM LICENSE – RESTRICTED SERVER USE
Version 1.0 – 2026-10-01
1. OWNERSHIP
This mod, including all code, assets, configurations and documentation
(the "Content"), is created and owned by BoomstickBarry / the LHDF Team (the "Author").
All rights not expressly granted in this license are reserved.
2. PERMITTED USE
Without further permission, you may:
a) download the Content through the Arma Reforger Workshop;
b) use it in single-player, offline or local Workbench sessions for
personal, non-commercial purposes;
c) host it on the following authorized servers only:
[Lost Hope Survival - Nizla Island].
3. SERVER RESTRICTION
You may not load, host, run or otherwise deploy the Content, in whole or
in part, on any multiplayer server other than those listed in Section 2(c)
without prior written permission from the Author. This applies to public,
private, password-protected, unlisted, test and event servers, and to
server-side-only use.
4. REQUESTING PERMISSION
Requests must be sent through the Lost Hope Survival Discord:
https://discord.gg/uDzYTTdsM6. Permission is valid only if
given in writing by the Author, applies only to the servers named in it,
and cannot be transferred or sublicensed.
5. NO REDISTRIBUTION
You may not reupload, mirror, repack, merge into another mod, or otherwise
redistribute the Content on any platform.
6. NO DERIVATIVES
You may not modify, adapt, decompile, extract assets or code from, or
create works based on the Content without written permission. Creating a
separate mod that lists the Content as a dependency is allowed only for
use on authorized servers.
7. NO COMMERCIAL USE
You may not sell the Content or use it in any context involving direct or
indirect financial gain, including servers with paid access, paid perks
or donation-based advantages.
7a. NO USE OUTSIDE BOHEMIA INTERACTIVE PRODUCTS
The Content may only be used within Arma Reforger and other Bohemia
Interactive products. It may not be transferred to, used in, or adapted
for any other game, engine or platform.
8. TECHNICAL MEASURES
The Content may include checks that limit its functionality to authorized
servers. Circumventing, disabling or removing these checks is prohibited.
9. TERMINATION AND REVOCATION
Any breach of this license automatically ends your rights under it. The
Author may revoke any granted permission at any time. After termination
or revocation, you must stop using the Content on any server immediately.
10. NO WARRANTY
The Content is provided "as is", without warranty of any kind. The Author
is not liable for any damage, data loss or server issues arising from its
use.
11. THIRD-PARTY CONTENT
Any third-party material included in the Content remains subject to its
own license, and nothing here overrides those terms.
12. CHANGES
The Author may update this license. The version shown on the Workshop
page is the one that applies.
13. SEVERABILITY
If any part of this license is found unenforceable, the rest remains in
effect.
