Map Editor
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
- Header (top of the left pane): the page name, the project name (a dot when it has unsaved changes) and the "?" help button.
- Go to (
map-goto): typex,zcoordinates or a place name of the open terrain (Tisy,Chernogorsk,AF Vybor), then Enter or Go. - Terrain (
map-world): the worlds found in the game data, byCfgWorldsclass:ChernarusPlus(Chernarus),Enoch(Livonia). Reload loads the chosen one again. - Camera bar (
map-camera): Top (pan only), Orbit (default) and Eye (fly with WASD) modes, Frame (centre the selection, key F), Shortcuts (lists the mouse and keyboard controls). - View options (
map-options): Follow Claude (map-follow), Show hidden (a red box around each hidden map object), trees, rocks, sea, Underground (see-through terrain), shadows, gizmo snapping (grid step, angle step, Snap edges, Follow slope) and the radius in which map objects are drawn. - Catalog (
map-catalog): every spawnable class with a model, filtered by kind (structures, statics, items, vehicles, AI). Click a class, then click the terrain. - Selection (
map-selection): for a piece, its position, yaw / pitch / roll, scale, layer, group and note, with Duplicate, Snap to ground and Delete. For a map object, its model, class and position, with Hide object and Make editable. For a Central Economy zone, its radius or angle. - Layers (
map-layers): each layer with a visibility box, a lock, its piece count and a remove button; the number of hidden map objects; a field to add a layer; place into, the layer new pieces go to. - Outliner (
map-outliner): the pieces of the project (filter by class, id, group or note; click to select and frame, Ctrl+click to add) and the hidden map objects. - Project (
map-project): New, Open… (a project, or an import), Undo, Redo, Check, Save, Save as, Loot → mission, Build mod…, the export row (map-export) and the issues found by Check (click one to go to its piece). - Templates (
map-templates, closed at first): save the selected pieces under a name, place a template again anywhere. A sample checkpoint is listed. - CE zones (
map-zones, closed at first): which mission's zones are drawn, which kinds, the event filter, undo of zone edits. - Live link (
map-live, closed at first): push the project to a running local server and read its telemetry. - Viewport (
map-viewport): the terrain. The line at the bottom gives the nearest place, X, Z and the terrain height under the pointer, the object and piece counts and the frame rate. The minimap in the corner jumps to where you click. The legend at the top right names the zone colours. Central Economy zones are round dots (events plain, player spawns with a white centre, contaminated areas as a ring with their radius shaded on the ground); hover one to read its name and group. Seen from far, nearby dots merge into a larger one (the tooltip says how many more it holds): click it to come closer.
First steps
- Open the page. Chernarus loads (a few seconds the first time; the overview image is built once and cached).
- Type
Tisyin the go-to field and press Enter. - In Catalog, type
tent, clickLand_Mil_Tent_Big1_1, then click the terrain. The piece is placed and selected. - Press E and drag the ring to turn it, W to move it again. Type exact values in Selection.
- In Project, click Save and choose a file name: the project is written as
<name>.dzmap.json. - Click Check, fix what it lists, then choose a format and click Export.
Take the tour (in the app)
Common tasks
Move around
- Orbit mode: left drag pans, right drag orbits, the wheel zooms.
- Eye mode: W A S D move, Q / E go down / up, right drag looks, the wheel sets the speed, Shift goes fast.
- Click the minimap or use the go-to field to cross the map.
Place, move and turn pieces
- Click a class in Catalog, click the terrain. Shift+click keeps placing, R turns the ghost by 15 degrees, Esc stops.
- Click a piece to select it; Shift+drag draws a selection box, Ctrl+click adds to the selection.
- W, E, R switch the gizmo to move, rotate, scale. Set a grid or an angle step under Snap.
- 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
- Zoom in and click the building: Selection shows its model and class.
- 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.
- 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
- Untick the layers you do not want: an export takes the visible layers only.
- Pick the format in the export row and click Export. Warnings (what the format cannot carry) go to the log.
.dze: the JSON file format of the DayZ Editor mod (unbinarized save). Keeps the hidden objects.objectSpawnersArr .json: put the file in the mission folder and list it underobjectSpawnersArrincfggameplay.json. No hidden objects;.p3dpaths only underDZ\plants*andDZ\rocks*.init.c script: paste the generated functions in the mission'sinit.cand callBeansSpawn_<name>();frommain()on the server. No hidden objects.Expansion .map: oneClass|x y z|yaw pitch rollline per piece. No scale, no hidden objects.- 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
- Place
Land_*buildings and save the project. - Click Loot → mission and choose the mission folder.
- The buildings are added to
mapgrouppos.xmlbetween marker comments; buildings without a loot group are listed in the log. The previous file is backed up.
Save a composition as a template
- Select the pieces, open Templates, type a name, click Save n.
- Later, click the template, then the terrain. R turns it before you click. Each piece follows the ground where it lands.
Examples
- Chernarus, the whole map (in the app): the vanilla terrain from above. Pan, orbit and zoom until the buildings appear; nothing is written.
- The north-west airfield (in the app): goes to
AF Vybor. Click a hangar to read its class in Selection; the coloured dots are Central Economy zones. - Livonia (in the app): the second vanilla terrain, class
Enoch. - A sample checkpoint (in the app): seven vanilla pieces dropped in a field near Novy Sobor, in an empty project. Move them, change their layer, run Check and try each export. In a project that already has content, the sample is placed where you click.
Concepts
- Terrain (world): a map of the game, declared as a class of
CfgWorldsand stored as a binarized.wrpfile (heights, every object with its position, roads). The class name (ChernarusPlus,Enoch) is what a project and a mission folder (dayzOffline.chernarusplus) refer to. - Map project (
*.dzmap.json): the file this page saves. JSON with the world, the layers, the pieces (class or.p3dpath, position, yaw / pitch / roll, scale, layer, group, note) and the hidden map objects. It is the working file, not something the game reads: you export from it. Opening one from the file manager, a recent file or the Script Editor opens it on this page. - Piece and map object: a piece is something you add; it is spawned by the server. A map object is part of the terrain file: it cannot be moved, only hidden, and hiding must also happen on every client, which is why only
.dzeand the built mod carry it. - Layer: a named set of pieces. Hidden layers are left out of the view and of the exports; pieces on a locked layer cannot be changed.
- Coordinates and heights: x grows to the east, z to the north, in metres from the south-west corner. y is the height above sea level (ASL), not above the ground: a piece moved sideways on a slope keeps its y and may end up buried or floating. Snap to ground sets y to the terrain height; Follow slope also tilts the piece.
- Yaw, pitch, roll: yaw is the compass heading in degrees (0 north, 90 east), as
vector.AnglesToVectorin the engine. - Central Economy zones: files of a mission that say where things happen: event spawns (
cfgeventspawns.xml), player spawn points (cfgplayerspawnpoints.xml), contaminated areas (cfgeffectarea.json), AI territories (env/*.xml). See Central Economy. - Loot positions: the Central Economy only spawns loot in buildings listed in the mission's
mapgrouppos.xml, whose class has a group inmapgroupproto.xml. A building you place has no loot until it is added there. - Reference: the Bohemia Interactive community wiki for the Central Economy files; the
cfggameplay.jsondocumentation of the same wiki forobjectSpawnersArr.
Pitfalls
- Hidden objects missing in game: the spawner file,
init.cand the Expansion.mapcannot remove map objects. Use.dzeor Build mod…, and load the mod on the clients too. - Pieces of a hidden layer are not exported: tick the layer before exporting.
- Zone edits are written at once: with a mission chosen in CE zones, moving a dot writes the mission file (a backup is made the first time, and the panel has its own undo). Without a mission, the vanilla zones are shown read-only.
- A piece under the ground after a move: y is absolute. Use Snap to ground, or tick Follow slope before moving.
- Nothing to click when zoomed out: map objects are drawn only near the view centre (the Objects radius) and not at all from very far.
- New loot positions ignored: the server needs a fresh Central Economy storage to pick up a changed
mapgrouppos.xml. - Tilted pieces: check pitch and roll in game before relying on them.
- Two editors on one project: when the file changes on disk while you have unsaved edits, the page asks before it reloads; it never drops your edits silently.
- Open… (or a
.dzmap.jsonopened from elsewhere) with unsaved pieces warns first, as New does; the same action again within 10 seconds replaces the project.
For agents
Tools of dzt (the same files as the page, no window needed):
map_worlds,map_info,map_places,map_objects,map_height: read a terrain (worlds, summary, place names, objects in an area with their ids, terrain height in ASL).map_project: open or create a*.dzmap.json; also reports what the page has open and selected.map_edit: apply operations (add,move,rotate,align,scale,set,delete,duplicate,hide,unhide,layer_add,layer_remove,layer_set,camera,clear) and save. Withx,zonly, a piece sits on the terrain;posy is ASL.map_check,map_export,map_import: the Check button, the export row, the imports of Open….map_template_save,map_templates,map_template_place: templates.map_loot,map_build_mod: Loot → mission and Build mod….map_zones,map_zone_edit: Central Economy zones of a mission.map_zone_editmoves, resizes, turns and deletes zones, adds event spawn positions (direction -1, random, unless given), player spawn positions, and contaminated areas (add_effect_area: a copy of an existing area with a new name, position and radius).map_open,map_screenshot: show a project, a world or a place in the page, and get a PNG of the viewport. Both need Follow Claude ticked;map_screenshotneeds the page open.live_servers,live_status,live_push,live_install_mod: the Live link panel.docs_page(this text) andstudio_guide(point at the anchors named above, startmap.firstormap.hide).
Files:
- Reads: the terrain
.wrp,CfgWorlds, satellite tiles and models from the game data (read-only); the mission's zone files when a mission is chosen. - Writes: the project
*.dzmap.json; exports where you choose; templates in<settings>/map-templates/<name>.json; the mission's zone files andmapgrouppos.xml(with backups in.beans-ce-backups/);@BeansMap_<name>and@BeansMapLinkwhere you choose;<profiles>/BeansMapLink/live.jsonon a push. - The link with agents: the tools write
map-link-claude.jsonin the settings folder (project to open, where to look, pieces to select); with Follow Claude ticked the page follows it within a second. The page writesmap-link-studio.json(open project, world, camera, selection), so "the selected pieces" means the same to both. A change made by a tool to the open project is one undo step in the page.
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
- Central Economy: the mission files behind the zones and the loot.
- Launcher: start a local server to test an export or the Live link.
- Signing and Workshop: sign and publish a built map mod.
- Models: look at a model before placing its class.
- Beans Assistant: ask it to build or check a map edit; it uses the tools above.
- The Workbench