The K Desktop Environment

Kmud Homepage


Next Previous Table of Contents

4. Usage: Automapper

The automapper is a tool that can be used to generate maps of a mud. This can either be done manually or automatically. Once a map as been create it can be use to move around and show the layout of the mud.

4.1 Getting started

The automapper runs in a separate window to the main Kmud window To activate the mapper, select Mapper from the view menu or select the mapper icon on the tool bar.

This will open the mapper window. If this is the first time the mapper has been used for the current mud then the map will be empty, ready for the user to create a new map of the mud.

When the map window is closed or the connection to the mud is closed, then the map is saved. This map will be loaded next time the mapper window is opened for the mud.

4.2 Menu and toolbar options explained

The automapper tools can be selected from the mapper toolbar or from the tools menu. These tools are used to edit a map manually. As well as editing tools there are also tools to change the way the map is viewed. These tools are described below.

Select tool

The select tool is used to select the different elements of the map. Once a element(s) has been selected it can be move or manipulated using the edit menu. The simples way to select an element is by clicking on it using the left mouse button. If afterwards a different element is selected then the previous one becomes unselected.

The automapper allows multiple elements to be selected, there are two ways of doing this. The first method is by holding down the Control key. Whilst the control key is being held down the previous element will not be unselected when a new one is selected.

The second way to select multiple elements is by using a selection box. The selection tool has two modes of operation. The first is what we have just discussed, when each element is selected one at a time. This works by pressing and then releasing the mouse button above an element. The second mode is when the mouse button is held down whilst the mouse is moved. When the mouse button is released, everything in the box will become selected.

Create room tool

The create room tool is used to create room elements on the map. Select the tool, then click on the map where you wish the new room to be.

Create path tool

The create path tool is used to create path elements on the map. Select the tool, then click the mouse on the room you wish the path to start at. Now move the move the mouse pointer to the room where you wish the path to end and click the mouse again.

The path properties dialog will now appear asking you to set the properties for the new path. From this dialog you can make the path either a one way or two way path. The directions that the path leaves the start room and enters the destination room will need setting. Once the details have been set, click 'OK' to create the path.

Create text tool

The create text tool is used to create text elements on the map. Now click the mouse button where you wish the text label to appear. The text properties dialog will now appear. In this dialog the text element style, color and text can be set. Once these details have been set, click the 'OK' button to add the new text element to the map.

Erase map element tool

The erase element tool is used to remove a element from the map. Select the tool, then click on the element you wish to erase. This will remove the element from the map.

Grid tool

The grid tool is used to hide and show the gird. The grid can be useful when editing maps as it is easier to see were to place elements such as the rooms.

Level up and down tools

There are two tools for moving up and down levels. These are used to view the different levels of the map. It also possible to create paths between different rooms using the level up/down tools with the path tool.

Creating new levels

When manually creating a map it is sometimes necessary to create new upper or lower level. For this reason two tools in the tools menu are provided. The new levels created with these can then be used like another level.

4.3 Edit options

The Kmud mapper provides the standard cut/copy and paste as well as delete editing options. These options can be used to act on selected map elements. The edit commands can be found in the edit menu or on the edit tool bar.

If the user selects copy then all the selected elements will be copied into the automappers clipboard. These can the be pasted back onto the map using the paste option. This will place the elements in a slightly different place to there original place. It is not possible to have two elements like a room occupying the same position, so if there is something already in that position the element in the clipboard is not pasted.

Cut works in a similar fashion to copy except that the selected elements are also deleted from the map. Delete can be used to delete elements from the map without placing them into the clipboard.

4.4 Mapping Modes

There are different modes that the automapper can be in. This changes the way the main window of Kmud interacts with the automapper. Mode options can be found on the modes tool bar and the options menu.

Create mode

If the create room mode is on, then as a player moves around the mud, new rooms will be created. If it is off then the player will only move to rooms that already exists.

Follow mode

If the follow mode is enabled then the automapper will follow the player around the map. If it is disabled then the automapper will make no attempt to follow the player.

4.5 Preferences

There are several options that can be configured to change the way the automapper works. To view the preferences dialog, select the preferences menu item form the the options menu.

This will display a preferences dialog with several tab panes for changing the settings of different elements of the automapper. Along the bottom of the dialog are some buttons. The 'OK' button is used to accept and apply the changes made with the dialog, the 'Cancel' button is used to close the dialog without apply any changes and the default button is used to restore the default settings for the automapper.

Directions

As a player moves around the mud using directions commands entered into the main mud window, the automapper can follow the player (if the correct modes have been enabled). In order for this to happen the automapper needs to know what commands are used to move in each direction. These commands are configured in the directions tab pane.

Colors

The colors tab pane is used to setup the different colors for elements of the map. For example the color of things like rooms and paths can be setup here. There are also options for setting the colors used to show the level below and above the current level.

Misc

There are several options that can be set from the misc section. It is possible to configure valid room checking from here. When enabled , the mapper parses the output from the mud to see if the move that was last enter was valid or invalid. The text contained in the output of a valid or invalid should be entered into this section.

It is possible for the speed walk to get suck. To get around this problem it is possible to set a limit on the speed walking. If this limit (number of steps) is reached before the destination is reached then the speed walking will be aborted.

The last option that can be set, is the default path type. It is possible to inform the automapper to create two-way or one-way paths by default.

4.6 The view menu

The view menu is used to change the view of the automapper. It is possible to hide/show the toolbars and the status bar from this menu. The gird can also be hidden or displayed. The automapper is able to display the level below and above the current displayed level. It turn this feature on or off, use the options 'Show Lower Map' and 'Show Higher Map' in the view menu. The last feature that can be hidden or shown from the view menu is the overview panel. This is used to display a birds eye view of the map.

4.7 Creating a map

There are two possible ways of creating a map. These are manually and automatic. When creating a map automatically, the map will build up as a player moves around the mud. The manual creation of maps is done via the mapper interface in a similar way to most vector graphics drawing program. The method of editing the map is useful for editing automatically created maps as the automapper will not get it correct every time.

Creating a map manually

Maps can be created manually similar to vector graphics programs, or automatic maps can be adjusted. Using the tools in the tools menu or the tools toolbar, rooms, paths and text labels can be created. Each item put onto the map is know as a map element. By clicking with the right mouse button on a map element, a context menu is display that allows the map element to be changed. For example it is possible to set the players current position to a room by right clicking on the room and and selecting "set current pos".

Creating a map automatically

In order to create a map automatically the directions but be setup in the mapper options dialog. The create and follow modes must be turn on. The map can then be created by moving the player around the mud using the main Kmud window.

It will be necessary to set the login room when when the room as been mapped so that Kmud knows were the character should be when the map is started. This can be done by right clicking on a room as choosing set login room.

4.8 Speed walking

Using the automapper it is possible to speed walk to a room. This means that if the user wanted to move the mud character to a room on the map, then they can right click on the room and select the speed walking menu item. This will walk the character to the room.

It is possible that this can go wrong so care should be take when using this option. It is possible to limit the number of steps take while speed walking. This can be set in the options (see misc options section).

Next Previous Table of Contents