{"id":13418048,"url":"https://github.com/crawl/crawl","last_synced_at":"2025-12-16T14:32:05.765Z","repository":{"id":19779680,"uuid":"23038334","full_name":"crawl/crawl","owner":"crawl","description":"Dungeon Crawl: Stone Soup official repository","archived":false,"fork":false,"pushed_at":"2025-05-12T20:57:04.000Z","size":311230,"stargazers_count":2531,"open_issues_count":490,"forks_count":1442,"subscribers_count":96,"default_branch":"master","last_synced_at":"2025-05-12T21:44:29.723Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://crawl.develz.org/","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/crawl.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2014-08-17T10:39:37.000Z","updated_at":"2025-05-12T20:56:25.000Z","dependencies_parsed_at":"2023-12-19T00:42:11.386Z","dependency_job_id":"4c399c72-c7e8-4690-a530-620bb25ea0b5","html_url":"https://github.com/crawl/crawl","commit_stats":{"total_commits":66692,"total_committers":536,"mean_commits":"124.42537313432835","dds":0.888067534336952,"last_synced_commit":"8a8ce12e040e71d77263aca0d9906178d37beae4"},"previous_names":[],"tags_count":201,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/crawl%2Fcrawl","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/crawl%2Fcrawl/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/crawl%2Fcrawl/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/crawl%2Fcrawl/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/crawl","download_url":"https://codeload.github.com/crawl/crawl/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254000885,"owners_count":21997443,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-07-30T22:00:57.897Z","updated_at":"2025-12-16T14:32:00.720Z","avatar_url":"https://github.com/crawl.png","language":"C++","readme":"[![Build Status](https://github.com/crawl/crawl/workflows/Build/badge.svg)](https://github.com/crawl/crawl/actions/)\n\n# Dungeon Crawl Stone Soup\n\nDungeon 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.\n\n## Contents\n\n1. [How to Play](#how-to-play)\n3. [Community](#community)\n5. [How you can help](#how-you-can-help)\n4. [License and history information](#license-and-history-information)\n\n## How to Play\n\nFor information on how to install the game, please visit [the installation documentation](crawl-ref/INSTALL.md).\n\nIf you'd like to dive in immediately, we suggest one of:\n\n* Start a game and pick a tutorial (select tutorial in the game menu),\n* Read [quickstart.md](crawl-ref/docs/quickstart.md) (in the [docs/](crawl-ref/docs/) directory), or\n* For the studious, [read Crawl's full manual](crawl-ref/docs/crawl_manual.rst).\n\nThere is also an ingame list of frequently asked questions which you can access by typing\n`?Q`.\n\n#### Internet Play\n\nYou can play Crawl online, competing with other players or watching them. Click \"Play Online Now!\" on [the Crawl homepage](https://crawl.develz.org/) to find your closest server. You can play in your browser or over SSH.\n\n#### Offline Play\n\nBoth classical ASCII and tiles (GUI) versions of Crawl are available to [download for Linux, Windows and OS X](https://crawl.develz.org/download.htm).\n\n## Community\n\n* Our official homepage: [crawl.develz.org](https://crawl.develz.org/)\n  * Online webtiles play\n  * Offline downloads\n  * Our community forum: [tavern.dcss.io](https://tavern.dcss.io/)\n* [/r/roguelikes Discord](https://discord.gg/S5F2H32)\n* The [/r/dcss subreddit](https://www.reddit.com/r/dcss/)\n* IRC: #crawl on Libera (or #crawl-dev to chat development)\n\n## How you can help\n\nIf you like the game and you want to help make it better, there are a number\nof ways to do so. For a detailed guide to the crawl workflow, look at\nthe [contributor's guide](crawl-ref/docs/develop/contribution-process.md).\n\n### Reporting bugs\n\nAt any time, there will be bugs -- finding and reporting them is a great help.\nMany of the online servers host the regularly updated development version. Bugs\nshould be reported to [our github issue\ntracker](https://github.com/crawl/crawl/issues). Thoughtful ideas on how to\nimprove interface or gameplay are welcome, but it's often best to\n[discuss](#community) changes before opening an issue or pull request.\n\n### Map making\nCrawl creates levels by combining many hand-made (but often randomised) maps,\nknown as *vaults*. Making them is fun and easy. It's best to start with simple\nentry vaults: see [simple.des](crawl-ref/source/dat/des/arrival/simple.des) for\nexamples. You can also read [the level-design manual](crawl-ref/docs/develop/levels/introduction.txt) for more help.\n\nIf you're ambitious, you can create new vaults for anywhere in the game. If\nyou've made some vaults, you can test them on your own system (no compiling\nneeded) and submit them via a github pull request. See the [contributor's guide](crawl-ref/docs/develop/contribution-process.md) for details.\n\n### Monster Speech \u0026 Item Descriptions\nMonster speech provides a lot of flavour. Just like vaults, varied speech depends\nupon a large set of entries. Speech syntax is effective but unusual, so you may want to read [the formatting guide](crawl-ref/docs/develop/monster_speech.txt).\n\nCurrent item descriptions can be read in-game with `?/` or out-of-game\nthem in [dat/descript/](crawl-ref/source/dat/descript/). The following conventions should be more or less obeyed:\n* Descriptions ought to contain flavour text, ideally pointing out major weaknesses/strengths.\n* No numbers, please.\n* Citations are okay, but try to stay away from the most generic ones.\n\n### Tiles\nWe're always open to improvements to existing tiles or variants of often-used\ntiles (eg floor tiles). If you want to give this a shot, please [contact us](#community). In case you drew some tiles of your own, you can simply share\nthem with a developer or submit them via a github pull request. See the\n[contributor's guide](crawl-ref/docs/develop/contribution-process.md) for\ndetails.\n\n### Patches\nFor developers (both existing \u0026 aspiring!), you can download/fork the source code and write patches. Bug fixes as well as new features are very much welcome.\n\nFor large changes, it's always a good idea to [talk with the dev team](#community) first, to see if any plans already exist and if your suggestion is likely to be accepted.\n\nPlease be sure to read [docs/develop/coding_conventions.md](crawl-ref/docs/develop/coding_conventions.md) too.\n\n## License and history information\n\nCrawl is licensed as GPLv2+. See [LICENSE](LICENSE) for the full text.\n\nCrawl 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](crawl-ref/CREDITS.txt) contains a full list of contributors.\n\nCrawl uses the following open source packages; thanks to their developers:\n\n* The Lua scripting language, for in-game functionality and user macros ([license](crawl-ref/docs/license/lualicense.txt)).\n* The PCRE library, for regular expressions ([license](crawl-ref/docs/license/pcre_license.txt)).\n* The SQLite library, as a database engine ([license](https://www.sqlite.org/copyright.html)).\n* The SDL and SDL_image libraries, for tiles display ([license](crawl-ref/docs/license/lgpl.txt)).\n* The libpng library, for tiles image loading ([license](crawl-ref/docs/license/libpng-LICENSE.txt)).\n\nThank you, and have fun crawling!\n","funding_links":[],"categories":["TODO scan for Android support in followings","C++","Open Source Games","Native","RPG","Artificial Intelligence"],"sub_categories":["C++","RPG"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcrawl%2Fcrawl","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcrawl%2Fcrawl","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcrawl%2Fcrawl/lists"}