Using qtMUD

On its own, qtMUD is a talker-style MUD. This means it provides basic user accounts and the ability for them to communicate with each other directly or through channels, along with some utility functions.

qtMUD is

While this is intended to be a framework for more complex MUDs,


The easiest way to get started with qtMUD is by installing the PyPi package:

$ pip install qtmud

If this fails for any reason, check the Installation seciton for help. If it works:

$ qtmud_run

should produce output like:

qtmud_run preparing to start qtmud 0.0.6
qtmud        WARNING  No valid config found, using default values
qtmud        INFO     qtmud.load() called
qtmud        INFO     adding qtmud.subscriptions to qtmud.subscribers
qtmud        INFO     adding to qtmud.active_services
qtmud        INFO     qtmud.load()ed
qtmud        INFO     filling qtmud.client_accounts from ./qtmud_client_accounts.p
qtmud        INFO     start()ing active_services
qtmud        INFO     talker start()ed
qtmud        INFO     start()ing MUDSocket
qtmud        INFO     MUDSocket successfully bound to ('localhost', 5787)
qtmud        INFO     MUDSocket successfully bound to ('localhost', 5788, 0, 0)
qtmud        INFO     mudsocket start()ed
qtmud        INFO

This means that qtMUD is up and running and you can connect to it as a client. The easiest way to do this is with telnet:

$ telnet localhost 5787

If everything is working, you should see output similar to this::

Trying ::1...
Connection failed: Connection refused
Connected to localhost.
Escape character is '^]'.

qtmud               0.0.6

Successfully connected to qtmud, press enter to continue login...

From there, you can log in (qtMUD has very basic user accounts) and play around with the default commands.



in-depth explanation of installation procedure for non-developers.


IPv4_HOSTNAME = localhost
IPv6_HOSTNAME = localhost
IPv4_MUDPORT = 5787
IPv6_MUDPORT = 5788

CLIENT_ACCOUNTS_PICKLE = './client_accounts.p'


verbose explanation of the qtmud.conf file

Client Features


explanation of what clients can do, and how they’re represented on the backend.

Pinkfish Parser

New in version 0.0.10.

Players (and developers) can use Pinkfish-style tags to make up their text. Not too much to explain here. Enjoy abusing it on the talker.