Let’s build… a Cave!

This article explains the procedure for version 3.0

In this tutorial, we will build a cave. We will not use Snippets. This article explains how to define your dungeon’s overall design and how to individualize it by adding elements such as water, grass, dirt, boulders…

Space Map

Create a Map and call it „Cave Space“, or any other name. Choose a width, height, tileset, and other settings such as BGM or random encounters. On this map, draw something like this:

From top to bottom:

  • Exactly one ceiling tile
  • One or multiple floor tiles
  • Exactly one wall tile

Impassable Floor Tile?

You can choose impassable tiles such as water, and the algorithm will always ensure the map is playable. However, the very first tile on the left must always be passable.

Using the same Floor Tile multiple times?

Feel free to pick the same tile multiple times, as the screenshot shows. The algorithm picks randomly, so this tile will appear more often.

(Optional) Parallel Events

You can add Events for background effects, such as animal noises or weather effects. Please put them on any other tile than the two tiles we placed before.

Features

This Plugin scans for child maps under your Space map to enable additional features. If you don’t want to use it, simply remove or rename the map.

Tip: To temporarily disable a Feature Map, append a symbol to its name, e.g., „Structures_“

Example: Space Map and a few Child Maps to enable Features

(Optional) Dirt & Shadings

Deep Dive: Post Processing – Shadings

If you want to add some shadings, create a Map, call it Shadings or Dirt (both are okay), and draw something like this:

  • The floor tile on the left
  • One blank tile
  • The variation of the floor tile on the right

Can I use multiple rows?

If you want to transform multiple tiles, you may add more rows.

(Optional) Grass

As an alternative to putting grass on the Space Map, you can also create a Map with the name grass (exactly this name) and draw something like this:

  • The piece on the left must be your floor tile
  • There must be a blank tile
  • Put one grass tile on the right

(Optional) Water

As an alternative to putting water on the Space Map, you can also create a Map with the name water (exactly this name) and draw something like this:

A water tile can override the ceiling tile; this is why the ceiling tile is also on the left.

Don’t be afraid of blocking the player. This plugin uses algorithms and functions to put water only on tiles that will never block the player.

(Optional) Roads

If active, the generator will draw one or more roads to connect the map’s exits.

The rules of the Shadings Map apply. Create a Map, call it Roads (exactly this name), and draw something like this:

(Optional) Details

Create a new Map, call it Details (exactly this name), and put it below the Space Map. Draw something like this:

Wow, this is a lot. If you want to learn how this Map works, read here: Post Processing – Details

Some tips for you:

  • Impassable objects cannot block the player. The plugin uses techniques to ensure the generated map will be playable at all costs.
  • Groups 1 and 2 define green plants; however, the second group has many more plain tiles than the first. This makes plants more likely to grow when the floor is made of grass.
  • The far more right the Region ID 61 is, the less frequently the object will appear.

Loot Chests, Monsters, and other Gameplay-related Objects

We define those objects in a Map called Assets (exactly this name).

Read more: Post Processing – Assets

Chests and monsters can spawn on any floor (but not on the water, ceiling, etc.); we need to add all our dungeon’s floors on the left of every row.

The Region Ids on the left became more relevant. By default, this plugin offers you 3 reserved Ids:

  • 20: Loot chests
  • 21: Monsters
  • 22: A single switch (e.g., for puzzles)

How can I change the number of spawns, and how can I add new assets?

You may use any other Region Id. To add or change Region Ids, or to change the number of how often an object spawns, go into Templates/Plugin Manager.

Plugin Manager & Templates

In the Plugin Manager -> MK_RNGMaps_withoutSnippets -> Templates you can manage Templates. Here you can change or add new rules, e.g. assets or other details such as water, dirt, …

You can look at this later because there is already a pre-defined Template for Caves that provides many rules.

Eventing