This documentation teaches you how to create hand-crafted maps (commonly known as vaults) for Dungeon Crawl Stone Soup.

This is a work-in-progress; all readers, vault designers and developers can help by updating these pages any time:

• Documentation can be fleshed out, clarified, or simplified; sample maps and Lua can be provided
• Changes are made in code that might affect maps, Lua modules are added or changed
• Errors or inconsistencies are noticed, formatting and cross-referencing; these docs have been converted from the *.txt files in crawl/docs/develop/levels, wiki formatting still needs adding in a lot of areas
• For any other feedback, suggestions, questions, also see the forum discussion: https://crawl.develz.org/tavern/viewtopic.php?f=19&t=2519

1. Part 1: Introduction
   1. Introduction to Map Design
   2. Sample Map
2. Part 2: Basic Syntax
   1. Header declarations
   2. Map Glyphs
3. Part 3: Advanced Topics
4. Part 4: LUA Reference
   1. Lua Modules and Function Reference
      1. Global Game State ("crawl")
      2. Map and Dungeon ("dgn")
      3. Features ("feat")
      4. Character Information ("you")
      5. Iterators ("iter")
      6. Colours ("colour")
   2. Triggerables