public
Description: Mire is a simple MUD written in Clojure
Homepage:
Clone URL: git://github.com/technomancy/mire.git
mire /
name age message
file .gitignore Wed Mar 11 17:34:53 -0700 2009 Always use data-dir from the command-line. [Phil Hagelberg]
file Manifest.txt Wed Mar 11 17:28:42 -0700 2009 Added a manifest for jar creation. [Phil Hagelberg]
file README.markdown Sun Feb 22 14:21:47 -0800 2009 Expanded the README to explain about each step ... [Phil Hagelberg]
directory classes/ Wed Mar 11 17:28:43 -0700 2009 Modify launchers to use server namespace. [Phil Hagelberg]
file compile.sh Wed Mar 11 17:40:12 -0700 2009 Add a compile script. [Phil Hagelberg]
directory data/ Sat Feb 28 16:15:24 -0800 2009 Implement detect command. [Phil Hagelberg]
directory jars/ Thu Mar 05 08:34:34 -0800 2009 Updated clojure and clojure-contrib jars. [Phil Hagelberg]
file mire.el Wed Mar 11 17:28:43 -0700 2009 Modify launchers to use server namespace. [Phil Hagelberg]
file mire.sh Wed Mar 11 17:28:43 -0700 2009 Modify launchers to use server namespace. [Phil Hagelberg]
directory src/ Fri Apr 17 11:53:53 -0700 2009 Merge branch '12-packaging' Unfortunately with... [Phil Hagelberg]
file test.sh Fri Apr 03 15:07:22 -0700 2009 Tests need to be in src/ so they are on the cla... [Phil Hagelberg]
README.markdown

Mire

It's a nonviolent MUD. (Multi-User Dungeon)

Usage

You can launch the server either via SLIME by evaling mire.el from within Emacs (preferred since it gives you access to the REPL) or by running the included mire.sh shell script.

Dependencies (clojure, clojure-contrib) are included, though you will need a JVM on your system.

To connect as a player, simply telnet to port 3333, or hit M-x mire from within Emacs if you have used mire.el.

Motivation

This code is not that interesting as a game, though I suppose something fun could be built using it as a base. The primary purpose of it is as a demonstration of how to build a simple multithreaded app in Clojure.

Mire is built up step-by-step, where each step introduces one or two small yet key Clojure principles and builds on the last step. The steps each exist in separate git branches. To get the most out of reading Mire, you should start reading in the branch called step-01-echo-server and continue from there.

While you can learn from Mire on its own, it has been written specifically for the PeepCode screencast on Clojure, which should be released early March 2009.

Copyright (c) 2009 Phil Hagelberg Licensed under the same terms as Clojure.