Crawl!

Crawl is a procedural dungeon builder, that can make a sprawling labyrinth in a few quick clicks. Enter a room size, map size - and off you go. Compatible with Smoke&Spectre! for dynamic lighting and able to pre-populate encounters.

Table of Contents

1. Quick Start
2. UI Overview
3. Themes
4. Dynamic Fog / Encounters
5. Debug
6. Support

(back to top)

Quick Start

No time for reading? (Shame on you.) First, remove ALL items from the scene. then click 'Generate'. The extension has base settings already in play to get you started. A map will be generated, and you'll be prompted with a screen for where to save your Crawl! map. (Throw it in maps.)

And your map will also be placed in the scene.

(back to top)

UI Overview

Grid Width and Grid Height are always in play, and are available no matter what type of crawl you are creating. They define how large the map will be, measured in grid units. Note: For those not signed up tot he Battle-System Patreon, maps are limited to 30x20 and below.

Each Layout has it's own settings used in building a map.

Basic

1. Room Size Minimum - The floor value for room size, half of this value is generally applied to the minimum length of the wall.
2. Room Size Maximum - The ceiling value for room size, half of this value is generally applied to the maximum length of the wall.
3. Corridor Number - The maximum value for the amount of doors that will attempt to be applied to each room.
4. Corridor Weight - Additional weighting to attempt keeping corridors closer together.
5. Turning Weight - Weighting to attempt keeping corridors straighter/less turns.

Other Layout Styles..

Will be added in futures update!

(back to top)

Themes

Using the Theme dropdown, you will be able to select a styling for the art used in creating your crawl.

Other Themes..

Will be added in futures update!

(back to top)

Dynamic Fog/Encounters

In order to add dynamic fog data or encounter data, you must create the crawl first. After that is done, the map data is held within the extension until ANOTHER crawl is made, or the page is refreshed.

Clicking 'Generate' for adding Walls for smoke & Spectre will calculate where all the walls and doors are on your map. It will then create the objects necessary for Smoke&Spectre to work. It's a one step process!

For encounter data, you'll want to choose which system you want the data to be created for. Currently, Clash! is the only selection - but GM's Grimoire is up next. You can then select the CR level for the rooms. This is done as a total, in order to build variety. So if you select CR10 - you will get rooms that could include;

1. A CR10 monster.
2. Two CR5 monsters.
3. A CR3 monster, 2 CR1 monsters and one CR5 monster,

CR isn't exact science for difficulty, but this is a random dungeon! Embrace the chaos and be prepared to run if the encounter built is more than you'd want to handle.

After that, click 'Generate' and creatures will be added to all rooms. Select a monster to see it's pre-populated stats in your preferred system.

(back to top)

Debug

As a just-in-case, debugging data is included. After you've built your crawl, you can select 'Show Info' to have an overlay applied detailing the tile keys. 'Remove Info' will clear the overlay. Log Data will output the map key in text form to your browser's console window.

(back to top)

Support

If you have questions, please join the Owlbear Rodeo Discord.

Or you can reach out to me at [email protected]. You can also support these projects at the Battle-System Patreon.

(back to top)

The creature tiles used for the Encounter Generator is from the 'Dungeon Crawl Stone Soup' [CC0] pack. More information can be found at:

• https://github.com/crawl/tiles/tree/master/releases
• https://opengameart.org/content/dungeon-crawl-32x32-tiles
• https://opengameart.org/content/dungeon-crawl-32x32-tiles-supplemental