Web Mapper
The built-in auto-mapper charts the world as you explore
The Mystic web client includes a built-in auto-mapper that builds a visual map of the world as you move through it. No configuration is needed — just play and the map fills in automatically. Map data is stored in your browser and persists across sessions.
Click the Map button in the header toolbar, or press M on your keyboard while the command input is not focused. The map remembers its open/closed state between sessions.
The Map Window
The map appears as a floating overlay that you can position anywhere on screen.
Moving & Resizing
- Drag the title bar to reposition the map overlay anywhere on screen
- Drag any edge or corner to resize the window — a grip indicator is shown in the bottom-right corner
Title Bar
- Displays the name of your current room, updated as you move
- The × button closes the map overlay (same as pressing M)
Control Strip
A row of buttons runs across the top of the map window, organized into three groups.
Navigation
| Button | Description |
|---|---|
| Center | Re-centers the canvas on your current room |
| − | Zoom out |
| 100% (zoom indicator) | Shows the current zoom level; click to reset to 100% |
| + | Zoom in |
View
| Button | Description |
|---|---|
| Labels | Toggles area name labels and bookmark labels on the canvas (on by default) |
| Split | Moves your current area to a fresh, unoccupied region of the canvas — useful when areas overlap or get tangled together |
| Auto-Tab | When enabled, automatically creates a new tab whenever you enter an area that has no existing tab |
Gear Menu (⚙)
Click the gear icon to open a menu with additional options:
| Option | Description |
|---|---|
| Save Map | Downloads your complete map data as a JSON file — use this to back up your map or transfer it to another device |
| Load Map | Uploads a previously saved JSON file and merges it with your current map data (bookmarks are merged too) |
| Clear Map | Permanently deletes all map data. This cannot be undone — save first if you want to keep your map |
| Help | Shows a quick-reference help panel inside the map overlay |
Map data lives in your browser's localStorage. Clearing your browser's site data, or switching browsers, will erase it. Use Save Map periodically to keep a backup you can reload with Load Map.
Tabs
Tabs let you filter the map to a specific area, making it easier to navigate large, complex regions.
- The All tab is always present and shows every mapped room
- Click + in the tab bar to create a new tab for the current area
- Click a tab to switch the canvas to that area's view
- Double-click a tab name to rename it
- Hover a tab to reveal its × close button
- Scroll arrows appear automatically when tabs overflow the tab bar
- When Auto-Tab is on, tabs are created automatically as you explore new areas
- Walking into a room that belongs to a different tab will auto-switch to that tab
The All tab is great for the big picture. Create named tabs for areas you visit often — dungeons, cities, hunting grounds — so you can jump between them quickly.
Canvas Interactions
Most map interactions happen directly on the canvas.
| Action | Result |
|---|---|
| Drag | Pan the map |
| Scroll wheel | Zoom in / out |
| Hover a room | Shows a tooltip with the room name |
| Double-click a room | Auto-walk to that room — the mapper computes a path and sends movement commands automatically |
| Double-click empty space | Re-centers the map (same as the Center button) |
| Shift+click a room | Moves that room's entire area to a fresh grid region — like Split, but works on any area, not just your current one |
| Ctrl+click a room (Cmd+click on Mac) |
Toggle a bookmark on that room. A prompt lets you enter an optional label. Bookmarked rooms are highlighted on the canvas and labeled when Labels is on. Ctrl+click again to remove. |
Auto-Walk
Double-click any room on the map to automatically walk there. The mapper finds the shortest known path and sends the movement commands to the MUD one step at a time.
- The planned route is highlighted on the canvas while walking
- Press ESC to cancel an in-progress auto-walk
- Sending any manual command also cancels auto-walk immediately
- Auto-walk only works through rooms the mapper has already visited — it cannot pathfind through unexplored territory
Bookmarks
Bookmarks let you mark and label important rooms — quest locations, shops, recall points, or anything worth remembering.
- Ctrl+click (or Cmd+click on Mac) any room to add a bookmark
- A prompt appears asking for an optional label — press Enter to save without one
- Bookmarked rooms are highlighted on the canvas with a distinct color
- When Labels is on, the bookmark label is displayed next to the room
- Ctrl+click a bookmarked room again to remove the bookmark
- Bookmarks are included in Save/Load Map exports
Keyboard Shortcuts
| Key | Action |
|---|---|
| M | Toggle map open / closed (when command input is not focused) |
| ESC | Cancel an in-progress auto-walk |
| + / - | Zoom in / out |
Area Banner
When you walk into a new area that the mapper has already recorded in a different part of the canvas, a banner briefly appears at the bottom of the map window. Click Relocate in the banner to move that area to a fresh grid position, keeping the canvas tidy.
How the Map Builds Itself
The mapper works entirely automatically. As you move through the world, the server sends each room's name, file path, and exits to the web client, which plots them on the canvas.
- Each room is identified by its server-side file path, so rooms are reliably de-duplicated even if multiple rooms share the same name
- Areas are derived from the room's directory path and are used for color-coding, labels, and tabs
- Exit connections between rooms are recorded as you traverse them, building the graph over time
- Map data is stored in localStorage and persists across sessions — no account or server storage needed
There's nothing to configure. Open the map, start exploring, and watch it fill in. The more of the world you visit, the more complete your map becomes.
Tips & Tricks
- Use Save Map (gear menu) regularly — localStorage can be cleared by browser settings or site data wipes
- If two areas overlap and look confusing, select a room in one of them and use Split (or Shift+click) to move it to its own clean region
- The All tab gives the full world view; named tabs let you focus on specific areas without distraction
- You can load a map file exported from another browser or computer using Load Map — useful for sharing maps with other players
- Resize the map window tall and narrow to keep it alongside the terminal, or small and tucked into a corner — it remembers its position and size