# Dungeon Crawl Stone Soup

Dungeon Crawl Stone Soup (DCSS) is a free and open source roguelike computer game and the community-developed successor to the 1997 roguelike game Linley's Dungeon Crawl, originally programmed by Linley Henzell. It has been identified as one of the "major roguelikes" by John Harris.
Dungeon Crawl Stone Soup was first among roguelikes in ASCII Dreams' Roguelike of the Year in 2008, in a poll of 371 roguelike players. It later polled second in 2009 (behind DoomRL) and 2010 (behind ToME 4), and third in 2011 (behind ToME 4 and Dungeons of Dredmor). The game is released under the GNU GPL-2.0-or-later. The latest release is version 0.32 (0.32), released on Aug 30, 2024. "Stone Soup" refers to the European folk story in which hungry strangers convince the people of a town to each share a small amount of their food in order to make a meal that everyone enjoys.

## Gameplay

Dungeon Crawl Stone Soup is a roguelike game where the player creates a character and guides it through a dungeon, mostly consisting of persistent levels, full of monsters and items, with the goal of retrieving the "Orb of Zot" (a MacGuffin) located there, and escaping alive. To enter the Realm of Zot where the Orb is located, the player must first obtain at least three "runes of Zot" of the 15 available; these are located at the ends of diverse dungeon branches such as the Spider Nest, Tomb, and Slime Pits.
The game has an explicit design philosophy intended to provide interesting strategic and tactical choices within a balanced game; to offer replayability based on random dungeon generation; to make the game accessible and enjoyable without deep knowledge of its internal mechanics; and to present a friendly user interface that can optionally automate several tasks like exploration and searching for previously seen items. Conversely, the developer team seeks to avoid providing incentives for repeating boring actions without consideration, or providing illusory gameplay choices where one alternative is always superior.
Most levels are randomly generated to maximize variety, while the levels containing the objective items are randomly chosen between several manually-designed layouts, which usually contain random elements, and which are authored in a Crawl-specific language incorporating Lua scripting. Randomly generated levels may contain randomly chosen manually designed fragments called "vaults", as well as portals to special manually designed mini-levels called "portal vaults" such as volcanoes and wizard's laboratories.
Characters are initially defined by their species and their background. Character advancement is based on experience points gained by defeating monsters, which increase both an experience level and a set of skills including melee weapons, ranged weapons and magic. The player determines which skills to increase.
The species choice determines the aptitudes of the character for each of the skills, which represent how much experience is needed to raise the skill to higher levels and adds species-specific abilities. In the 0.29 version, 27 species are available, from those with little deviation from the common mechanics such as humans and hill orcs, to species such as mummies and octopodes which have unusual gameplay mechanics.
The background choice determines the starting skills and equipment, with 25 choices as of 0.29 such as fighters, necromancers, and berserkers; unlike species choice, background choice only affects the start of the game – the player is not prevented from pursuing any skills and using any equipment.
The game also offers a pantheon of 26 gods. The player can choose to worship one of the gods once the appropriate altar is found. A few backgrounds even start the game already worshipping a specific god. The choice of the deity significantly impacts gameplay. Favor with gods is earned in different ways. Some appreciate the player exploring or killing enemies, but there are also more whimsical gods like Ru, who expects sacrifices of his worshippers. Favor with one's god is rewarded with widely different benefits, ranging from passive enhancements to occasional gifts to the player to powerful activated abilities. Some gods' enhancements are tailored to specific play styles, such as Okawaru's gifts of weapons and combat boosts supporting fighter types; and Sif Muna's gifts of spell books and increases to MP regeneration, which are more beneficial to sorcerer types. A player can also choose to abandon their god in favor of another, but this will usually cause the deity to become angry at the player. Consequently they will harass the player for a time with actions like summoning powerful monsters against the player, inflicting nasty status effects like slowing, or simply dealing large amounts of damage on the player.

## History
### Linley's Dungeon Crawl

Linley's Dungeon Crawl (or just Dungeon Crawl or Crawl) was a roguelike computer game originally programmed by Linley Henzell in 1995, and first released to the general public on October 2, 1997. The game had a quirky license based on Bison's license and the NetHack License; Stone Soup has contacted every past contributor and relicensed to GPL-2.0-or-later.

#### Original gameplay

Crawl starts with the player's choice of one of over twenty races: several different types of elves, dwarves, humans, ogres, tengu, centaurs, merfolk, and other fantasy beings. Racial selection sets base attributes, future skill advancement, and physical characteristics such as movement, resistances, and special abilities.
Subject to racial exclusions, the player next chooses a character class from among over twenty selections. Classes include the traditional roles of fighter, wizard, and thief as well as specialty roles, among them monks, berserkers, assassins, crusaders, and elemental spellcasters. Wanderers represent an atypical option and receive a random skill set. Together, class and race determine base equipment and skill training, though characters may later attempt to acquire any in-game skill.
The Crawl skill system covers many abilities, including the ability to move freely in armor or silently, mount effective attacks with different categories of weapons (polearms, long or short blades, maces, axes, and staves), master spells from different magical colleges (the elements, necromancy, conjuration, enchantments, summoning, etc.), utilize magical artifacts, and pray to divinities. Training occurs through repetition of skill-related actions (e.g., hitting a monster with a longsword trains long blades and fighting skills), using experience from a pool refilled as the player defeats monsters.
John Harris, in his "@Play" column states that the experience pool system "deftly avoids the many problems of a skill-based development system", mainly praising the need to move on through the course of the game to further improve a PC's skills. In the same article, John Harris states that this experience system "is probably the best skill system yet seen in any roguelike; it could make a claim at being one of the best in any CRPG".
Religion within Crawl is a central game mechanic. Its diverse pantheon of gods reward character conformance to particular codes of conduct. Trog, the berserker god, expects abstinence from casting spells and offers aid in battle, whereas Sif Muna expects frequent spellcraft in exchange for magical assistance and gifts of spellbooks. Some deities campaign against evil, matched by a god of death who revels in indiscriminate killing, while others prove unpredictable objects of worship. Xom, an example of the latter, toys with followers, meting out punishments and showering gifts on inscrutable whims.
The goal of Crawl is to recover the "Orb of Zot" hidden deep within a dungeon complex. To achieve this objective, characters must visit various dungeon branches, such as the Orcish Mines or The Lair of Beasts, which often branch further in to additional areas, like the Elven Halls or The Swamp, and obtain at least three "Runes of Zot" with which to gain access to the Orb. Fifteen different runes can be obtained in any particular game, and obtaining all of them is generally considered an extra feat. While all the possible 654 race/class combinations have been won on the online servers, only 186 of them were ever played online as an all-rune win (as of 2010-08-24). Dungeon maps in Crawl persist, as in NetHack.

#### Versions

The last official versions of Linley's Dungeon Crawl were 4.0.0 beta 26, from March 24, 2003, and a later alpha release, version 4.1.0, dating from July 2005.
Version 400b26e070t, a popular last community release, includes the 2003–2004 patches (Darshan Shaligram) and updates the game to the standard tile version (M. Itakura, Denzi, Alex Korol, Nullpodoh).
The game has been ported to the Nintendo DS as DSCrawl.

### DCSS

Dungeon Crawl Stone Soup begun in 2006 by Darshan "greensnark" Shaligram and Erik Piper as an attempt to restart Crawl development, which had progressed slowly in the years since Linley Henzell, creator of the original Linley's Dungeon Crawl, had retired from developing the game. Several patches had been made to the game, particularly one by Shaligram known as the "Travel patch", which borrowed the implementation of Dijkstra's algorithm from NetHack to provide an auto-exploration ability in game. These patches were compiled into the Stone Soup project, which eventually released publicly on SourceForge.
Stone Soup has since then developed an unprecedented variety of extensions which fit into this general vein of "play aid", such as allowing searching through every item ever discovered by regular expression. Additionally, Stone Soup has made a number of user interface improvements, such as mouse interaction and an optional graphical user interface.
To avoid featuritis, Stone Soup has pruned gameplay elements which they considered superfluous, including several races, backgrounds, magical schools, and most recently the food system. The development team has also expressed a desire to maintain the current total length of the game, and so as new areas are added to the dungeon, old ones have been shortened or even removed to compensate.

## Graphical tile version

One notable addition of the Dungeon Crawl Stone Soup branch is the ability to play (locally or in a web browser) using a graphical tile version of the game. Players unfamiliar with the genre may find the tile version more accessible.

## Android versions

There are two Android ports of the game available.
An unofficial port of the console version was developed and released on Google Play.
There is also a port of the tile version that is under development. The latest unstable builds can be downloaded from the official website.

## Online play

Several public servers support online play through an SSH client and some of these also allow graphical play in web browser (referred to as webtiles). Features of online play include automated high-score tracking and real-time recording of online play for later viewing. Also, ghosts of other players' characters are frequently encountered on a player's journey, providing an additional challenge. A biannual tournament for all Stone Soup players is held after each major release on the servers (usually in September and April). Additionally, players may test experimental game modes, races, and gods, that are not yet ready to be added to the main version.