modding:chaosedit:maps

How do I edit maps in ChaosEdit?

This guide will take you through the tools available to the ChaosEdit map editor.

Some elements of this guide assumes you have a fresh project based on the full version of Wolfenstein 3D. If not, get started by clicking here.

At the top of the ChaosEdit window is a series of tabs, which let you navigate to each section of the Editor.


For basic map editing, we will be using the first five tabs; MapEdit, 3DEdit, Walls, Objects, and Floors.

Open ChaosEdit and load your project by clicking the Load All button and navigating to your project files.

This is the main tab you will use when editing maps.

Click on the MapEdit tab to ensure you are in the correct section of the editor, and your window will look similar to the following.

  • Map Navigation Buttons - These three buttons let you switch between maps in your project. The left and right buttons will take you to the previous and next maps respectively, and the middle button will let you type a map number and instantly open it.
  • Paint Tools - This set of five tools lets you directly edit the map. These tools are pretty much identical to the tools you would see in a paint program.
    1. Pen Tool - This tool lets you paint on the map, one tile at a time.
    2. Select Object - When this tool is selected, any object on a tile you click on is added to the active items to be painted with the other tools.
    3. Fill - This tool will fill a selected area with whatever is selected from the tile menu. The fill won't penetrate walls, doors, or items with different tile values on the same plane, making it perfect for quickly applying floor codes or huge blocks of wall.
    4. Rectangle - This lets you draw a rectangle that will fill the entire designated space with the selected tile.
    5. Rectangle Selection - The select tool lets you highlight a rectangle on the map that you can cut/copy/paste. Useful if you want to duplicate or move a section of map.
  • Plane switches - These three buttons switch between what you edit on the map, between Walls, Objects and Floors. Whatever is active will be what is drawn on the map.
  • Additional Plane switches - These two buttons are greyed out, but if you're creating a mod that utilizes the third plane or want to split planes to edit separate floor and ceiling textures, you can toggle it using one of the options in section 3.
  • Cut/Copy/Paste - These tools work like their counterparts in other programs. When you use the Selection Rectangle Tool to select a portion of the map, these tools will be enabled.
  • Symbol Box - Brings up a small additional window with the items you can place on the map, for quick selection when editing.
  • Additional Map Tools - These tools allow you to export or import singular map files, clear the map to start fresh, and automatically fill in floor codes.

Here you will see a tile based overhead view of the current map to be edited. Using the above tools, you can navigate and edit your game.

This column contains details and toggles for your map. From top to bottom you have:

  • The map name.
  • The map being edited, and the total maps in your game.
  • Toggles to display or hide elements while editing the map.
  • A box to edit the map's name.
  • Toggles for extra modding features, including having a 3rd plane and editing split planes, as well as “Feature flags”, which are another moddable feature present in Wolf4SDL. These require modifications to the source code.
  • The Add Map and Delete Map buttons do just as they say, and will add a map immediately after the currently showing map and delete a map from the file, respectively.
  • Tile Number is a complete mystery to me.
  • Two black boxes I don't understand either.
  • A button to enter 3DEdit.

When you mouse over tiles on the map, this section will display the map coordinates, as well as what content is present in the tile.

These boxes show the wall, object and floor items active to draw onto the map, selected via either the Symbolbox or their respective tabs in ChaosEdit.

Sections 4 and 5 are persistant across almost all tabs, as each of the 5 tabs detailed on this page make use of them.

To access 3DEdit, click on the appropriate tab at the top of ChaosEdit.

This section of ChaosEdit has been one of the more unique among Wolf3D Editors; the ability to edit maps from the player's perspective.

  • Map Navigation Buttons - These three buttons let you switch between maps in your project. The left and right buttons will take you to the previous and next maps respectively, and the middle button will let you type a map number and instantly open it.
  • Difficulty Switches - These let you switch between difficulties, seeing enemies that the player would see while playing at the same difficulty.
  • Plane switches - These three buttons switch between what you edit on the map, between Walls, Objects and Floors.
  • Floor and Ceiling Switches - Five buttons that change the visual display in the 3DEdit, in order to better edit different elements of the map. These buttons toggle between showing floor and ceiling textures and split plane displays.


    The fifth button toggles separately to the first four, and will display the tile icon for the floor code of the room.


The main window of 3DEdit, this will display your map as if the game were running. Mousing over any tiles visible in this window will highlight them red, indicating they can be edited.

Instructions for how to navigate the 3DEdit window, and buttons that will bring up windows to select items to place into the map.


A minimap displaying the current area in 3DEdit. You can click and drag on this to move around the map quickly.

  • Clip moves - If turned on, walls cannot be walked through when navigating the map.
  • Lock door editing/pushwall editing - If turned on, these buttons disable the ability to edit doors or pushwalls beyond texture changes.
  • Hide direction marks - If turned on, it will disable the visual symbol for patrol markers in 3DEdit.

The Walls, Objects and Floors tabs are very simple; each contains a list of items to be selected. Doing so will select them to be drawn on the map in either MapEdit or 3DEdit. Both the left and right mouse buttons can be assigned a tile value of each sort.

You may notice entries in the above screenshot that don't match your own; ChaosEdit allows you to add new definitions or rename old ones, for mods that implement these sorts of game changes.

Now that you know the main tools on offer, it's time to use them! For this, we'll be adding a guard to the map and change some wall tiles.

This will get you to:

  • Select items from different tabs to draw onto the map
  • Use the fill and pen tools
  • Use 3DEdit to navigate a map and add an object.
  • Save an edited map
  1. Go to the Objects tab.
  2. Select an enemy or item from the list (We'll be scrolling right a little and choosing a Standing Guard) with either left or right click. One of the boxes on the far right will now show the selected object.


  3. Go to the Walls tab.
  4. Select a wall from the list available (We'll be choosing Brown Stone 1) with either left or right click. One of the boxes on the far right will now show the texture for the selected wall.


  5. Now, go back to the MapEdit tab. We're going to change some of the walls in the first map of Wolfenstein 3D.
  6. Click on the Fill Tool.
  7. Make sure that the Edit Walls switch is active.
  8. On the map, move the mouse to the tiles you want to change. We're going to change the wooden hallway.


  9. Click on the tile with the same button you used to select your wall tile earlier. That tile and all adjacent tiles of the same sort will be changed to Brown Stone 1 (Or whatever you chose). Click a couple more unchanged tiles to transform them as well.


    • You could also use the Pen Tool to change the walls, but you will need to draw over each tile individually.
  10. Now, we're going to add the Guard using 3DEdit. Click on the 3DEdit tab at the top of the window.
  11. While this is the active tab, you can use the arrow keys to navigate the map, or click and drag on the minimap at the bottom of the window. We're going to move to what used to be the wooden hallway.


    As you can see from the 3DEdit preview, the walls were successfully changed (Though not all of them; the Fill Tool will only change tiles with the exact same value as the selected tile).
  12. Make sure the Edit Objects switch is selected.
  13. When you bring the mouse over the 3DEdit main window, you'll see a red square appear on whatever tile is hovered over, to show what tile will be changed.
  14. When you've found a tile to place the object or enemy on, click the tile with the same button you selected it with back in step 2. The object should appear on the screen.


  15. To save your changes, you can either click on the Save Maps or Save All Changes button.
  16. Now if you run your new map, you should see the changes you've made!
  • modding/chaosedit/maps.txt
  • Last modified: 2020/03/25 22:46
  • by zombie