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.chernarusplusfor ChernarusdayzOffline.enochfor LivoniadayzOffline.sakhalfor 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
- Make sure every tag is closed and every attribute is quoted. One error can stop the economy loading.
- Restart the server. Changes to these files apply on restart.
- 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
xandz, and that coordinates fit your map. - Too many or too few events: make
min,nominalandmaxagree, and checklimit.
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.