Overview

PlayMUD.online is a browser-based MUD client.

It connects your browser to MUD servers, renders ANSI terminal output, saves your profile settings, and provides tools for automation, variables, hotkeys, Lua scripting, and status widgets.

What This Client Does

PlayMUD.online is meant to be a modern, persistent web client for MUDs. Your browser handles the interface, while your profile keeps settings and resumes supported MUD sessions. That means your trigger and alias configuration can follow you between desktop and mobile.

Mobile Client

Use the same profile, automation, scripts, and live MUD session through a terminal-first phone interface.

Terminal

ANSI colors, truecolor, clickable links, command history, charset selection, and quality-of-life input behavior.

MUD Servers

Choose bundled BatMUD targets, add other MUDs, and share or separate settings with scopes.

Automation

Organize triggers, aliases, Lua triggers, Lua aliases, and scripts in one searchable folder tree.

Triggers

Match MUD output with contains, exact, or regex patterns, fire commands, capture regex groups, and highlight lines.

Aliases

Turn short commands into longer ones, including positional arguments such as $1 and $*.

Lua Aliases

Intercept typed commands with Lua, set variables, echo colored feedback, and send one or more MUD commands.

Lua Scripts

Write shared Lua helper functions, maintain temporary session state, and define status widgets from automation.

GMCP

Read structured MUD packages as nested Lua variables and react to live updates without parsing terminal text.

BatMUD Variables

Read BatMUD-specific vitals, party, target, effects, and mapper data through a read-only Lua table.

Inspector

Browse GMCP, BatClient, state, and variables, then print readable debug output into the terminal.

Status Widgets

Bind gauges and status values to state, then place them around the terminal or in the Status tab.

Variables

Use clear placeholders like {target} in commands, aliases, hotkeys, and trigger outputs.

Hotkeys

Capture browser key events or choose presets for function keys, numpad movement, and modifier shortcuts.

How Commands Flow

When you submit a command, PlayMUD.online expands it before sending it to the active MUD server.

The command is accepted from the input box, a hotkey, or a trigger.
Lua aliases may intercept typed commands first. If one matches, its script decides what to send.
Simple aliases expand next, so k troll can become kill troll.
Variables expand after aliases, so kill {target} can become kill orc.
The final command is sent to the selected MUD server.

See Automation, Lua Aliases, Aliases, and Variables for examples.

Current Philosophy

The simple UI is the easy mode, while sandboxed Lua powers advanced triggers, aliases, Script lifecycle hooks, temporary state, and status widgets. The Automation tree keeps those pieces together without forcing every user to write code.

Read Lua Scripting for the bigger picture.