This package is a map importer for Mudlet that allows users to import maps from cMud (a MUD client) into Mudlet's mapping system. The importer supports importing room data, scripts, colors, and favorites from dbm or sqlite3 formatted map files, with additional commands to help users localize themselves and manage their imported map. Users can use commands like cmud importmap to load the map, cmud colorRooms to color rooms, and cmud labelZones to add zone labels, making map management and navigation easier.

Module Instructions

For New Users

1. Import the Map Run the command: cmud importmap This will open a file dialog where you can select the map file to import.

2. Set Your Location To localize yourself on the map, use: cmud centerview(id)

   • Find room IDs using: getRooms()
   • Or use: getAreaTable() followed by getAreaRooms(zone #) to list rooms in a specific zone.

---

For Returning Users

If you've used this script before, several new commands are available to help update your map while preserving your custom additions:

• Color Rooms cmud colorRooms Colors your rooms. Requires the Lua package bit, since Lua doesn't support bitwise operations natively.

• Import Favorites cmud addFavs Imports your favorites into the map under UserData → "Favorites".

  • To enable CMUD-like nested labels, you’ll need to set up your own nesting scheme.
  • If there's enough interest, I can share my script and nesting structure.

• Label Zones cmud labelZones Adds labels to your zones. Useful if your zone labels don’t respect the Z-axis.

---

Resetting the Map

If you need to reset the map due to errors or misconfiguration, use: cmud purgedb Note: This will not reset area names, as they remain consistent through re-imports.

---

This package was originally shared on the Mudlet Forums by the author. We’ve automatically listed it here on packages.mudlet.org so more users can discover and benefit from it. Please let us know if you have any questions or concerns - thanks for contributing to the Mudlet community!