Real-time client integration for Rites of Passage
GMCP (Generic MUD Communication Protocol) is a standard that lets the MUD server send structured data to your client in real time — things like your current HP, what room you're in, what spells are affecting you, and who is in your group. Instead of parsing raw text, your client receives clean JSON that it can use to drive custom UI panels, maps, and gauges.
Rites of Passage has full GMCP support. Any client that speaks GMCP can connect and consume this data. Our custom Mudlet package is the easiest way to take advantage of it, but developers are welcome to build their own scripts for any GMCP-capable client.
To receive GMCP data, your client must negotiate the GMCP telnet option when connecting. Most modern MUD clients (Mudlet, Blightmud, tinyfugue with GMCP support, etc.) do this automatically.
The following packages are sent by the server. All data is JSON. Clients can listen for these events and parse the payload to drive custom interfaces.
| Package | Mudlet Event | Description |
|---|---|---|
| Room.Info | gmcp.Room.Info | Sent every time you move or the room changes. Contains room number, name, zone, terrain type, exit directions and destinations (including door state), and flags for mana room, darkness, and indoors. |
| Room.Map | gmcp.Room.Map | Sent alongside Room.Info. Contains a grid of nearby rooms with their coordinates, sector types, and exits — used to pre-populate the map before you visit each room individually. |
| Char.Vitals | gmcp.Char.Vitals | Sent each combat round. Contains current and maximum HP, mana, and movement points, plus gem mana values for spellcasters. |
| Char.Affects | gmcp.Char.Affects | Sent when your affect list changes. Contains all active spells and effects with human-readable durations, sorted from longest to shortest. Updates immediately when a spell is cast or wears off. |
| Group.Info | gmcp.Group.Info | Sent each combat round. Contains name, level, race, HP, mana, and movement for every group member. |
| Client.GUI | gmcp.Client.GUI | Sent when you type the mudlet command. Contains the version number and download URL for the latest Rites of Passage Mudlet package. Mudlet can use this to prompt for automatic installation. |
The terrain field in Room.Info is one of the following strings:
inside city field forest hills mountain water water_deep underwater air desert snow tropical ice marsh
water is swimmable surface water. water_deep requires a boat or fly spell. underwater requires water breathing.
Mudlet is a free, open-source MUD client with excellent GMCP support. Our custom package adds a purpose-built UI on top of it:
Download Mudlet for free at mudlet.org, then connect to Rites of Passage and type mudlet to get the package.
Type mudlet in-game
That's it. The latest package link is delivered directly to your client.
Previous versions are available below if you need to roll back.
| Download | Version | Changes |
|---|---|---|
| Download | v1.3.0 | Map Mode toggle (per-zone or whole-MUD), mana rooms in purple with M marker, shallow/deep/underwater in distinct blues, two-click confirm on Clear Map, button bar reordered, map colors persist across restarts |
| Download | v1.2.0 | Affects panel, panel position memory, door display on map, self-referencing room fix, dark/blind room mapping, race portrait border on group panel |
| Download | v1.1.0 | Dark room coloring, map color persistence, race portrait border |
| Download | v1.0.0 | Initial release — mapper, vitals panel, GMCP integration |
VMud is a modern MUD client built for players who grew up on zMUD, created by Kilith, immortal and maintainer of Void of Reality.
VMud runs on Windows and is built with PySide6. You can find it on GitHub at github.com/mpvmud/Vmud.
Don't want to install anything? MudForge is a free web-based MUD client from MudVault that runs in any modern browser — no download required. It also has native apps for Windows, macOS, Linux, iOS, and Android.
MudForge supports GMCP, so you get the same real-time data as any other GMCP-capable client. Just search for Rites of Passage in the server list and connect instantly.