From Mod Wiki

EditWorld is the game's built-in map editor. It is accessed by typing editWorld in the console.

The Basics

For the basics of using EditWorld, look at How do I... ?

Using References

References are a great way of speeding up map development and working "off the grid".

Right click in the XY window and select New Reference from the menu. Pick the .world that you want to reference, and hit OK. There will be a pause while preview geometry is created and the world is loaded. After that finishes you'll have a model representing the world.

  • Press ctrlr,ctrlr to reload a reference.
  • Press ctrlr,ctrlo to open the currently selected reference.

You can move it around, rotate, etc and it will appear where you place it when the world is compiled. You can also see it in render mode.

When making a reference out of an existing map you'll generally want to move everything to the origin. Don't forget to recenter/update the origins for entities with brush/patch geometry or you might get leaks. The default shortcut for this is ShiftO.

Converting an existing .map file to the new format

  • Start editWorld
  • Choose File -> Import .map -> Choose a ".map"'.
  • Save the map.
  • Compile the map from the Compile menu using Normal Compile.

Editing at angles

If you have rotated a brush and want to know its rotation, select the brush and look at the transformation editor. You can copy the "yaw" value (the middle of the three values on the bottom row) as the "movedir" key for things such as func_doors.

To Compile

  • compile <mapname> at the console will do a full compile routine.
    • Note: It isn't really recommended to do a full compile from within editWorld if you have a very large map open, as you could run out of memory.
  • compile -onlyents <mapname> should be used if you only want to regenerate the .entities file (eg. if you only changed a key-value pair and not geometry).
    • Note: This will only regenerate the .entities file, and leave the .proc and .cm alone.
  • noimagecompile <mapname> should be used from the console to compile the map without loading images, to save memory.
    • Note: If you use this, you will need to completely restart ETQW before you can test your map, as if you try and run the map straight after the compile finishes, it will have no images loaded.


You'll notice a few files sitting around your /maps/ folder before and after you've compiled. They are:

  • mapname.world – this is the equivalent to a .map file. It contains everything you'd expect: entities, geometry, etc.
  • mapname.proc – the processed geometry.
  • mapname.procb – the processed geometry in binary form.
  • mapname.cm – the collision data for the map.
  • mapname.cmb – the collision data for the map in binary form.
  • mapname.entities – this is what the game actually loads. It's basically a stripped-down version of the .world file that holds only entity key-value pairs, plus additional keys that editWorld injects while it's compiling. You should never edit this file manually, since it's thrown away each time you compile and any changes will never make it back into the .world file.