Valdez High School — IT Lab

Build Your World

A no-code guide to creating rooms, exits, and objects in Evennia MUD

1

Connect to Your MUD

Open your Guacamole portal and click the MUD tile. A dark terminal window will appear — this is a live connection to your personal game world.

You'll see a welcome screen with a login prompt. Type the command below to log in. Replace studentXX with your actual username (e.g. student07).

Username studentXX Password StudentXLab!
MUD Terminal
Welcome to your MUD! Use 'help' for a list of commands. > connect student07 Student7Lab! Logging in... Limbo The void before creation. Everything starts here. Exits: None yet — your world is waiting to be built.
✓
You're in! You're looking at Limbo — the starting room of your personal world. Only you can see or edit this world. Time to build.
2

Look Around

The look command is your eyes. Use it any time you want to see the full description of where you are — the room name, its description, any exits, and any objects nearby.

MUD Terminal
> look Limbo The void before creation. Everything starts here. Exits: None

You can also look at specific things: look sword, look door, etc.

ⓘ
Shortcut: l works the same as look.
3

Create Your First Room

The @dig command carves out a new room in your world. You just give it a name.

MUD Terminal
> @dig The Dark Forest Created room The Dark Forest (#5)

That #5 is your room's unique ID number. Every object in Evennia gets one — yours will be different. You can use it to refer to the room directly if needed.

Try it: Create a room with any name you like. It could be The Castle Gate, A Dusty Library, or anything from your story.
✓
Room names can have spaces — no quotes needed. @dig The Old Inn works perfectly.
4

Add Exits Between Rooms

A room with no exits is a dead end. The @dig command can also create exits at the same time — just add = exit name, return name after the room name.

MUD Terminal
> @dig The Dark Forest = into the forest, back to the clearing Created room The Dark Forest (#5) Created exit into the forest from Limbo to The Dark Forest Created exit back to the clearing from The Dark Forest to Limbo

Now type look and you'll see your new exit listed at the bottom of the room description.

MUD Terminal
> look Limbo The void before creation. Everything starts here. Exits: into the forest
ⓘ
Exit names are the commands players type to move. If your exit is called into the forest, players type into the forest to move there. Classic names like north, south, up, door all work great.
⚠
Already have the room? If you created a room earlier without exits, use @open instead to add an exit to it:
@open north = The Dark Forest
5

Describe Your Rooms

Descriptions bring your world to life. Use @desc here to write a description for the room you're standing in.

MUD Terminal
> into the forest You step into the shadows... The Dark Forest No description set. Exits: back to the clearing > @desc here = Twisted trees loom overhead, their branches blocking out the sky. The air smells of pine and something older. A narrow path winds deeper into the shadows. Description set. > look The Dark Forest Twisted trees loom overhead, their branches blocking out the sky. The air smells of pine and something older. A narrow path winds deeper into the shadows. Exits: back to the clearing

You can also describe exits. Walk back to Limbo and try:

MUD Terminal
> @desc into the forest = A gap between two ancient oaks leads into darkness. Description set.
Try it: Write a description for each room you create. Think about what someone would see, hear, and smell when they enter.
6

Place Objects in Your World

Rooms are more interesting with things in them. Use @create to add an object to the room you're standing in.

MUD Terminal
> @create an ancient stone altar Created object an ancient stone altar (#8) > @desc ancient stone altar = A flat slab of grey stone, worn smooth by centuries of use. Strange symbols are carved along its edges. Description set. > look The Dark Forest Twisted trees loom overhead... You see: an ancient stone altar Exits: back to the clearing
ⓘ
Objects stay where you put them. If you @create something while standing in The Dark Forest, it will appear there. Move to a different room first to place objects elsewhere.
Try it: Add at least one object to each of your rooms. A chest, a statue, a notice board, a campfire — whatever fits your world.
7

Navigate and Find Your Rooms

Use exit names to move between rooms. If you ever get lost, two commands will help:

MUD Terminal
— Go to Limbo (your home base) from anywhere — > @tel Limbo Teleported to Limbo. — List all rooms you've created — > @find/room The Dark Forest (#5) The Castle Gate (#9) A Dusty Library (#12) — Jump directly to a room by name — > @tel The Castle Gate Teleported to The Castle Gate.
✓
@tel is your escape hatch. No matter how deep in your world you are, @tel Limbo always brings you back to the start.
★

Quick Reference

Command What it does
look See your current room (name, description, exits, objects)
look <thing> Examine an object or exit by name
<exit name> Move through an exit — just type its name, e.g. north
@dig Room Name Create a new room with that name
@dig Room = exit, return Create room + two-way exits in one step
@open exit = Room Name Add an exit from current room to an existing room
@desc here = text Set the description of your current room
@desc <thing> = text Set the description of an object or exit
@create object name Create an object in your current room
@find/room List all rooms you've created
@tel Room Name Teleport to a room by name
@tel Limbo Return to your home base from anywhere
help Show full list of available commands
help <command> Show detailed help for a specific command, e.g. help @dig

💡
Building tip: Plan your world on paper first — sketch a map of your rooms and how they connect. Then build it one room at a time using @dig.
ⓘ
Your world is yours alone. Each student has their own private MUD instance. Changes you make don't affect anyone else's world.