Dungeon Crawl Stone Soup is available in two versions: a non-graphical console port (as is traditional for roguelikes), as well as a graphical Tiles version. The latter package will actually contain both the graphical and the non-graphical binaries, so if you don’t know yet which one you’d prefer, try that one. All pre-built packages contain wizard mode.
Latest stable release 0.12.1
|graphical Tiles/SDL||non-graphical Console/ASCII|
|Windows Installer||Download Unified (Tiles + Console) Installer|
|Windows Zips||Download Tiles Version||Download Console Version|
|Mac OS X||Download Tiles Version||Download Console Version|
|Debian/Ubuntu||Download Tiles Version||Download Console Version|
|Source code||Source code for both Tiles and Console Versions (tarball, tarball without deps)|
Packages for Debian-based Operating Systems
We are also offering packages for Debian-based operating systems (Debian, Ubuntu, Mint, etc) for the architectures i386, amd64 and armel. Add the line from below to your /etc/apt/sources.list:
deb http://crawl.develz.org/debian crawl 0.12
Additionally you should download and install our signing key to prevent warnings and to verify the packages:
wget http://crawl.develz.org/debian/pubkey -O - | apt-key add -
(if not done as root, please insert “sudo” before apt-key)
The available packages to apt-get are named: crawl, crawl-tiles
Stone Soup is undergoing rapid development, but you normally won’t see any big changes in minor bugfix releases. If you’d like to take a look at the next major release, you can play the development version online on CDO or you can download some regularly updated builds for both Tiles and the console version, available for Windows, Mac OS X and Debian/Ubuntu.
Be warned that changes may be experimental, unbalanced or buggy. However, we are usually quick in correcting these issues, and both bug reports and feature requests are very much appreciated. Also, from time to time, save games will be invalidated as big changes are integrated into the game.
1. Getting the source
If you’re only interested in compiling the most recent release version, all you need to do is download the bzip2-ed tarball mentioned above.
Once git is installed, you type the following in your command shell:
$ git clone git://gitorious.org/crawl/crawl.git
“git clone” clones the crawl-ref git repository to your computer. When it’s done, you’ll have a full local copy of Stone Soup’s entire repository with all its history. In particular, you’ll be able to access any of the previous release branches by typing, e.g.
$ git checkout -b stone_soup-0.12 origin/stone_soup-0.12
Now the branch is tracked on your system, the necessary command
becomes much shorter:
$ git checkout stone_soup-0.12
To return to the main development branch (“trunk” or “master”), type:
$ git checkout master
You can have a look at the commit history of the currently active branch with
$ git log
The source code also includes a number of “submodules” like e.g. Lua or SDL
that have to initialized separately. To do this, type:
$ git submodule update --init
See docs/develop/quickstart.txt for a more detailed explanation.
2. Compiling the source
If you’ve never compiled the source code before, check INSTALL.txt for a list of programs you might have to install first. Once everything is installed correctly, all you really need to do is enter the source/ directory and type
for the console version, or
$ make TILES=y
for the Tiles version.
When the process finishes, the binary (named “crawl”) should be in the source directory. Depending on your operating system, you can then start it by clicking on it or by typing “./crawl” in the command line.
If you’re having trouble, or wish to compile the Tiles version on a Mac or to install Crawl for multiple users, please read INSTALL.txt.