Mapping Tutorial

Mapping - Part I: The Map Editor

This tutorial will show you how to create your own CS2D Maps! First we have to start the map editor:

This might be a bit overwhelming at first glance but you will learn to use it very quickly!

Cursor / Highlighted Tile

The green crosshair is your mouse cursor. You can use it to click buttons or to select/set/edit tiles and entities. It will always highlight a tile when you move it over the map area with the grid. A tile is a square with a size of 32x32 pixels. Each map consists of a lot of tiles (and some 'entities' which control the behavior etc.). You can also see the coordinates and the frame of the highlighted tile at the bottom of the screen. They start with 0|0 at the left top corner of the map.


The minimap shows your map and allows you to jump to each position by left clicking it. The yellow area marks the part of the map you see on the screen. You can close it with a checkbox in 'Display Settings'.

Please also note that the minimap will not display the actual tile colors. It just displays walls (white), obstacles (grey), deadly tiles (red) and water (blue). This helps you to keep an overview over the structur of your map.


The menu contains many buttons which are seperated in four groups. Each group has three buttons.

1) New/Load/Save: The first group (top left) contains buttons to create a new blank map, to load a map and to save it. I think it's obvious what you do with these.

2) Properties/Display/QuitThe second group (top right) contains map properties, display settings and quit. Quit can be used to close the editor of course. Map properties lets you change the size, the tileset and the background for your map. Display settings can be used to control what the editor displays. You can disable the shadows, the yellow grid or the minimap for example.

3) Tiles/Entities/Tools: The third group (bottom left) is used to switch between tile editing, entity editing and tools. The list below changes when you click one of these buttons.

4) Pen/Rect/Fill: The last group (bottom right) contains the tile editing tools. You can either set tile by tile with the pen tool, set a rectangle of tiles with the rectangle tool or fill a complete area with the fill tool. All these tools basically work like in standard painting programs but you are drawing tiles in a map and not pixels in an image.

Tiles / Entities / Tools

This list can be used to select a tile. Hint: An alternative way to select a tile is to rightclick a tile on the map! You can also change the properties of a tile with the 'Tile Properties'-button.

The tiles which are displayed here are part of the maps tileset. A tileset is a simple image file which contains up to 256 squares. Each square has a size of 32x32 pixels and forms a tile. You can use every program which can save images (bmp,png or jpg) to create your own tileset! The tilesets are saved in 'gfx/tiles' in your CS2D directory and you can select one in 'Map Properties' or 'New Map'!

New tiles you set will also be affected by the 3 little fields at the bottom of the tile properties section. The first one affects the rotation. The second one the brightness and the third one the color. Note that you could also change the brightness by simply choosing a grayscale color. Your map file however will be a bit smaller when using the brightness setting with white as color because the brightness is saved in an optimized way whereas each tile with a custom color will require 3 additional bytes.

At this place you can also see a list of entities or a list of tools - depending on your current editing mode.

That's it! These are the basic parts of the editor!
Continue with part II where we will create our first map!