Skip to content

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.

Next: Your Personal Game →