KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#developer-tools #codex #typescript #ai-agents #ai-agent #cli #claude-code #open-source #deepseek-harness #dsh-plugin #python #mcp

agony-engine

★ 18 Open GitHub ↗

A modern, web based, procedurally generated MUD.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# The Agony Engine
![AWS CodeBuild](https://codebuild.us-west-2.amazonaws.com/badges?uuid=eyJlbmNyeXB0ZWREYXRhIjoibHRwM2YxOVlSQmJWTzU4NE1BZC9UU1czK1hTaG5iTzRwUG1TS2QyT1RBTVNjTHhqUFNNenhwSkZHZFhraVJ4VkhkTWVhQVZHYWx6VEg1aXMzZEpUWkYwPSIsIml2UGFyYW1ldGVyU3BlYyI6Ii9RcC9Ob1ZMU0dvbi8yRnciLCJtYXRlcmlhbFNldFNlcmlhbCI6MX0%3D&branch=master)
[![Website](https://img.shields.io/website-up-down-brightgreen-red/https/agonyengine.com.svg?label=website)](https://agonyengine.com)

**A modern, web based, procedurally generated MUD.**

## Play Now!
The game is playable at [https://agonyengine.com](https://agonyengine.com) so head on over there to say hello, and take it for a spin.

## Project Status
A working copy of the game has been [deployed and publicly accessible](https://agonyengine.com) from day one. It is kept continuously up to date through automatic deployments on every merged pull request, so you can always check it out and see the progress.

Currently the game is not "playable". You can walk around the map and interact with other players, but there isn't a whole lot to do yet. Please check the [open issues](https://github.com/scionaltera/agony-engine/issues) to see what kinds of things are in development right now.

## Development Quick Start
Please see the [Local Development](https://github.com/scionaltera/agony-engine/wiki/Local-Development) article in the Wiki to learn how to run The Agony Engine on your local machine and get your development environment started.

## Project Goals
The following goals will be updated periodically as the project progresses and more people get involved. They should be interpreted as "guiding principles" for how new features are considered and designed, and what the project road map looks like.

### Modern
The Agony Engine uses the Spring Boot framework. It talks to the client over WebSockets which allows for real time messages between the MUD and your browser, as well as out-of-band channels to support features such as status bars and gauges.

### Secure
Text based games have been around for several decades, but most of the MUDs out there today still use **telnet** as a protocol. On a technical level that is troubling because traffic (i.e. passwords) sent between players and the server is not encrypted, but on a more practical level it's just a very old protocol and there are simply better ways to do it now. The Agony Engine uses HTTPS for secure transport and BCrypt to ensure passwords are safe in the database.

### Traditional
The Agony Engine aims to create a play experience that feels like a "traditional" MUD codebase. It should feel familiar to anyone who has played a DikuMUD derivative MUD before.

### Groundbreaking
While the play experience feels "traditional" the underlying game mechanics and systems should push beyond what is normal for a MUD, and even what is normal for modern games. Text based games offer a low cost platform for experimenting with game design without having to invest in art or sound, and The Agony Engine should take full advantage of that opportunity to offer players an experience that other multi-player games cannot.

### Community Driven
Contributions and feature requests are welcome. The hope is that some will want to contribute to The Agony Engine because they like *this* game, while others will contribute because they've used it as a starting point for *their own* games. That's why it is MIT licensed, truly free open source code. Grab a copy, try it out, and see what you can do with it.

## Get Involved
Please see the [contributing doc](https://github.com/scionaltera/agony-engine/blob/master/CONTRIBUTING.md) to learn how to make contributions to The Agony Engine. If you have questions, suggestions or bugs feel free to open a GitHub issue to discuss them!

agony-engine

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README