A textual Multi-User Dungeon ("MUD") server in Haskell. (If you are unfamiliar with the term "MUD," please refer to this Wikipedia article.)
CurryMUD is essentially the hobby project and brainchild of a single developer (me). It's been in active development for over 3 years, but is still very much a work in progress.
My aim is to create a single unique, playable MUD named "CurryMUD." I am writing this MUD entirely in Haskell, from scratch.
Creating a framework which others can leverage to develop their own MUDs is not an explicit goal of mine, nor is this a collaborative effort (I am not accepting PRs). Having said that, the code is available here on GitHub, so other parties are free to examine the code and develop their own forks. Please refer to the license, which is a 3-clause BSD license with additional unique clauses regarding the creation of derivative MUDs.
CurryMUD will have the following features:
- Players will be offered an immersive virtual world environment.
- Content will be created - and development will proceed - with the aim of supporting a small community of players.
- Role-playing will be strictly enforced.
- Permadeath. (When player characters die, they really die.)
- Some degree of player-created content will be allowed and encouraged.
- The state of the virtual world will be highly persisted upon server shutdown.
- As is common with most textual MUDs, client connections will be supported with a loose implementation of the telnet protocol.
- CurryMUD will always be free to play.
What I have so far
- About 85 player commands and 50 administrator commands.
- About 220 built-in emotes.
- Help files for all existing non-debug commands. Help topics.
- Commands have a consistent structure and a unique syntax for indicating target locations and quantities.
- Unique commands, accessible only when a player is in a particular room, may be created.
- The names of commands, as well as the names of the targets they act upon, may be abbreviated.
- ANSI color.
- Character creation.
- The virtual world is automatically persisted at regular intervals and at shutdown.
- Systems for reporting bugs and typos.
- Commands to aid in the process of resetting a forgotten password.
- NPCs can execute commands, either from within code or via the ":as" administrator command.
- PCs can introduce themselves to each other.
- PCs can "link" with each other so as to enable "tells."
- Question channel for OOC newbie Q&A.
- Players can create their own ad-hoc channels.
- Free-form emotes and built-in emotes may be used in "tells" and channel communications.
- Functionality enabling one-on-one communication between players and administrators.
- Weight and encumbrance.
- Volume and container capacity.
- Vessels for containing liquids. Vessels may be filled and emptied.
- Players can interact with permanent room fixtures that are not listed in a room's inventory.
- Objects can be configured to automatically disappear when left on the ground for some time.
- Smell and taste. Listen.
- Eating foods and drinking liquids. Digestion.
- Durational effects that can be paused and resumed.
- Upon death, PCs may have a limited amount of time to exist in the virtual world as a spirit.
I am still in the initial stage of developing basic commands. There is very little content in the virtual world.
About the code
The code is available here on GitHub under this license (a 3-clause BSD license with additional unique clauses regarding the creation of derivative MUDs.) Please note that I am not accepting PRs.
- About 40,000 lines of code/text.
- About 100 modules, excluding tests.
- About 70 unit and property tests exist (I'm using the tasty testing framework).
ReaderTmonad transformer stack with the world state inside a single
- Heavy use of the
- Heavy use of GHC extensions, including:
DuplicateRecordFields(new in GHC 8)
How to try it out
Linux and macOS are supported. Sorry, but Windows is not supported.
Prior to building, it may be necessary to change the values of the
propNamesFile bindings found at the bottom of
FilePaths.hs. Refer to
FilePaths.hs for more details.
Please build with stack (otherwise, I cannot guarantee that CurryMUD will build on your machine).
- Install stack.
- Clone the repo from your home directory (the server expects to find various folders under
stack setupto get GHC 8 on your machine. (The
stack.yamlfile points to LTS Haskell 7.6, which uses GHC 8.0.1.)
stack buildto compile the
currybinary and libraries.
stack installto copy the
- Execute the
- Telnet to
localhostport 9696 to play.
CurryMUD presently cannot be loaded into GHCi due to a GHC bug.
How to contact me
Feel free to email me at the address associated with my GitHub account if you have any questions.