Locations and safe zones¶
Static trader groups live in Traders/Locations.json. Enable EnableStaticTraders in root Settings.json. Traveling traders have their own placement in Routes/Routes.json.
Trader groups¶
Add groups to the top-level Locations array. Give each group a unique Id. Set Enabled: false to disable the group, or disable a single trader in its entry. An optional group CurrencyId overrides the catalog default.
| Trader field | Purpose |
|---|---|
TraderId |
Profile ID in Trading/Catalog.json. Use it once per group. |
EntityClassName |
Exact survivor or interactable object class. |
Position, Orientation |
Three numbers each, in DayZ position and orientation order. |
Attachments |
Survivor loadout. Placement tries an attachment slot, then free hands, then inventory. |
Enabled |
Defaults to true. |
CurrencyId |
Optional currency override. |
OpeningHoursEnabled, OpeningHour, ClosingHour |
Optional DayZ world-time opening hours. |
VehicleSpawnPoints |
Optional vehicle positions and orientations. |
The server looks for a nearby unbound entity of the exact class at each static location. If none is available, it spawns one at the configured transform. For a full example, see first custom shop.
Static location objects¶
Use the group's Objects array to place terminals and props. Each entry needs a House-derived ClassName and a three-number Position and Orientation. The server spawns objects for enabled groups when EnableStaticTraders is on. An existing object of the same class within 0.1 m is reused. A group can have up to 128 objects. Restart after editing placements.
This fragment shows one of the bundled Green Mountain ATMs. For a custom site, use your own transform and append the object to the group's Objects array.
{
"Objects": [
{
"ClassName": "RaG_ATM",
"Position": [3706.667236, 402.002563, 5984.945313],
"Orientation": [-93.32019, 0.0, 0.0]
}
]
}
Placement creates the object. Its banking, market, or garage feature must also be enabled. A standalone garage meter needs a matching site.
Opening hours¶
With OpeningHoursEnabled: true, opening is inclusive and closing is exclusive. 8 to 20 opens from 08:00 through 19:59. 20 to 6 crosses midnight. Equal hours mean always open. The server rechecks hours at checkout.
Restart after editing static locations, survivor loadouts, hours, or safe zones.
Safe-zone settings¶
Set EnableSafezones: true in root Settings.json and add a Safezone object to the static group or route stop. Set its Enabled to true. Center is a separate [x, y, z] position and Radius measures horizontal distance in metres. The bundled static zones have Enabled: false.
| Field | Default | Effect |
|---|---|---|
Enabled |
false |
Activates the configured zone. |
Center, Radius |
[], 150.0 |
Supply three coordinates when enabled and check coverage at the border. |
BlockIncomingDamage, BlockOutgoingDamage |
true, true |
Protect players inside and restrict damage they deal to other players. |
ProtectPlayerEquipment |
true |
Protects items rooted in a protected player's inventory. |
DeleteAnimals, DeleteInfected |
true, true |
Removes matching wildlife and infected from the zone. |
ExcludedEntityClasses |
[] |
Exempts classes and their descendants from deletion. |
BlockWeaponFire |
true |
Blocks supported weapon firing. |
BlockExplosives |
true |
Blocks supported arming, trigger attachment, grenade unpinning, and remote trigger actions. |
BlockBuilding |
true |
Blocks supported deploy and build actions. |
VehicleSpeedLimitKmh |
30.0 |
Caps car speed. 0 disables the cap. |
ShowNotifications |
true |
Shows zone and exit protection notices. |
ExitProtectionSeconds |
30 |
Grace period after leaving the last overlapping zone. 0 disables it. |
PreserveHunger, PreserveThirst, PreserveDisease, PreserveTemperature, PreserveBleeding |
false |
Pauses the corresponding survival effects in the zone. Existing disease and wounds remain. |
Exit protection follows the departed zone's incoming damage, outgoing damage, equipment, and weapon-fire settings. Building, explosive, speed, and survival restrictions apply inside the zone. Admin IDs bypass the weapon, building, explosive, and car-speed restrictions. Damage protections still apply.
In overlapping zones, applicable restrictions combine. Cleanup exemptions affect animal/infected deletion only; ExcludedEntityClasses does not exempt players from damage or action policy. Equipment protection follows items rooted in a protected player's inventory, not every dropped object or parked vehicle in the area.
Test the border with an ordinary player, including overlapping zones and any building or weapon mods that supply their own actions.