Common-Generation-Problems.md

+| **DISCLAIMER** |
+| :------: |
+| *Dev builds of Mythic Dungeons 2.0 are **NOT** available yet!* |
+
+The Mythic Dungeons generator is an incredibly complex system that allows a lot of extremely precise customization. As a result, it's pretty easy to create situations where your dungeon will fail to generate the way you want it to. Here's some possible situations you may encounter and how to troubleshoot them!
+
+## "My procedural dungeon keeps timing out!"
+The generator will try to generate a valid layout as many times as it can within a time limit. If it runs out of time, it will fail and cancel the dungeon. This means your dungeon's *failure rate* is very high, and it is struggling to create a valid layout that meets your rules. Here are some things to check.
+
+**The following things contribute to the failure rate:**
+- High min room counts - The more rooms are generated, the easier it is to collide with an existing room, thus running out of space. The generator will try to change directions if this happens, but if there are no available connections it will fail and try a new layout.
+- Large rooms - Large rooms takes up more space, making it easier for the generator to run out of space.
+- High min room occurrences - The layout is considered invalid if it doesn't generate enough of the configured room.
+
+**The following things _DO NOT_ contribute to the failure rate:**
+- Room whitelists - Whitelists just limit the pool of rooms that can be selected and shouldn't cause a failure.
+- Room blacklists - Blacklists function the same as whitelists, limiting the pool of rooms.
+- Max room occurrences - If a room has already reached its max, it's removed from the pool of rooms.
+- Min & max room depth - A room won't exist in the pool if the generator isn't at a valid depth.
+
+**Last resort: Increasing the generator timeout**
+If your dungeon is STILL having trouble because it's particularly complex, you could try increasing the Generator Timeout in Mythic Dungeons' `config.yml`. This is a LAST RESORT, as your dungeon should not take more than 5 seconds to generate unless you've created an outrageously complicated dungeon. (I.e. 500+ rooms, large rooms, lots of rooms with high min occurrences, etc.)
+
+
+## "My room isn't generating!"
+If a room is never appearing in your dungeon, here are a few possible causes...
+
+**Room depth paradox**
+Your room may be configured to only appear at a depth of 35+... but your dungeon might have only generated 30 rooms. This means the dungeon can never get big enough for your room to appear. Check the console to see how many rooms your dungeon is generating!  
+_WARNING: If your room is ALSO set to have at least 1 min occurrence, the layout will FAIL in this situation!_
+
+**No connectors**
+You may have just forgotten to add connectors to your room, preventing it from appearing. Oops!
+
+**Invalid max occurrences/depth**
+Check your room's YAML file! If max occurrences or max depth are set to 0, that means it will NEVER appear! A value of -1 means "infinite".
+
+**Weight too low (or 0)**
+Your room is too unlikely to spawn, making it so rare it never appears. This is pretty unlikely, but worth checking!
+
+
+