Crawl Vault Editor

Sorry, your web browser does not support Java.

This is a visual editor for vaults (premade rooms) for the game Dungeon Crawl: Stone Soup.

Vault documentation is available from the Crawl website:

Introduction
Basic Syntax
1. Header Declaration
2. Map Glyphs
Advanced Topics
LUA Reference
1. Basic LUA explanation
2. Lua Modules and Function Reference - This is far from complete, and falling farther behind
3. Triggerables

Note that 'F', 'R', 'O', and 'P' no longer have default meanings. If you wish to use them for granite/orange/silver/ice statue, honeycomb/royal jelly, branch/portal vault entry/rune, and rune, you must specify this explicitly. See syntax.txt for details.

Note that wax walls 'a' were removed in version 0.11. An 'a' character that has not been assigned a new meaning (or other any character defined as a wax wall with KFEAT) will cause DCSS to crash if it appears in the final vault. There was some talk of adding an error message instead, but I don't know if that ever happened.

Note that secret doors '=' were replaced with runed doors '=' in version 0.11. A runed door will prompt the user to confirm opening it, and is intended to stop auto-explore from wandering into dangerous areas and human would know to stay out of. It may also stop monsters from opening the door, but I do not know for sure. Opening a runed door removes the runed-ness, leaving it as a normal door forever after.

The Preview button only applies to SHUFFLE: lines, SUBST: lines, and NSUBST: lines without "/" used as a glyph. The current replacements are also NOT always Crawl-complient in difficult cases (see below). Using this program is NOT an alternative to testing your vaults in Crawl. Always test your vaults before submitting them!

There are ambiguities in the Crawl specifications. In this program, I have resolved them based on what is easier to program, not based on empirical testing with Crawl. The Preview feature is intended only to give the user an idea of what the final vault would appear as, not as an alternative for real testing. My assumptions (that I noticed) are as follows:

SHUFFLE: xc/mx
- The 'x's may become 'm's, but will never become 'c's
- Crawl-compliant
SHUFFLE: cx/xm
- The 'x's may become 'm's, but will never become 'c's
- Crawl-compliant
SHUFFLE: xx/cm
- The 'x's and may become 'c's, but will never become 'm's
- Crawl-compliant
SUBST: c = m x:20
- There is a weight of 10 (the default) for 'm' and a weight of 20 for 'x'
- Crawl-compliant
SUBST: c = m x:20b
- There is an equal (unweighted) chance of 'm', 'x', ':', '2', '0', and 'b'
- Inconsistant: Crawl considers this to be an error
SUBST: c = m xb:20
- There is an equal (unweighted) chance of 'm', 'b', 'x', ':', '2', and '0'
- Crawl-compliant
NSUBST: c = 3:m
- The remaining 'c's are replaced by an undetermined glyph
- Inconsistant: Crawl leaves the remaining 'c's as 'c's.
NSUBST:
- All '/'s are treated as seperators for possible substitutions
- Inconsistant: Crawl may interpret '/'s as glyphs based on context.

I do not have a forum, although I might make one someday. For now, any suggestions, comments, or questions should be posted on the Crawl thread for this program.

Some resources for vault design:

Lists (with images) of tile names for floors, walls, features, monsters, and items. These occupy some nether-world between the previous realease build of Crawl and Trunk (the development version of Crawl). I believe these are the source images from rltiles (the program that generates the images sheets for Crawl).
The up-to-date-for-Trunk versions of the tiles can be found here. However, these are as seperate images and do not have their LUA vault names with them.
Comparison of layouts with relation to the layout_foo TAGS:. Now very out-of-date.

Back to applets page
Back to home page