Open source game inspired by Dungeon Keeper - Dark, damp and dangerous...
Clone or download
Permalink
Failed to load latest commit information.
cmake OIS: Remove dir name from includes Oct 23, 2018
config Digging claimed wall digrate coef should not be hardcoded Jul 20, 2016
dist Update copyright years Mar 21, 2016
gui Camera boundaries + optional Autoscroll (#1275) Nov 15, 2017
levels Updated release for 0.7.1 Aug 24, 2016
licenses Rename license files to add .txt extension Apr 16, 2015
materials Darkened with gamma, also compressed to be 4 times smaller Dec 4, 2017
models Added a new creature Lava Spawn May 18, 2016
music Rename music files as TrackName_Author.ogg Apr 9, 2015
particles Improved flame particle effect due to node resizing Mar 14, 2016
scripts Remove the unused (and old) AngelScript code Jul 27, 2016
sounds Rename sound folders to start with an uppercase step 2 Dec 18, 2015
source Fixed intro scene's object deletion and movement of main and minimap … Oct 24, 2018
tools Added codespell script to ease later calls. Jun 18, 2016
.gitattributes Changed attributes to ensure linux file endings for cmake files and f… Aug 6, 2015
.gitignore Start of implementation of window and input handling using SFML Oct 27, 2016
.travis.yml Travis: Use MegaGlest mirror for defunct GetDeb repo Oct 23, 2018
AUTHORS Move Dm3d to past contributors Mar 24, 2015
CMakeLists.txt CMake: Drop unused and obsolete CPack config (#1292) Sep 20, 2018
CREDITS Add license info for stars background Dec 4, 2017
LICENSE.md Remove the unused (and old) AngelScript code Jul 27, 2016
README.md Added missing dependency Nov 21, 2016
RELEASE-NOTES.md Updated release for 0.7.1 Aug 24, 2016
appveyor.yml Enable unit tests in appVeyor Nov 8, 2015

README.md

OpenDungeons

OpenDungeons is an open source, real time strategy game sharing game elements with the Dungeon Keeper series and Evil Genius. Players build an underground dungeon which is inhabited by creatures. Players fight each other for control of the underground by indirectly commanding their creatures, directly casting spells in combat, and luring enemies into sinister traps.

The game is developed by a friendly community of developers and artists, and has now reached a quite playable and enjoyable status after more than 6 years of development.

How to play

Future versions will have an in-game tutorial, but for now, you can use the following resources to learn the basic gameplay concepts:

You can play singleplayer levels using the Skirmish menu, or host/join a multiplayer game by using the corresponding menus.

Be part of the community

As free software aficionados, we value community-based development and welcome any willing contributor regardless of their skills. Giving us feedback about the gameplay, or reporting bugs on our tracker, is already a very relevant way of contributing to the development of this game, so please get in touch!

You will find us on the following channels:

Build instructions

If you retrieve the source code of OpenDungeons and want to have a go at building it yourself, have a look at platform-specific build instructions on our wiki: https://github.com/OpenDungeons/OpenDungeons/wiki/Compile

In a few words, to build OpenDungeons, you need the following libraries:

  • OGRE SDK (1.9.x)
  • Boost (same version that OGRE was linked against)
  • CEGUI SDK (0.8.x)
  • SFML (2.x)
  • OIS

You will also need a recent CMake version (2.8 or newer) and a compiler that supports C++11 features reasonably well, i.e.:

  • Linux: GCC 4.8+
  • Windows: MSVS 2013 Express or MinGW 4.8+

On an UNIX system, you can then run:

mkdir build && cd build
cmake ..
make -jX    // X is the number of CPU cores that you want to allocate  

And run the opendungeons output binary.

Contributing code

If you want to contribute code, you should take a look at our coding guidelines: https://github.com/OpenDungeons/OpenDungeons/wiki/Code-Guidelines

It contains a rather deep introduction on how we name, indent, structure and extend our code. It also has some performance optimisation tips.

Repository organisation

Data files

config/          - Several game config files
dist/            - Icons and linux desktop entry file.
gui/             - CEGUI files + corresponding Gui images
levels/          - Game levels
licenses/        - License files used for game data and code
materials/       - Materials (models texturing scripts and textures)
models/          - Model files
music/           - Music files
particles/       - Particle effects scripts
scripts/         - Various packaging and CI scripts
sounds/          - Game Sounds
AUTHORS          - List of past and current contributors
CREDITS          - Detailed listing of licenses and credits for our assets
LICENSE.md       - General information about the code and assets licenses
README.md        - The file you are currently reading
RELEASE-NOTES.md - What's new in OpenDungeons

Code files

cmake/           - Helper files for CMake
 |- config/      - Variable input files for the CMake script
 |- modules/     - Addon scripts for CMake to find dependencies
sources/         - All our own .cpp and .h files of the game
tools/           - Some developers shell scripts
.gitignore       - The files and folders that are ignored by git locally
CMakeLists.txt   - CMake script for generating the Makefile and IDE projects