Skip to content
This repository

Kams is a Ruby MUD server which can be used to create and run online text-based worlds.

branch: master

Fetching latest commit…


Cannot retrieve the latest commit at this time

Octocat-spinner-32 components
Octocat-spinner-32 conf
Octocat-spinner-32 events
Octocat-spinner-32 help
Octocat-spinner-32 lib
Octocat-spinner-32 objects
Octocat-spinner-32 traits
Octocat-spinner-32 util
Octocat-spinner-32 .gitignore
Octocat-spinner-32 ADMIN
Octocat-spinner-32 GPL
Octocat-spinner-32 README
Octocat-spinner-32 intro.txt
Octocat-spinner-32 server.rb

Kingdoms of Ahln MUD Server (kams)

Author: Justin Collins
License: GPLv2 except where noted


Ruby (1.8.6, 1.8.7, or 1.9.1)



  1. gem install eventmachine
  2. Uncompress the kams source somewhere
  3. Run ruby util/setup.rb
  4. Run ruby server.rb

If you are using the Windows Ruby One-Click Installer, you can double-click setup.rb and server.rb to run them.

Where to find things

The Server starts and restarts the server.

The Manager holds all the GameObjects, passes events to the EventHandler, and generally holds methods for accessing the state of the game.

GameObject is the superclass of all objects in the game.

Player handles player stuff, like showing the prompt and managing stats.

CommandParser turns commands into events.

EventHandler calls the appropriate events.

StorageMachine stores GameObjects in the storage/ directory (by default).

All game objects should be kept in the objects/ directory.

The text shown upon connection is in the intro.txt file and is loaded by the PlayerConnection if it exists.

'Reactions' for GameObjects are in objects/reactions/ and have the '.rx' extension.

Help files go in help/ and are just plain text files with the '.help' extension. You can simply use symbolic links for aliasing one command to another.

The file help/syntax.rb provides syntax help in the game.


Some things (hunger) may appear to be implemented but they really are not.

Something went wrong with that request. Please try again.