DayZ · Config

DayZ events setup: events.xml and event spawns

Set up DayZ dynamic events like helicopter crashes and convoys: edit events.xml, add positions in cfgeventspawns.xml and props in cfgeventgroups.xml.

Last updated 2026-10-10

DayZ’s dynamic events, such as helicopter crashes, police cars and military convoys, are controlled by three XML files in your mission folder. events.xml says how many of each event exist and how long they last, cfgeventspawns.xml says where they can appear, and cfgeventgroups.xml says what props a group event is made of. You change all three with a plain text editor and the vanilla files as your starting point.

This guide uses only the file formats shipped with the dedicated server, so it works on any host. Always edit a copy of the vanilla files and keep a backup before you change anything.

Where the files are

The dedicated server (Steam app DayZ Server) ships vanilla mission folders under mpmissions/:

  • dayzOffline.chernarusplus for Chernarus
  • dayzOffline.enoch for Livonia
  • dayzOffline.sakhal for Sakhal

The mission your server runs is set by template in serverDZ.cfg. Inside that mission folder:

File Purpose
db/events.xml Event definitions: counts, lifetimes, spawn rules
cfgeventspawns.xml The map positions each event can use
cfgeventgroups.xml Reusable groups of props that events spawn together

If you host with Codeshipped, open the server, go to Files, and browse to mpmissions to edit these directly. Create a Backup first.

1. Understand an event in events.xml

Each event is one <event> block. This is the vanilla helicopter crash, shortened:

<event name="StaticHeliCrash">
    <nominal>3</nominal>
    <min>1</min>
    <max>3</max>
    <lifetime>2100</lifetime>
    <restock>0</restock>
    <saferadius>1000</saferadius>
    <distanceradius>1000</distanceradius>
    <cleanupradius>1000</cleanupradius>
    <flags deletable="0" init_random="0" remove_damaged="0"/>
    <position>fixed</position>
    <limit>child</limit>
    <active>1</active>
    <children>
        <child lootmax="10" lootmin="5" max="1" min="1" type="Wreck_UH1Y"/>
    </children>
</event>
Tag What it does
nominal How many of this event the server tries to keep on the map
min / max Lower and upper count limits
lifetime How long the event stays, in seconds
restock Seconds before a replacement can spawn (0 means as soon as possible)
saferadius Minimum distance from any player for the event to spawn
distanceradius Minimum distance from another instance of the same event
cleanupradius Players must be this far away before the event is cleaned up
position fixed uses positions from cfgeventspawns.xml; player and uniform choose positions differently
limit How min and max are counted: child, parent, mixed or custom
active 1 enables the event, 0 switches it off
children The object classes the event spawns, with how much loot each carries

To turn an event off without deleting it, set <active>0</active>. To make an event more common, raise nominal and keep min and max consistent with it.

2. Add positions in cfgeventspawns.xml

Events with <position>fixed</position> look up their positions in cfgeventspawns.xml, matched by the event name:

<eventposdef>
    <event name="StaticHeliCrash">
        <pos x="7417.24" z="1349.97" a="90"/>
        <pos x="2671.50" z="5285.30" a="0"/>
    </event>
</eventposdef>

x is the east–west map coordinate, z is north–south, and a is the angle the object faces. Optional y sets the height. Get coordinates from an in-game position readout or from a map tool, and keep each position on flat, reachable ground away from buildings and water. An event with no matching positions will not spawn.

3. Build prop groups in cfgeventgroups.xml

Group events spawn several objects together. cfgeventgroups.xml defines each group, and an event’s <child> can use the group name as its type:

<event_groups>
    <group name="Barrels_Mix">
        <child type="Land_Container_1Moh" deloot="0" lootmax="0" lootmin="0" x="0" z="0" a="0" y="0"/>
        <child type="Barrel_Blue" deloot="0" lootmax="5" lootmin="2" x="3" z="1" a="45" y="0"/>
    </group>
</event_groups>

Each child’s x, z and a are offsets from the group’s centre point, so one group can be reused at every position.

4. Check the XML and restart

  1. Make sure every tag is closed and every attribute is quoted. One error can stop the economy loading.
  2. Restart the server. Changes to these files apply on restart.
  3. Watch the log. If you turned on the economy logging described in the cfgeconomycore.xml guide, the log lists event spawns.

Existing events keep their current lifetime, so you may need to wait, or reset the economy’s saved state, before counts match your new numbers. Back up before you wipe anything, because the saved state also holds bases and stashes.

Common questions

Where is events.xml on a DayZ server?

It is in the db folder of your mission, for example mpmissions/dayzOffline.chernarusplus/db/events.xml. The positions file cfgeventspawns.xml sits directly in the mission folder.

How do I add more helicopter crashes to DayZ?

Raise nominal, and max if needed, for the StaticHeliCrash event in events.xml. Then add more <pos> lines for it in cfgeventspawns.xml, so there are at least as many valid positions as the count you want.

Why is my DayZ event not spawning?

The usual causes are <active>0</active>, no matching positions in cfgeventspawns.xml, a typo in the event name, positions that are blocked or too close to a player (saferadius), or XML that failed to load. Check the server log after a restart.

Do I need DayZ Tools to edit events?

No. Events are plain XML text files in the dedicated server’s mission folder, so any text editor works. DayZ Tools is for building mods, not for editing the Central Economy.

Can I add events that come from a mod?

Yes. Put the mod’s event definitions in their own XML file and register it in cfgeconomycore.xml, as shown in the cfgeconomycore.xml guide, rather than merging it into the vanilla file.

Troubleshooting

  • Server will not start after an edit: restore your backup and check for an unclosed tag or missing quote.
  • Event spawns in the wrong place: check you did not swap x and z, and that coordinates fit your map.
  • Too many or too few events: make min, nominal and max agree, and check limit.

Need a hand?

We run managed DayZ servers and build custom DayZ mods and tools. See how we run The Hoard, and our guide to installing mods on a DayZ server. For the full reference, see the Bohemia Interactive Central Economy documentation.

Want this handled for you? Log in to the panel or contact us.