Skip to content

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.