Mapping ABC

Guides about mapping and everything Teeworlds related.

Posts: 1085
Joined: Mon May 05, 2014 7:30 pm
Player profile:
Mapper profile:
Clan: Eagle

Mapping ABC

Post by Index »

Mapping ABC
written by Index
Official Tutorial List (viewtopic.php?f=35&t=2420)
Mapping in general and especially making a good ddrace map is definitely not easy. It needs a lot of practise and you may not succeed at the first attempt. But don't be disappointed. I could barely place some tiles about a year ago and now I write this. So it’s all about not giving up and constantly trying. Eventually you'll get better and maybe we see your map here one day :3

The following guide covers the teeworlds editor and some general advice about mapping.


You should use the offical ddnet client ( for mapping! It’s easier to acess all the additional features and you already have the right entities. However you don’t have to use it, the normal ddrace client or a similiar one should work as well. Just note, that you probably have to manually add the right entites files then.

If you don’t know the ddrace entites, take a look at the Great Entities Guide (viewtopic.php?f=16&t=1440).


Layers and Quads are the base of your map. WIth Quad-Layers you can add scaleable images. Tile-Layers are mostly for tilesets, so it's like placing selected parts of a bigger image on your map. You can transform any image and tileset into a quad. Just create a new quad layer, right-click select the image.

You can create soo many different things with the right tilesets. But alwas remember the overall graphic style of teeworlds. There might be exceptions, but I don’t feel like hyper-realistic tilesets are good.
Realism Tilesets vs TeeworldsShow
This was a response by me (Index) to some ideas posted a few months ago..
Realistic tilesets, yeah those are really rare in teeworlds. As far as I can remember I've never seen such an overly detailed map. But I think that's not only because it's really time-consuming and fps-killing but also because this realistic style doesn't fit to the overall graphic style of teeworlds. In my opinion tw is a simple 2d game with schematic tilesets and maybe some nice envelopes. I mean, even the skins are mostly just simple graphics without photorealistic elements. So all in all, I would play a map with so many details but I don't think that there should be more than one or two maps with such high detailed tilesets.
Next thing are 3d tilesets. Hmm, I know what you mean and I can imagine a map with that feature, but again it's really time-consuming and as you already said only a few players can really play the map, for all the others without the possibility to view the 3d effects with a special glass it would be just annyoing (imo). So yeah, nice idea as well but also not a great thing to do.
Ok, so last thing is the moving tileset. I think that's the best idea and the fact that there are already quite a few maps that have those 'animations' shows that this is doable and also playable for most of the players (If the framerate should drop for someone, he can easily disable HD and play with just one visible layer for example). So, I quickly played the map AntNest and I have to say that I love it. It's so good and although it's a really simple map concerning the gameplay I enjoyed walking around. I don't really how the effects there were archieved (didn't have time to view the map in editor) but I think that there should be definitely some maps with those 'animations' in the future. About the other two examples (Saavik's Move and your walk-test): Well, Saaviks map is quite nice and if that idea is converted into a nice map with more layers and details then it should be as good as AntNest. So that's the right way. But to be honest, I don't know what you did with walk_test (again, I didn't view the map in editor yet) but that's kinda weird, it seems like you move like ten times faster and jump super high without any tunes :o I mean, wtf. I'll deifintely take a look at this map later in the editor, because somehow that's completely mindblowing. There are so many stunning things you can achieve with just tilesets. It's amazing and I'm looking forward to see some of the ideas in a real map and maybe some other ideas as well in the future.
How to cut a quadShow
You can select one red square and press shift. While dragging your mouse the image will now zoom in. With that you can easily select specific parts of an tileset or image. Here are some screenshots for that.
screenshot_2015-03-16_13-23-13.png (323.29 KiB) Viewed 25683 times
Add the quad
screenshot_2015-03-16_13-27-35.png (305.23 KiB) Viewed 25683 times
Klick (mousebutton + Shift) on any red point and you can zoom into the quad
screenshot_2015-03-16_13-29-11.png (302.38 KiB) Viewed 25683 times
If you klick on two red points + shift then you can transform the lenght or height of the quad
screenshot_2015-03-16_13-29-17.png (302.37 KiB) Viewed 25683 times
If you take the two diagonal red points + Shift you can choose the right position to zoom in.
You can do this with almost any tileset and/or image. So for example, you want to have any ingame emote (hearts, zzZ etc) as an ingame quad: Just copy the emoticons.png (teeworlds/data) to your mapres folder, add the image to your map and follow the steps above.

This layers is mostly used for switches like doors or (moving) lasers. Nevertheless you can also use it for time-based freeze and many other different things. The number of the switch allows you to combine multiple tiles with each other. It’s basically the same as teleporter numbers. The delay value always indicates the duration in seconds (or the amount of things, if you use the ddnet exclusive 'jumps' feature for example).
You can also activate and deactivate other things like weapons and deepfreeze with it.

As a often used example you can create freeze with x seconds duration via the switch layer (x=delay)

With the speedup layer you can create a speed arrow. The force value indicates the strenght, numbers >20 are usually not necessary and you should prevent them. With the max speed value you can limit the maximum amount of speed a tee can potentially get. That’s useful if you placed a few arrows next to each other and the tee would get an insane amount of speed if he passes all of them.
Arows always point to the right (>>), that’s the basic direction and you need to change the angle value for another direction. The arrow will spin clock-wise by the amount/degrees (°) you choosed. So for instance, if you want a left pointed arrow (<<) you have to enter 180 (the original arrow spinned by 180°), maximum value for that is obviously 359.

That feature allows you to play sound files in your map. Basically they are handled like images, you can embded them and then link with the sound layer. That function is ddnet exclusive and you’ll need the official ddnet client to use and hear the sounds ingame.
Detailed Tutorial by DoNe

This layer applies certain zones in your map, where the physics of the game or other basic behavements can be altered. The changes are written in a .cfg map. The feature is ddnet exclusive and you need the official ddnet client to use tune zones in your map but not for playing a map with tune zones.
Detailed Tutorial by Index, based on a version by Maple
All tuning commads by deen,


Clipping is used to only display a layer or quad in a certain area of the map. You can enable it by right-clicking a layer and then select Use Clipping>Yes. Now change the ClipW (Width) and ClipH (Height) values and you’ll see a red square in the left upper corner. That’s the area where your layer content will be visible. Alter the position of the new square with the ClipX (horizontal) and ClipY (vertical) values.

This function shows you the area that is visible ingame.

Resolution doesn't matter, aspect ratio does. You have 16:10 (1680x1050, 1920x1200). Other common aspect ratios are 16:9 (1280x720, 1920x1080), 4:3 (1024x768, 1600x1200) and 5:4 (1280x1024). Your map should work with all of them.

The red proof rectangle shows you what a player with 5:4 aspect ratio will see. The green rectangle is 16:10, that should be your resolution. The white shape around is the maximum a player can see regardless of resolution. 16:9 is the widest resolution that lets you see further in Teeworlds, so anything higher than that, and your top is just cut off instead. In the other extreme you have to consider totally square resolution.
[email protected] (196.69 KiB) Viewed 25683 times
This divides the working space into small squares, you may know that function from any image editing program. It allows you to seamlessly connect different quads, like jungle_background or desert_mountain.

Envelopes can be used for many things. Basically there are two different kind of envelopes (three with ddnet client): Position, Color (and Sound).
With the Position Envelopes you can create basic movements along the X and/or Y axis including rotations.
The Color Envelopes can be used to create a color sequences or just one color that appears and disappears again using the alpha curve (opacity). Even the sunrays of a sun are created using these color envelopes.
The Sound Envelopes are used to play custom sound files.
Detailed Envelopes Tutorial by TheDerero


Almost all ddrace maps use teleporters. They are an essential part of many maps.
Basically you have two different kind of teleporters: checkpoint tele (cp) and normal tele. Both in a red and blue version.
You place a FROM teleporter with any number (e.g. 1, chosen in the top toolbar of the editor while tele layer is selected) of any color somewhere. Then you place a yellow TO teleporter with the same number somewhere and it should teleport you there now.

Here are a few tips on how to place teleporters in your map.
Normally you should always use red teles except:
1) It is required to hook your partner even after a tele (eg dummydrag parts)
2) It is required to get speed for a jump

Red teles stop any movement and cut your hook.
Blue teles do not stop your movement and do not cut your hook.

Do not use checkpoint teleporters (cp tele) if it is not necessary.
You might create some unwanted cheats with them, it’s harder to go back and your mapping structure is more complicated. Nevertheless there are exceptions, a few mappers managed to use cp teles wisely and created unique maps like PurpleViolence by Vasten100 or Lawrence by Themix.

You should consider adding unfreeze at almost all TO-tele tiles. It increases the playability and you don’t have to wait for hours.

You should always avoid too many teleporters if it's not needed. Countless tele tiles may cause lags for people with lower GPUs with enabled entties.


You can download custom tilesets ([url]http:s//[/url]). Or just create your own tileset. The ressources for that are widely aviable (viewtopic.php?f=35&t=2431)

Always think about tileset management.
You don’t want use 5252 different tilesets. Often you can use the same tileset for many things, like freeze and marked areas. There are also many pre-made tilesets and quite a few of them includes freeze and/or alphabets. So you do not have to use one tileset for freeze, one for unfreeze and one for your text. Always try to keep the amount of embded images as low as you can. Best example for a really good tileset management is ddnet-tiles. It includes freeze tiles, which you can use for all kind of marked areas including freeze, unfreeze, tune zones and so on. Furthermore it comes with game tile markers, a finish line, arrows and even numbers for small hint messages. So you only need this one tileset for almost all layers of your map. This will greatly reduce your file size and the map is better organized.

Don't forget to embded your custom tileset, otherwise it's not visible ingame!
screenshot_2014-08-03_16-07-31.png (126.48 KiB) Viewed 25682 times
Automapper is a help for all the lazy mappers out there, it helps you place the tiles in your map. Just use it with an already made .rule file for a popular (standard) tileset or create your own rules and use automapper with any image you want.
It's hard at the beginning, but especially if you want to create many maps, it's the right tool for you.
Automapper tutorial by DoNe,
Set up own automapper rules by jxsl13,

There are certain tools, that can improve the quality of your used tilesets and quads. Furthermore it fixes minor bugs with transparancy.
Detailed Explanation
Download (‘Other Downloads’ Section)


You can create a basic ddrace map (viewtopic.php?f=35&t=2426), but there are some special types of maps. Read on for a short list of the most popular ones with a short explanation. See also the topic about config lines (viewtopic.php?f=35&t=2430) to change some settings and prepare your maps for special types.

You may have seen maps like TakeUrLugage by Tuna & Index or Skychase by SickCunt. These are basically solo maps, only one tee can finish it but you’ll need a ‘dummy’ to reach the finish.
How to deepfreezeShow
screenshot_2015-01-17_19-15-07.png (652.63 KiB) Viewed 25683 times
screenshot_2015-01-07_16-06-13.png (401.86 KiB) Viewed 25683 times
These maps mostly use the ddrace features but you can play and finish them alone. They should be not too short (<1:00 min) and the main weapon is not always the grenade launcher. These characteristics are not that strict, but they are the main differences to most race maps, another modification for teeworlds.

If you create a solo map you don’t need to add the solo on/off game tiles, most solo servers (including ddnet) are already configured right.

Sometimes it’s nice to combine two or more maps, doing that is easy. Open a map, use File>Append and select another map that you want to add.
You cannot append the game group. That means, all the layers of this group won’t be added to the other map. However, all other groups, layers, images, sounds and envelopes are copied to the other map.


Don't get me wrong, all maps are kinda nice. But there are always a few oustanding ones. Maps, that have something totally unique or used all the editor possibilities in a really good way. I want to mention Flappy Bird by Saavik, SpaceIsKey by Kintaro* & Delo and HDP_OnOff by El Futuro.
These are only examples. The shown maps impressed ME. Just play through the varitey ddnet offers you and find your favourites (:

You can also take a look at the Showroom (viewforum.php?f=44)


That's it, I hope it helped you to BE A BETTER MAPPER.
The thread may be updated and expanded in the future, so its all under construction.
Totally re-structured on 30/11/15.

Who is online

Users browsing this forum: No registered users and 0 guests