Giter Club home page Giter Club logo

Build Status

Dungeon Crawl Stone Soup

Dungeon Crawl Stone Soup is a game of dungeon exploration, combat and magic, involving characters of diverse skills, worshipping deities of great power and caprice. To win, you'll need to be a master of tactics and strategy, and prevail against overwhelming odds.

Contents

  1. How to Play
  2. Community
  3. How you can help
  4. License and history information

How to Play

If you'd like to dive in immediately, we suggest one of:

There is also an ingame list of frequently asked questions which you can access by typing ?Q.

Internet Play

You can play Crawl online, competing with other players or watching them. Click "Play Online Now!" on the Crawl homepage to find your closest server. You can play in your browser or over SSH.

Offline Play

Both classical ASCII and tiles (GUI) versions of Crawl are available to download for Linux, Windows and OS X.

Community

How you can help

If you like the game and you want to help make it better, there are a number of ways to do so. For a detailed guide to the crawl workflow, look at the contributor's guide.

Reporting bugs

At any time, there will be bugs -- finding and reporting them is a great help. Many of the online servers host the regularly updated development version. Bugs should be reported to our github issue tracker. Thoughtful ideas on how to improve interface or gameplay are welcome, but it's often best to discuss changes before opening an issue or pull request.

Map making

Crawl creates levels by combining many hand-made (but often randomised) maps, known as vaults. Making them is fun and easy. It's best to start with simple entry vaults: see simple.des for examples. You can also read the level-design manual for more help.

If you're ambitious, you can create new vaults for anywhere in the game. If you've made some vaults, you can test them on your own system (no compiling needed) and submit them via a github pull request. See the contributor's guide for details.

Monster Speech & Item Descriptions

Monster speech provides a lot of flavour. Just like vaults, varied speech depends upon a large set of entries. Speech syntax is effective but unusual, so you may want to read the formatting guide.

Current item descriptions can be read in-game with ?/ or out-of-game them in dat/descript/. The following conventions should be more or less obeyed:

  • Descriptions ought to contain flavour text, ideally pointing out major weaknesses/strengths.
  • No numbers, please.
  • Citations are okay, but try to stay away from the most generic ones.

Tiles

We're always open to improvements to existing tiles or variants of often-used tiles (eg floor tiles). If you want to give this a shot, please contact us. In case you drew some tiles of your own, you can simply share them with a developer or submit them via a github pull request. See the contributor's guide for details.

Patches

For developers (both existing & aspiring!), you can download/fork the source code and write patches. Bug fixes as well as new features are very much welcome.

For large changes, it's always a good idea to talk with the dev team first, to see if any plans already exist and if your suggestion is likely to be accepted.

Please be sure to read docs/develop/coding_conventions.md too.

License and history information

Crawl is licensed as GPLv2+. See LICENSE for the full text.

Crawl is a descendant of Linley's Dungeon Crawl. The final alpha of Linley's Dungeon Crawl (v4.1) was released by Brent Ross in 2005. Since 2006, the Dungeon Crawl Stone Soup team has continued development. CREDITS.txt contains a full list of contributors.

Crawl uses the following open source packages; thanks to their developers:

  • The Lua scripting language, for in-game functionality and user macros (license).
  • The PCRE library, for regular expressions (license).
  • The SQLite library, as a database engine (license).
  • The SDL and SDL_image libraries, for tiles display (license).
  • The libpng library, for tiles image loading (license).

Thank you, and have fun crawling!

Dungeon Crawl: Stone Soup development team's Projects

crawl icon crawl

Dungeon Crawl: Stone Soup official repository

crawl-ancient icon crawl-ancient

Linley's Dungeon Crawl. ancient contains most releases from 1.1 to 4.00b26, each as a single commit. Branches have 4.1.2a, 2.72 fixed up to compile on modern linux, and the crawl-alternative fork.

crawl-glyphs icon crawl-glyphs

Script for generating a webpage describing the current glyphs in Crawl

dgamelaunch-config icon dgamelaunch-config

A collection of scripts to manage a dgamelaunch installation: Crawl-focused at the moment

gflags icon gflags

The gflags package contains a C++ library that implements commandline flags processing. It includes built-in support for standard types such as string and the ability to define flags in the source file in which they are used. Online documentation available at:

go-sequell icon go-sequell

Sequell database loader for https://github.com/crawl/sequell

gretell icon gretell

The IRC bot used for dcss monster queries

monster icon monster

Monster-information generator used by Gretell

qw icon qw

The DCSS-playing bot qw

scoring icon scoring

Crawl scoring server, scripts, and pages

sequell icon sequell

##crawl bot Sequell; depends on https://github.com/crawl/go-sequell

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.