develop/levels/guidelines.md

1 # Guidelines for specific types of vaults
3 1. [Guidelines for D:1 arrival vaults](#guidelines-for-d1-arrival-vaults)
5 3. [Guidelines for creating serial vaults](#guidelines-for-creating-serial-vaults)
6 4. [Guidelines for creating ghost vaults](#guidelines-for-creating-ghost-vaults)
9 ## Guidelines for D:1 arrival vaults
11 Arrival vaults should provide atmosphere and a nice starting point. The idea
13 Playing Crawl a bit will show you a number of arrival vaults, which live in
16 ### We need more arrival vaults!  argument
18 We love new arrival vaults, and it is easy to make new ones. Coding abilities
24 complicated vaults and read the more
26 Crawl also employs vaults in many other places; check the various `.des` files
38 * Also avoid monsters-behind-glass-wall vaults. We already have enough of these.
42 * Arrival vaults should have multiple entry points, escape hatches, or enough
47 Entry vaults should be NAMEd as follows:
69 Overflow temples are specific vaults used by the dungeon builder to guarantee
73 player with a guaranteed altar. Both classes of vaults are seen often in the
82 but there are plenty of other creative possibilities. The vaults are in
103 ## Guidelines for creating serial vaults
105 Sometimes, we want flavour (or also other) vaults to be placed several times,
107 The lua calls for such serial vaults are in the files in the folder
111 The vaults eventually could be just copies of one map, or (much better) come
113 it may be interesting to created serial vaults around threats.
138 ## Guidelines for creating ghost vaults
140 Ghost vaults are vaults that place a player ghost, which is an undead monster
141 with properties derived from a player who died. These vaults should place some
143 from killing the ghost isn't sufficient reward. Often these vaults place
144 monsters in addition to the ghost. Ghost vaults usually place one ghost, but
149 All ghost vaults not placing in the Vaults branch should go in
155 This well set the common tags we want for all ghost vaults as well as the
156 common CHANCE to place these vaults, as described in sections below. These
157 vaults can be minivaults or have any of the usual kinds of ORIENT statements.
171 Ghost vaults should always be sealed and ideally not diggable by monsters that
173 outer walls and use either runed doors or transporters for entry. The vaults
191 The current range of levels that place ghost vaults is:
201 currently 10%. Ghost vaults that call one of the lua setup functions mentioned
206 ghost vaults, use a WEIGHT statement to set a weight other than 10, the
216 appropriate, ghost vaults can set their own tags instead of calling these
217 functions. For ghost vaults not in the Vaults branch, the vault should at a
225 `vaults_ghost` tag; these vaults should not have a CHANCE statement at all.
227 Other tags we generally require for ghost vaults are `no_tele_into` and