Map (command)

From Discworld MUD Wiki
Jump to: navigation, search
An example of the map command when used in a non-terrain room.

The map command shows you or tells you the shape of the surrounding area, as well as whether there are living things in it.

Syntax and map types

There are four different syntaxes for the command:

map                                       Show a map of your surroundings.
map door text                             Show a textual description of your
                                          surroundings, not listing exits if
                                          they have doors.
map text                                  Show a textual description of your
map ascii                                 Show an ASCII art map of your

What you get when you type "map" by itself depends on the option "options output map written":

  • "options output map written=off" will cause you to get an ascii map, as with "map ascii".
  • "options output map written=on" will cause you to get a text map, as with "map text".
  • "options output map written=doors" will cause you to get a less verbose text map, as with "map door text".

Map door text

This lists living things and their locations within your field of vision, as well as telling you how far around you you can see.

It doesn't work in terrain rooms; attempting to use it there will just output the ascii map.

Map text

This is like map door text, but it also lists doors and other exits.

Map ascii

This shows an ascii map of the surrounding area, showing types of rooms and where living things are. Unlike the text maps, it only shows you that there is at least one living thing in a room--it doesn't tell you who or what they are.

It also gives you a map key.

The default is for it to be in colour, but you can change this with the option "options output map plain=on".

The lookmap

With certain of the "options output map" set of options you can choose to have a map shown every time you look or glance, including when you look or glance automatically when you move. This map is of the same type that you see when you type "map" by itself (in other words, either an ascii map or one of the text maps, depending on your settings).

options output map
Output map:
   glance            = off        <off|left|top|bottom|frame|tagged>
   glancecity        = off        <off|left|top|bottom|frame|tagged>
   look              = off        <off|left|top|bottom|frame|tagged>
   lookcity          = off        <off|left|top|bottom|frame|tagged>

The "glance" and "look" options affect whether the lookmap shows up in terrain rooms, while the "glancecity" and "lookcity" options affect whether it shows up in non-terrain rooms (which are most of the rooms in cities, towns, and villages). "Glance" and "glancecity" affect whether it shows up when you glance (or move with brief look on), while "look" and "lookcity" affect whether it shows up when you look (or move with verbose look on). What you set them to determines the position of the map.

The lookmap has a smaller range than the full map. In the ascii version, the lookmap also leaves out the map key.

MXP with ascii maps

Ascii maps can be set to have the rooms be clickable mxp links, similar to the ones for room exits. When you click the link on the map, you'll walk to that room (queuing up the direction commands to get there, in other words).

The relevant options are:

options output map
Output map:
   mxp               = on         <on|off>
   reversecolour     = off        <on|off>

Setting "options output map mxp=on" enables the clickable links, and "options output map mxp=off" disables them.

Setting "options output map reversecolour=on" causes the normal text colour to be made the background colour and the normal background colour to be made the text colour. This option only affects the map, and only if mxp is on for the map. This may be desirable if your mud client makes all links the same colour (as the text will then still be the link colour your client specifies, but the background will be the colour that the text would normally be).

You may also be able to stop your client from making all links the same colour:

  • For MUSHclient, go to File-->World Properties. Go to the "MXP/Pueblo" section under "Appearance". In the "Hyperlinks" area, make sure that "Use custom link colour" is not ticked.


Some things--like closed doors, trees (as in forest or jungle terrains), cities, and bridges--can obstruct your view. You also can't see through up or down exits, or around corners (although if you can see into a room, you can see the exits out of it). Mountainous terrain makes it harder to see, too--you can't see as far uphill as you can downhill.

The light level and, if you're outside, the weather, can also affect how far you can see. Snow and pitch darkness in particular can limit your range of vision all the way down to not being able to see out of the room you're in.

Living things may not show up on the map if they are hiding.

In cities, the full map shows things up to five rooms away, and the lookmap shows things up to two rooms away. In terrains, the full map shows things up to ten rooms away, and the lookmap shows things up to four rooms away.

Covert mapping

Other people can see you using the map command. If you're sneaking or hidden, mapping uses and can tm the skill, and presumably with a high enough bonus other people won't detect you mapping.

This can take you out of hiding.

See also

External links