Start GosMapper

There are two ways to start GosMapper:
- like a stand-alone application, open it from the start menu>Programs>GosClient>GosMapper. In this case you can't use alla the functionality, like automapping, that comes from the interaction with GosClient. However you can create new maps or open and modify existent ones.
- through the plug-in, you've to start GosClient first and then click "GosMapper plug-in" from the plug-ins menu. Opening it like that let you use all the funtionality related to the client like automapping and follow mode, and you can even dock the mapper window into the layout.

Visualization and selection

GosMapper let you rotate, move and zoom the map in a very simple way using the mouse:
- to rotate, make a complete click with the right button of the mouse (click and release) onto an empty region of the map, then a circle will appear and the map will rotate while you move the mouse. To exit the rotation mode just click. To reset the rotation to 0 degrees just make a double click with the right button, click the last button on the toolbar or use the corresponding command in the "view" menu.
- to zoom in and out you can use the scroller of your mouse, the buttons on the toolbar, or the commands in the "view" menu
- to move the map just click and drag from an empty region with the left button of the mouse.

Follow movements: if you set this option, the current room (signed in green) will be always centred into the view, following your movements onto the map.

You can select a single room or link clicking on it (a double click will open a properties window for the selected item), to select multiple rooms just click anda drag from an empty region of the map with the left button. A right click onto a selected room or link will show a contextual menu with some options regarding the selected object(s). You can move rooms by simply dragging and dropping them (after a selection) with the left button of the mouse.

Movements

To move onto the map you can use either the wind rose (located in the bottom right corner of the map) or the keyboard:
- North = up arrow
- South = down arrow
- East = right arrow
- West = left arrow
- Up = + key
- Down = - key
- Northeast = pgup
- Northwest = home key
- Southeast = pgdown
- Southwest = end key

Modes

From "Mode" menu you can switch from several modes:
- Trace (default): in this mode, moving onto the map will cause the creation of new rooms and links.
- Explore: in this mode instead, you can move throughout the map without worring of creating mess, because no new rooms or links will be created during movements.
- Online: this mode can be set only if the mapper has been started from the client, this assures the link with GosClient and let you trace your maps just moving into the mud, playing normally with GosClient.
- Follow: if configured in the right way, this mode let you trace your steps even when you're following someone into the mud (when you're part of a group, for example). Look at the Configuration paragraph for further details.

Configuration

To get automapping on-line mode to work you have to properly configure the mapper, getting it to "uderstand" the mud you're playing.
To open the configuration window open GosMapper from the client and then choose "Configure online mode" from menu "Edit".

General
Wrong Way: in this list you must place all that phrases which means that there isn't any exit in the direction you're going, but more generally, you have to place here every line that mean you can't move, like when you're sleeping. (eg. "No exit found in that direction", "In your dreams, or what?")
Ignore: in this list you have to place all the lines which appears occasionally before the title of the room (during a move) and so are to be ignored by the mapper. A classic example is when you're carriyng too much weight for your possibilities and so the mud sends lines like "You're very tired" before the title of each room, to indicate you're using more movement points than normal.

Directions aliases
In this page you have to insert the long forms (like "north") and short forms (like "n") of the directional commands.

Follow mode
This is the more complicated section of the configurations, but if you set it up properly, you can use the follow mode, which is really useful in some situations.
Let's start from an example of the formation of a groud to have an idea of the settings to insert:

01 You join Seph's group.
02 .
03 .
04 .
05 Seph goes east.
06 You follow Seph.
07 .
08 .
09 .
10 You stop following Seph.

In this short passage are present all the setting you have to configure. First of all, the join of the character to a group (1, Activation trigger), the movement of the group (5, Direction trigger), the notify of the movement (6, Follow trigger) and at last the character is removed from the group (10, Stop trigger).

Activation trigger: this trigger, when recognised into the mud text, automatically starts the follow mode. His definition must contain the name of the guy you're following, which will change every time you use this mode, so just replace it with %name. So the activation trigger in the example will be "You join %name's group.". Remember to always include all the details of the line into the trigger including full stops, commas, etc...
Direction trigger: this trigger provide the movement direction. Like the other, you must use %name for the name of the character you're following and %dir for the diretion. In the example, the direction trigger will be "%name goes %dir.".
Follow trigger: this text always precede the movement of the character and does not exists in all muds. If exist in the mud you're playing just place a check into the checkbox before "Follow trigger" and then set up the trigger prototype. Like the others, use %name freely. The trigger will be "You follow %name.".
Stop trigger: this trigger lets the mapper automatically stop the follow mode. Following the same rules of the other, the trigger will be "You stop following %name.".

Follow mode can even be started and stopped manually using the corresponding command into the "mode" menu.

Information
In this page you can setup some configurations to let the mapper get from te mud some information about the current room. By now the only thing the mapper can take is the title of the room. For most muds the right setting for the title is 1, if it isn't for your, just make a few tries and find the right setting.