Text-based open-world RPG made with Java
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.idea/dictionaries Updated the IDEA dictionary Feb 22, 2016
gimp Should mention the Software Quality Award Oct 30, 2017
idea The project should use BSD 3-clause license Feb 12, 2016
images Should mention the Software Quality Award Oct 30, 2017
scripts Release script now updates GitHub wiki too Dec 20, 2016
src Should have a chance of dropping all enchantments Aug 16, 2017
stats Updated and reformatted SLOC data Dec 16, 2016
wiki Should include Dungeon version in Wiki Dec 16, 2016
.gitattributes Fixes EOL normalization problem. Jul 14, 2015
.gitignore Updated .gitignore to ignore wiki clone Jan 8, 2016
.rultor.yml Should use Rultor for merging Feb 3, 2016
.travis.yml Should only use Precise with Travis CI Aug 15, 2017
CONTRIBUTING.md Removed all vestiges of the GNU GPLv3 Feb 13, 2016
DAMAGE_TYPES.md Documented the damage types Aug 14, 2017
LICENSE.txt Should mention 2017 in the LICENSE file Aug 15, 2017
README.md Should link to Yegor, but present the image Oct 30, 2017
STYLE.md Do not require at-clause wrapping indentation. Jul 18, 2015
appveyor.yml All files should be terminated by a line feed Dec 20, 2016
checkstyle.xml Checkstyle should ensure whitespace after comma May 20, 2017
cov-build.sh Coverity build script should have a comment. Oct 28, 2015
pom.xml Should minify the JSON files with JSON compressor May 20, 2017
release.sh Release script now updates GitHub wiki too Dec 20, 2016

README.md

Dungeon

Travis CI AppVeyor Coverity Scan Build Status codecov.io Gitter

Dungeon is a text-based open-world role-playing-game. You are in control of the life of a character that wakes up with a headache and can't remember exactly what happened to him. You need to do your best to equip yourself to explore Darrowmere scavenging for powerful and valuable treasure.

You are completely free to explore Darrowmere however you want. Be it slaying the most terrible creatures, drinking milk directly from cows, or reading books found in the world to learn about its history and the lives of some of the Commons (the human-like race of Darrowmere) that lived there. Some books may even teach your character magical spells that give him some advantage when dealing with the aberrations roaming the land.

The world is randomly generated, making each and every experience unique. There is also an in-game wiki with a lot of information about the different facets of the game. You can also browse the wiki online.

Screenshots

See the gallery.

Running the game

Download a release.

You only need an updated version of Java to play this game.

Awards

In 2017 this project won Yegor Bugayenko's Software Quality Award.

Software Quality Award

Tools

YourKit

YourKit

YourKit supports open source projects with its full-featured Java Profiler. YourKit, LLC is the creator of YourKit Java Profiler and YourKit .NET Profiler, innovative and intelligent tools for profiling Java and .NET applications.

Building the game

If you want to build the game locally, issue

$ git clone https://github.com/mafagafogigante/dungeon.git
$ cd dungeon
$ mvn package
$ java -jar target/dungeon-[version].jar

Reporting bugs

Bug reports, questions, and suggestions are welcome on our issue tracker.

Contributing

If you know Java, Python, or even if you just know English well, you can contribute.

Check out the issue tracker to see what could be done or figure out something you would like to do and start working on it.

Discussing your ideas on the tracker before coding is a good way to increase the chance of your changes being accepted.

Do not forget to also read Dungeon's contributing guide.

Versioning scheme

Dungeon uses semantic versioning.

  • A release that is incompatible with old saved files increases the MAJOR version.
  • A release that adds content in a backwards-compatible manner increases the MINOR version.
  • A release that makes backwards-compatible bug fixes increases the PATCH version.

License

BSD 3-Clause.