dev:manual:mapping:using-the-map

Use the map while playing

Smudgy stores maps and provides map views, pathfinding, and editing. A MUD-specific package or your own script normally supplies the missing game knowledge: how to identify the current room and which command should follow a route.

A map pane centred on the player's current room with nearby rooms and exits

What a map pane shows

The current room is marked when an automation has identified it. Nearby floors are drawn faintly around the active level. Hover over a room to inspect it.

Use the mouse wheel to zoom. Right-drag with a mouse to pan. On a trackpad, two-finger scrolling pans; hold Ctrl or Command while scrolling to zoom.

A map pane does not send movement commands merely because you click or hover over a room. Routing and speedwalk controls belong to the package or widget that presented the map. Consult that package's README for its commands.

If the location marker is wrong

The renderer does not guess from room text. A mapper integration usually identifies rooms from GMCP/MSDP ids or from carefully chosen triggers, then sets the current location. When the marker does not move:

  1. confirm the MUD still sends the protocol data the package expects;
  2. check that the relevant module or package loaded and is enabled;
  3. make sure the intended area is active in the Map Editor;
  4. check for duplicate areas that use the same room identifiers.

Open Map Editor to inspect the map itself. A correct map with no marker is generally an integration problem; a marker on the wrong room can be an identifier collision or an incorrect room record.

Routes and disabled areas

Pathfinding uses exit weights and avoids areas marked inactive. It prefers a comparable route through maps you own over a friend's shared map, but it can use the shared route when needed.

An inactive area remains visible and can still be addressed explicitly. It is excluded from automatic room identification and is not used as a corridor through a route. Use the activity switch in the Map Editor's area list when two maps describe the same part of a MUD.

Maps associated with a server

Cloud folders and maps can be scoped to server entries. This prevents an unrelated MUD's maps from taking part in identification and routing. The editor can show maps for this server, unassigned maps, or all maps; choosing a destination through a map can also establish that association.

Next: Edit a map.