GMCP & Mud Clients
Real-time client integration for Rites of Passage
Mudlet Package
Mudlet is a free, open-source MUD client with excellent GMCP support. Our custom package adds a purpose-built UI on top of it:
- Auto-mapping — the world map builds itself as you explore. Terrain colors, door states, dark rooms, mana rooms, and zone boundaries are all handled automatically.
- Vitals gauges — HP, mana, and movement are shown in live bar gauges so you always know your status at a glance.
- Affects panel — active effects split into separate Buffs and Debuffs sections (Buffs given more room by default, since most characters carry far more of them), with buffs close to expiring highlighted yellow or red. Adjustable font size, updates the moment a spell lands or wears off.
- Group panel — every group member's HP, mana, and movement with race portraits, resizable to your liking.
- Channels panel — a floating window with tabs for Chat, Raid, Trade, Group, and Tell, plus an All tab that merges every channel into one combined, tagged timeline and opens by default. Colors match the MUD's own channel colors, font size is adjustable, and it tracks unread messages with badges and a scrollable history per channel.
Don't have Mudlet yet?
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.
| Version | Changes |
|---|---|
| v1.4.2 | Affects panel split into separate Buffs/Debuffs sections with expiry highlighting and adjustable font size; Chat panel renamed to Channels panel with a combined All tab and per-channel colors |
| v1.4.1 | Group Tell (gtell) messages are now delivered via GMCP and appear in the Chat panel under a new Gtell tab |
| v1.4.0 | Chat panel with Chat/Raid/Trade tabs, unread badges, and scrollable history; Chat.Message GMCP events for all three channels; group vitals HP bar clamped when HP exceeds max; map mode switch blocked until map is cleared; map mode selection saved across restarts |
| 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 |
| 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 |
| v1.1.0 | Dark room coloring, map color persistence, race portrait border |
| v1.0.0 | Initial release — mapper, vitals panel, GMCP integration |
Play in Your Browser with MudForge
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.
VMud
VMud is a modern MUD client built for players who grew up on zMUD, created by Kilith, immortal and maintainer of Void of Reality.
- QPainter-rendered terminal — pixel-perfect block character rendering that looks exactly right.
- Dual scripting engines — native zMUD scripting and a full Lua 5.4 VM, so your old scripts work and new ones are just as powerful.
- Full GMCP & MSDP support — enhanced protocol integration keeps your map, stats, and panels live.
- Live auto-mapping — the world builds itself as you explore.
- Real-time game state panels — a UI that stays out of your way.
VMud runs on Windows and is built with PySide6. You can find it on GitHub at github.com/mpvmud/Vmud.
TinTin++
TinTin++ is a free, scriptable terminal-based MUD client available for Linux, macOS, and Windows. A player-contributed script, map.tt, drives a live auto-mapper off the same GMCP room data Mudlet uses — it builds the map as you explore, tracks door state, and colors rooms by terrain.
Thanks to the player Nova for writing and sharing this with the community!
What is GMCP?
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.
GMCP Packages
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 | Description |
|---|---|
| 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. |
| 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. |
| gmcp.Char.Vitals | Sent each combat round. Contains current and maximum HP, mana, and movement points, plus gem mana values for spellcasters. |
| gmcp.Char.Affects | Sent when your affect list changes. Contains all active spells and effects with human-readable durations and a buff/debuff classification (kind), sorted from longest to shortest. Updates immediately when a spell is cast or wears off. |
| gmcp.Group.Info | Sent each combat round. Contains name, level, race, HP, mana, and movement for every group member. |
| gmcp.comm.channel | Sent whenever a message is posted to the Chat, Raid, or Trade channels (including immortal gchat/echat, tagged as "chat"), a group tell, or a private tell (including replies). Matches the community GMCP convention used by MudForge, MudVault, and others. Payload contains chan ("chat", "raid", "trade", "group", or "tell"), msg (the full rendered line, e.g. "You gossip 'hi'"), and player (character name — reliable for incoming messages only). Delivered to both the sender and all recipients, except private tells — those go to the recipient only, since your own outgoing tell already appears in your main game window. |
| 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. |
Room.Info — terrain values
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.