Goal

Build a modern MU* engine from scratch which is easy to use, read, and modify, even for novice programmers.

Features

• Python modules make it easy to add and change basic functionality.
• Scripting interface hooks directly into the game code, in a sandbox.
• Build in the game, or use a local editor and upload to the server.
• Modify and update the live game without resetting or restarting.
• Compatible with all standard MU* clients.

Usage

• twistd -noy muss.tac & to start the server
• telnet localhost 9355 to connect, or use your favorite MU* client
• trial muss to run tests

Quick Command Reference

• Getting Help
  • usage provides a quick summary of command syntax.
  • help has more description and examples of how to use commands.
• Exploring
  • Type part of an exit name or use go to travel.
  • look around at players, items, and rooms.
  • examine them to get more detail on object attributes.
• Expressing Yourself
  • Use say and tell to talk to other players.
  • retell speeds up ongoing conversations.
  • emote and position show people what you're doing.
  • You can also poke people remotely.
• Interacting With Items
  • take and drop all kinds of items.
  • wear and remove equipment.
  • give things to players or put them in containers.
• Basic Building
  • Use dig to make rooms and open for extra exits.
  • Use create to make objects. (Opposite: destroy.) Helpful object types:
    • muss.db.Object for generic props.
    • muss.db.Container for items you can put other items in.
    • muss.equipment.Equipment for items you can wear.
• Fancier Building
  • Use set to change things that already exist (me and here are keywords.) Examples:
    • set here.description = "A small island in the middle of the flowing river ..."
    • set #4.name = "ornate diamond bracelet"
    • set rose in vase.owner = me
  • unset removes an attribute entirely.
  • The python REPL fills in where commands haven't been built yet.
  • Debug-enabled players can bypass permission checks with sudo.