Map Editor

Tutorial · 3:01

The Map Editor shows a DayZ terrain in 3D (satellite image, relief, every building, tree and rock of the map) and lets you change what a server puts on it: you place pieces (buildings, props, vehicles, any spawnable class), you hide objects that ship with the terrain, and you export the result as a file a server reads or as a small mod. You use it to build a base, a checkpoint, a trader zone or a custom area without starting the game. You need the DayZ folder set in Settings: the terrains, the models and the class list are read from it, and never modified.

The page is marked Preview in the rail. What works and is covered by the tests of the repository: the 3D view, editing a project, the checks, the four exports and their imports, the templates, the Central Economy zone editing. What has not been verified in a running game: the direction of pitch and roll on tilted pieces, and the Live link mod (@BeansMapLink), which passes the script checker but has not run on a live server yet. Test an export on a local server before you publish it.

The screen

First steps

  1. Open the page. Chernarus loads (a few seconds the first time; the overview image is built once and cached).
  2. Type Tisy in the go-to field and press Enter.
  3. In Catalog, type tent, click Land_Mil_Tent_Big1_1, then click the terrain. The piece is placed and selected.
  4. Press E and drag the ring to turn it, W to move it again. Type exact values in Selection.
  5. In Project, click Save and choose a file name: the project is written as <name>.dzmap.json.
  6. Click Check, fix what it lists, then choose a format and click Export.

Take the tour (in the app)

Common tasks

Move around

  1. Orbit mode: left drag pans, right drag orbits, the wheel zooms.
  2. Eye mode: W A S D move, Q / E go down / up, right drag looks, the wheel sets the speed, Shift goes fast.
  3. Click the minimap or use the go-to field to cross the map.

Place, move and turn pieces

  1. Click a class in Catalog, click the terrain. Shift+click keeps placing, R turns the ghost by 15 degrees, Esc stops.
  2. Click a piece to select it; Shift+drag draws a selection box, Ctrl+click adds to the selection.
  3. W, E, R switch the gizmo to move, rotate, scale. Set a grid or an angle step under Snap.
  4. Ctrl+D duplicates, Ctrl+C / Ctrl+V copy and paste at the view centre, Del deletes, Ctrl+Z / Ctrl+Y undo and redo.

Replace a building of the map

  1. Zoom in and click the building: Selection shows its model and class.
  2. Hide object (key H) removes it in this project. Make editable hides it and places a piece of the same class at the same position.
  3. Hidden objects are listed in Outliner; the cross brings one back, Unhide all brings back all of them.

Tour: replace a building (in the app)

Export for a server

  1. Untick the layers you do not want: an export takes the visible layers only.
  2. Pick the format in the export row and click Export. Warnings (what the format cannot carry) go to the log.
  3. .dze: the JSON file format of the DayZ Editor mod (unbinarized save). Keeps the hidden objects.
  4. objectSpawnersArr .json: put the file in the mission folder and list it under objectSpawnersArr in cfggameplay.json. No hidden objects; .p3d paths only under DZ\plants* and DZ\rocks*.
  5. init.c script: paste the generated functions in the mission's init.c and call BeansSpawn_<name>(); from main() on the server. No hidden objects.
  6. Expansion .map: one Class|x y z|yaw pitch roll line per piece. No scale, no hidden objects.
  7. Build mod… writes @BeansMap_<name>: the server spawns the pieces at mission start, server and clients hide the hidden objects. It is signed with the private key of Settings when one is set.

Give loot to placed buildings

  1. Place Land_* buildings and save the project.
  2. Click Loot → mission and choose the mission folder.
  3. The buildings are added to mapgrouppos.xml between marker comments; buildings without a loot group are listed in the log. The previous file is backed up.

Save a composition as a template

  1. Select the pieces, open Templates, type a name, click Save n.
  2. Later, click the template, then the terrain. R turns it before you click. Each piece follows the ground where it lands.

Examples

Concepts

Pitfalls

For agents

Tools of dzt (the same files as the page, no window needed):

Files:

What the page tells the assistant (its snapshot): the world, the project file, the mission chosen for the zones, what is selected (count of pieces, or the zone, or the model of the selected map object), whether there are unsaved changes, and the issues of the last Check.

Example payloads the page accepts from its help panel (req:): world:<class>, goto:<class>/<place or x,z>, template:checkpoint.

See also