1. How a MUD Works¶
Evennia (the software running your MUD) is actually two programs working together:
- The Portal handles connections — telnet, the web client — and stays running even while you change code.
- The Server runs your game: rooms, objects, commands. This is the part that restarts when you reload.
Your code lives in a game directory called mudgame, in your own home folder on the lab's MUD server. Four folders matter most:
| Folder | Holds |
|---|---|
typeclasses/ |
The blueprints for Rooms, Objects, Characters, Exits, Scripts |
commands/ |
Commands you add to the game, like wave or @reload |
world/ |
Build scripts and game content |
server/ |
Settings, logs, and the game's database |
You reach your MUD two different ways from the lab portal:
- MUD (telnet) — play the game, as your character.
- MUD Terminal (SSH) — a Linux terminal, logged in as yourself, where you edit the code in
mudgame.
Try it
Open the MUD Terminal tile and run ls mudgame. You should see typeclasses, commands, world, and server.
Tip
Because the Portal stays up during a reload, you never get disconnected from the game just because you changed some code.