Editing Dungeon Generation (section)

== Chambers ==
There are some 100 or so uniquely designed chambers that are connected together like lego pieces to make a unique dungeon layout. No dungeon layout will ever have two of the same chambers in a single instance.

Some chambers are tied to specific a realm. When a dungeon is generated, chambers are most often picked (60% of the time) from those designated to the current realm, although some (about 40% of the chambers) can come from other realm designations or non-designated chambers.

=== Chamber Doorways ===
Chambers are connected via large square, circle and irregular open doorways. In some dungeons, some chamber exits will not be connected to another chamber and this is represented by caved-in rocky debris that is impassable.

Circular chamber exits will always be connected to circular entrances of other chambers. Square chamber exits to square chamber entrances, and irregular doors connected to like doors in the next chambers.

<div class="card-deck">
<bootstrap_card header="Square Door" footer="Square exits seem to be more purposely built, about the correct size for teams of adventures to fit through in small groups">
[[File:square door.jpg]]
</bootstrap_card>

<bootstrap_card header="Circular Door" footer="Circular exits seem to connect through a massive sewer system.">
[[File:circular door.jpg]]
</bootstrap_card>

<bootstrap_card header="Irregular Door" footer="Irregular exits seem to connect through ancient mines and possibly tens of thousands of year old ruins that long been built over by more modern structures.">
[[File:irregular open door.jpg]]
</bootstrap_card>

</div>


<div class="card-deck">

<bootstrap_card header="Impassible Square Door">
[[File: caved-in square door.jpg]]
</bootstrap_card>

<bootstrap_card header="Impassible Circular Door">
[[File: circular door caved-in.jpg]]
</bootstrap_card>

<bootstrap_card header="Impassible Irregular Door">
[[File:irregular caved in door.jpg]]
</bootstrap_card>

</div>


There are also atmospheric doorways that are always caved in:

<bootstrap_card class="center-card" header="Atmospheric Caved-In Door" footer="doors like this will always be caved-in and impassible">
[[File:atmospherical door.jpg]]
</bootstrap_card>

=== Chambers and Chest Tiers ===
When a developer designs a chamber, they assign chest rarity to locations in the room. Legendary chest locations will always have a [[Tier 3 Chests]] in that location on every saved run of the dungeon.  Common chest locations may have [[Tier 1 Chests]] or [[Tier 2 Chests]] in that location on each saved run of the dungeon.

<div class="card-deck">

<bootstrap_card header="Legendary Chamber" footer="[[Tier 3 Chests|Tier 3 chest]] behind a gate.">
[[File:tier 3 chest room with gate and friends.jpg]]
</bootstrap_card>
<bootstrap_card header="Legendary Chamber" footer="Tier 3 Chest locations will only ever have Tier 3 chests on successive saved dungeon runs.">
[[File:room with tier 3 chest.jpg]]
</bootstrap_card>
</div>


<div class="card-deck">
<bootstrap_card header="Open Tier 3 Chest" footer="This chest required a switch to be pulled to drop the gate.">
[[File:tier 3 chest open.jpg]]
</bootstrap_card>
<bootstrap_card header="Occupied Chest Location" footer="common chest locations can be different tiers on successive saved dungeon runs">
[[File:common chest location.jpg]]
</bootstrap_card>
<bootstrap_card header="Unoccupied Chest Location" footer="This location may have a [[Tier 1 Chests|Tier 1 Chest]] or [[Tier 2 Chests|Tier 2 Chest]] in another dungeon instance.">
[[File:empty chest location.jpg]]
</bootstrap_card>

</div>

=== Secret Rooms ===
Chambers, except for the end room where "Save The Drone" occurs, may have a number of walls where a locked wooden door can appear. These are affectionally known as "secret doors" and lead to "secret rooms" which are smaller rooms that can be the size of a closet or as large as the smallest chambers. In saved dungeon, secret doors will appear in the same locations with the same secret room behind them.

<div class="card-deck">
<bootstrap_card header="Secret Door" footer="locked wooden doors are affectionately known as secret doors">
[[File:secret door.jpg]]
</bootstrap_card>
<bootstrap_card header="Peek through secret door" footer="players can peek through locked doors to see what is on the other side"">
[[File:peek through secret door.jpg]]
</bootstrap_card>
<bootstrap_card header="Open secret door" footer="once unlocked, players may enter and retrieve items inside.">
[[File:secret open door.jpg]]
</bootstrap_card>
</div>

Secret rooms can also contain chests which assigned chest rarities similar to chambers, legendary chest locations will always have a [[Tier 3 Chests]] in that location on every saved run of the dungeon.  Common chest locations may have [[Tier 1 Chests]] or [[Tier 2 Chests]] in that location on each saved run of the dungeon.

=== Key Locations ===
[[Key|Keys]] can be found located in predetermined places in chambers. These keys are known as "room keys". A room key can be located in one of many different locations in a single chamber. Most chambers, but not all, have one or two room keys.

Players can also get keys as drops from mobs after killing them.

<bootstrap_card class="center-card-wide" header="Room key on the floor" footer="a chamber with its room key">
[[File:key on floor of room.jpg]]
</bootstrap_card>

=== Identifiable Chambers ===
All chambers are shown on the dungeon map at start time. Some chambers can be identified by their size and shape.

<div class="card-deck center-card-wide">
<bootstrap_card header="Dungeon Map" footer="three-story three-chain room as seen from dungeon map">
[[File:point to 3-story chain room.jpg]]
</bootstrap_card>

<bootstrap_card header="In-game Room" footer="three-story three-chain room as seen in game">
[[File: 3-story chain room.jpg]]
</bootstrap_card>

</div>




<div class="card-deck center-card-wide">
<bootstrap_card header="Dungeon Map" footer="start chamber on map">
[[File:start-room-gated-map.jpg]]
</bootstrap_card>

<bootstrap_card header="In-game starting chamber" footer="start chamber with gated rooms">
[[File:start chamber with gated rooms.jpg]]
</bootstrap_card>

</div>


<div class="card-deck center-card-wide">
<bootstrap_card header="Dungeon Map" footer="Arena chamber on map">
[[File:circular-arena-room-map.jpg]]
</bootstrap_card>

<bootstrap_card header="In-game area chamber" footer="Arena chamber in-game">
[[File:circular-arena-room.jpg]]
</bootstrap_card>

</div>


Not all rooms are easy to distinguish from the map, but this room is identifiable because it is a start room and its doorway is vertically midway on its wall.


<div class="card-deck center-card-wide">
<bootstrap_card header="Map" footer="start room mining area on map">
[[File:start-room-mine-area-map.jpg]]
</bootstrap_card>

<bootstrap_card header="Mining Chamber" footer="start room mining area in game">
[[File:start-room-mine-area.jpg]]
</bootstrap_card>

</div>