/dungeon

Text-based open-world RPG made with Java

Primary LanguageJavaBSD 3-Clause "New" or "Revised" LicenseBSD-3-Clause

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/bernardosulzbach/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

The game is licensed under the BSD 3-Clause license.