MUD Map Quick Start Guide

MUD Map is a tool for mapping text based games like MUDs, MUSHs and text adventures.

Worlds

MUD Map groups maps in worlds. In most cases you will want to create one world for each game you map. Each world can contain several maps while each map consists of a number of places.

You can create a world by clicking New in the File-menu. Enter the name of your world and you are ready to start mapping.

Remember to save your world often (Save in File-menu), since there is no undo in MUD Map.

Creating places

Once you created a world MUD Map will show an empty map. Do a double click on the map to create a new place. A dialog will appear, prompting you to enter some information about the new place:

FieldDescription
NameThe name of the place.
Place groupPlaces that belong together, like a city or a building with multiple rooms, can be grouped visually. Selecting a place group will add a colored ring to the place on the map. We will later explain how to create place groups.
Risk levelAdds a visual hint describing how safe or dangerous a place is. We will later explain how to create custom risk levels.
Minimal and maximum levelThese can be used to add a hint about recommended player levels on the map.

You can change an existing place by doing a double click on it. The place dialog will appear.

If you do a right click on a place the context menu will appear. You can use it to open the place dialog, to remove the place, to add comments, to quickly edit the place group, to create and navigate paths (explained later) and connections to places on other maps (also explained later).

You can also cut/copy and paste places via the context menu. Be careful and save your world file before doing this, since it can not be undone!

Place groups

As explained in the previous section place groups can be used to group places visually. The place group corresponds to the outer colored ring of each place.

To create place groups click Place Groups in World-menu, then click Add in the list dialog. Enter a name for the group and choose a color. You can change the group color later on in by clicking Edit place group in the context menu of a corresponding place.

Risk levels

Risk levels are shown as the inner ring of each place. You can assign them in a place's settings dialog.

A few common risk levels are included in each new world. If you like to create your own risk level click Risk Levels in World menu. A list of risk levels will be shown. Add a name for your risk level and choose a color.

Creating paths

Connections between places can be added and removed via the Paths / Exits submenu of the place context menu (right click on a place). You will also find a list of all connections from / to the selected place, clicking an entry will show the corresponding place.

Paths can be added in three different ways:

It is recommended to mark one-way paths by typing a hyphen (-) as the blocked exit. If you set a custom path color (World menu -> Path Colors for '-' all one-way paths will be marked on the map.

Using more than one map

You might want to create multiple maps for a single world, eg. when a town with lots of places would push the 'rural' places apart, or if there are very detailed buildings inside a town.

To create a new map click on Add new Map on the bottom of the Maps-tab of the side bar. Enter a name for the map and you will be sent to an empty layer, create your places as usual.

The sidebar tab Maps shows a list of maps. Clicking a map shows the map, doing a double click on the map lets you change it's name.

Say you are working on a town and decide to create a map for a detailed building. The building can be shown on the town map by a single place representing all 'inside' places on the other map. You can describe this relation in MUD Map by clicking Maps in the context menu of the place on the town map. Clicking Connect with existing place will open a dialog that lets you choose a place on the town map. The Maps sub-menu of these two places then enables you to quickly move between the two maps without needing to find them in the side bar.

Navigation history and home position

Whenever you jump from map to map or place to place you can use the Prev button on the bottom left to go back to the previous position. The Next button goes the other direction.

You can set a home position by clicking Set home position in the World menu. If you click Go to home position the map will be moved back to that position.