Leveleditor documentation (TO BE REWRITTEN)


We, from FreedroidRPG, provide you a nice level editor, so you can have fun expanding the game, and, of course, if you've made something cool, you can send it to us and we will possibly implement it in newer versions.

The following text should be also found inside the game with some differences. Our objective in this documentation is to make easier and simple the map-making and allow you to create the greatest range possible of maps, well-made and fast.

You can always ask on our IRC channel if you have any other doubts. We hope that this text is useful. Providing an useful text is a priority, if this text can be improved, please let us know, so us can provide the most useful text to everyone.

Good reading!



FreedroidRPG comes with a built-in level editor. This level editor allows you to control any aspect of a normal FreedroidRPG map and to save maps.

You can access it from the main menu (click "Level Editor") or executing 'freedroidRPG -e'. It can also be used in-game (Ctrl+Shit+e), but in that case you will not be able to save your changes.


To toggle descriptions of the interface while the mouse hovers, click the white speech bubble icon located near the right window border (lower button row).

To change the current level, click the nearby level number in the minimap at the lower right corner, or select the desired level from the editor menu (described later).

Map editing

There are four editing modes: Obstacle editing, Floor editing, Item editing, and Waypoint editing.

The button selected at the lower left indicates the objects you can select or place. When a button is selected, and you are in placement mode, the object you will place is indicated by the ribbon at the top of the screen. The selection in the ribbon is divided by tabs immediately underneath.

You can select the obstacle type you want to be placed on the map at the upper object selector. Just click it to select it. Obstacles are divided into groups to provide better overview.

Pressing space, you will enter the selection mode being indicated by the cursor changing. You can only select group of objects represented by the current activated object mode. Important note: You will only be able to select things that are included in the currently selected mode. If you are in obstacle mode, you won't be able to select items or floor tiles.

Selecting objects

  • Switching between "place" and "select" modes
    Press "Space"

  • Selecting an object

    • Push "Space" to switch to select mode.
    • Draw a rectangle around the object
  • Moving the object

    • Select the object
    • Press "Shift" + drag'n'drop it

Obstacle edit mode

In order to select this mode, click on button that says 'Obstacle' of the category selector on the left lower area. Having selected an obstacle, just click somewhere on the map to place it at the cursor's position.

Since clicking is a little imprecise, you can also use your numberpad to place obstacles. Click on the leftmost (it shows a small grid) of the five button above category selector to have a grid with numbers displayed. Use left click for switching the grid on and off and right click for changing the grid mode.
These numbers refer to the numbers of your numberpad if you have one.
Pressing '1' will place the obstacle that is highlighted in the object selector at the position of the digit '1' on the purple grid.

Since placing a line of walls that way is quite inefficient, you can simply hold down the left mouse button and a line of walls is placed as you move the cursor if you have a wall object selected. This works with the most common walls in FreedroidRPG.

While holding the left mouse button down and placing walls, a click with the right mouse button will remove all the walls you drew after starting to hold down the left mouse button.

There are some special objects. Glass walls and cracked brick walls, but also barrels and crates can be destroyed with a few strikes, while the latter two may also release items.

Chests can be opened and may contain items, too.

The symbol with the crossed out footsteps is not really an object but pure and invisible blocking area ('collision rectangle'). Collision rectangles are the very core of each object since they prevent you from just walking through them as it possible for waypoints or floor tiles.

Selecting obstacles

Holding down the left mouse button you can select a rectangle of obstacles. After releasing the mouse button, selected obstacles will turn a different color indicating that they are selected.

To select obstacles that are not in the range of such a selection rectangle, hold down 'Ctrl' and click the obstacle or select another rectangle of them.

You may have automatically selected several obstacles with one click. You can cycle between the obstacles clicking the icon with the chair and the shelf on it, or pressing 'n'.

The icon with the trash can delete the selected obstacle. You can also cut (Ctrl+x can also be used to delete obstacles by just not pasting them again), copy (Ctrl+c) and paste (Ctrl+v) cut or copied obstacles.

You can move selected obstacles holding down the left shift key while dragging the obstacle around. However, this may be quite imprecise.

Placing objects in Chests

Simply select the desired chest and click the most left button in the upper button row. You will be forwarded to a screen that looks like the shop screen.

There will be a knife displayed (which is actually not placed in the chest by the way) select it and click on the 'sell' button. Select the items you want to be dropped when the player opens the chest. These items will be displayed in the upper shop bar.

In order to remove one of these items, simply select it and click on 'buy'. The red cross gets you out of the screen.

Adding Text to a Sign

Select the sign and add an obstacle label with the sign text.

Save the map and exit. Open the level file (map/levels.dat) and find the new obstacle label. Change the line above the text from 'type=30' to 'type=32' and save.

Now when you click on the sign in the game your short message will appear.

Adding a Dialog to a Terminal

Select the terminal and add an obstacle label with the dialog name you wish to use.

Save the map and exit. Open the level file (map/levels.dat) and find the new obstacle label. Change the line above the text from 'type=30' to 'type=32' and save.

Now when you click on the terminal in the game it will start the dialog you selected.

Floor edit mode

The floor edit mode works quite similar to the obstacle edit mode. You can select different types of floors at the object selector.

To fill a region with a single floor tile, first select the tile to use, then click and drag the left mouse button until it covers the desired region.

The floor tiles are placed on the current floor layer. There are no floors that are special in any way, they are pure decoration.

The visibility of floor layers can be controlled by a button with the layer icon. The button is only displayed for levels with multilayer floors. Left click on the button switches between a single floor layer displayed and all floor layers displayed. Right click on the button changes the current floor layer.

Selecting floor types

Selecting is as easy as in the the obstacle mode. Floor tiles can be moved to with the method described above.

For levels with multilayer floors only visible floor layers are selected. When a single floor layer is visible, only the tiles in the current floor layer are selected.

In order to have a look at the floor only, click the lamp icon to have no obstacles displayed. Another click will let obstacles appear again.

The icon with the turquoise rectangle displays collision rectangles. These rectangles indicate the blocking-area of an obstacle. Tux can't walk on such an area.

If you turn it on and playtest (explained later) your map, the rectangles are still displayed if activated which is quite useful for testing whether the player can pass a gap or not.

Item edit mode

You can place items to be used by the player on the map, too.

Items are objects that the player can pick up. They can be carried, some even be used or equipped. Some items are used to move the plot forward, others provide bonuses to the player, while still others do nothing at all.

Select the item mode and click on an item displayed at the object selector.

For some items, you must specify an amount before they are placed. You can set it by clicking the arrow buttons or dragging the blue orb to the left or the right.

Press 'g' to have a better overview of what items are available (can also be used for dropping, items will be dropped at the crosshair). Hit 'Esc' to abort the process without dropping any items.

You can also click the icon with the crossed-out boots to perform this.

Waypoint edit mode

Waypoints are used to determine areas and movement range for the different forces in FreedroidRPG. Currently red waypoints are used for friendly forces while white waypoints for enemy.

Currently, droids (meaning all non-player characters) move around on levels using predefined waypoints. To plant a waypoint, press the 'w' key. This will toggle the waypoint on the rectangle under the crosshair.

You can also click the map at a position you want to have a waypoint having this mode activated. Another click somewhere else plants another waypoint and automatically connects the previous selected one with it.

Clicking on a preexisting waypoint lets you connect it with another one (just click the other one, too, to do it).

However, there is a difference between those two planting methods. When you connect two waypoints using the keyboard, the connections will be unidirectional. That means that when you make a connection from waypoint A to waypoint B, the bot will only be able to walk from A to B but not back.

You can remove an unidirectional connection by 'overlying' it with another one going into the very direction as the one you want to delete (this does not work with bidirectional connections!).

Bidirectional connections are however automatically done using the click method to connect waypoints.

Important note: It is not possible to connect waypoints on different maps with each other!

Waypoints are also used to position randomly spawned bots. However this might be inappropriate for some waypoints. There are 'normal' ones which are white, for respawning bots and 'special', purple ones, which should be used for NPCs.

The normal ones are used for spawned bots, the purple ones should be used for NPCs. You can select these different types of waypoints in the upper selection bar. To turn a normal waypoint into a purple one or back again, press shift+w.

Please make sure that paths between waypoints are not blocked by an obstacle in between of two waypoints. To automatically check a entire map for this, you can use the map level validator which is explained later.

  • Create a waypoint

    • Move the cursor to the position you want to place the waypoint
    • Press "w"
  • Delete a waypoint

    • Move the cursor to the position with the waypoint you want to delete
    • Press "w"
  • Change waypoint's colour

    • Press "Shift+w"
  • Connect 2 waypoints

    • Move the cursor to the starting waypoint
    • Press "c" to start drawing
    • Move the cursor to the finishing waypoint
    • Press "c" again

Planting Labels

There are two kinds of labels: map labels and obstacle labels. Please make sure that each label ID is unique. Giving an empty string will delete the respective label.

Planting map labels

Map labels are used to define starting locations of NPCs (see ReturnOfTux.droids), events that occur when Tux moves over them (see events.dat), or locations used for movement of NPCs through the lua script files (events, quests, and the dialogs).

To define a new map label, press the 'm' key on the keyboard or click the button with the M on the sign on it. You will be prompted for the map label.

Note that there will be a colorful circle appearing on any map tile that has been fitted with a map label.

The map label will be automatically planted on the tile in the middle of the screen. You can switch the displaying of droids/NPCs on or off pressing the button with the 302 bot on it.

Planting obstacle labels

Obstacle labels are important so that some obstacles can be marked for events to happen (for example during a quest). If e.g. an event is supposed to remove a special wall obstacle, then this obstacle must be given a name or ID first, so it can be referred to later in the definition of the event.

You can also use them to add dialogs to obstacles, so you can talk to them as they were NPCs.

To plant a label on an obstacle, you must first mark this obstacle (see obstacle mode explanation above). Clicking the icon with the sign and the O on it you will be prompted for the new label to attach to this obstacle.

Saving maps

In order to save a map, click the small disk icon in the upper right area of the editor screen.

The door icon lets you exit the editor.

You can also do this via the menu that is opened by pressing the 'Esc' key.

General tips

Getting overview

In order to change the zoom factor, press the 'o' key or click the icon with the magnifying glass on it. Try left and right clicking in order to access different zoom factors.

The editor menu

You can access this menu by pressing ESC.

  • "Level:"
    Here you can easily navigate to other levels. You can either use the arrow keys having this option selected in order to switch to the next or previous (refers to level numbers) level, or, clicking on it, enter the number of the desired level and press enter.
  • Level options
    • Level
      See above for explanation
    • Level name
      The map name displayed at the GPS in the upper right corner of the game screen. You can disable the GPS in-game using the options menu.
    • Size You can increase or reduce the size of your level. Select the desired edge where you want to add/remove a line of tiles and click the <- or -> arrow buttons.
    • Floor layers In order to change the number of floor layers for the current level, use the <- or -> arrow buttons.
    • Edge interface Here you can set the levels that shall be next to the current level. Enter the level number for the respective edge. A level can only have one adjacent level (one it touches edges with) in each of the four cardinal directions (North, South, West, East).
    • Random dungeon If you set this option to 'Yes', the map will automatically generate a dungeon. You set the number of teleporters to and from this map clicking on the option. Randomly generated dungeons automatically will have everything necessary, like waypoints, bots, and obstacles, set.
    • Random droids (TO BE WRITTEN)
    • Respawn (TO BE WRITTEN)
    • Item drop class for obstacles (TO BE WRITTEN)
    • Teleport blockade (TO BE WRITTEN)
    • Teleport pair This is important if you make a dungeon that is not directly connected to another map. You can set the number of exits and entrances for a randomly generated dungeon here.
    • Light How much light would you like to have? Press space to switch between ambient (general brightness of the present map) and bonus (light emitted by some obstacles, such as lamps or mushrooms) mode.
    • Background music Here you can set a music track to be played while the player walks around on the map. Possible tracks can be found in ./sound/music/. Just enter the file name including the .ogg extension.
    • Infinite Running Stamina If you have this set to "yes", Tux' stamina will not decrease while running across the map. This should only be used if the level has no hostile NPCs on it, like on level 0, the Town, for example.
    • Add/Rem level Lets you add a new level or remove the current level.
  • Run Map Level Validator
    Here you can run the map level validator. The map level validator checks all the paths between connected waypoints to ensure they are not blocked by obstacles. More detailed output explaining which paths are blocked can be found in the terminal, given the case that the game is run using it, or a global error output file. This should ALWAYS be run before calling a map finished.
  • Playtest Mapfile
    Allows you to playtest your modifications easily. If you leave this mode, obstacle changes that were made while playing, destroying crates for example, will be reverted to the time where you started playtesting.


Key Action
space toggle planting/selection mode
w plant waypoint
shift+w toggle mode for waypoints to 'random bot' or 'NPC'
escape access menu
numberpad digits 1-9 used to plant obstacles at the respective positions of the grid
n cycle through selected obstacles (next)
z undo last action
y redo last undid action
c set paths between waypoints
ctrl+x cut selected obstacle(s)
ctrl+c copy selected obstacle(s)
ctrl+v paste cut/copied obstacle(s)
alt+shift drag/move selected obstacles using the mouse
arrow keys scroll around the map
ctrl+arrow keys scroll around in bigger steps
mousewheel scroll through obstacles of the object selector
ctrl+pageup/page down scroll through obstacles of the object selector
g access drop item screen
t toggle 3x3 transparency around the crosshair
m add/edit a map label at the position of the crosshair or the selected tile
o zoom
tab switch to the next editing mode
shift+tab switch to the previous editing mode
f switch to the next object tab
shift+f switch to the previous object tab

If you encounter problems with the editor, please contact us. Also, don't be afraid to send us maps if you made something cool, we don't bite. :)