Cellular Automata Method for Generating Random Cave-Like Levels
Introduction
It is an old and fairly well documented trick to use cellular automata to generate cave-like structures. The basic idea is to fill the first map randomly, then repeatedly create new maps using the 4-5 rule: a tile becomes a wall if it was a wall and 4 or more of its eight neighbors were walls, or if it was not a wall and 5 or more neighbors were. Put more succinctly, a tile is a wall if the 3x3 region centered on it contained at least 5 walls. Each iteration makes each tile more like its neighbors, and the amount of overall "noise" is gradually reduced:
original: iteration 1: 2: 3: 4:
# ### ## #### ########## #### ########## #### ########## #### ##########
# ## ## ## # # # ##### # ### ####### ### ####### ### #######
# # ## #### # # # # #### # ## ###### ## ###### ## ######
# # # # ## # ### # ### # ## ##### ## ##### ## #####
### # # # # # # ##### ## ##### ## ##### ## ######
# # ## ##### ## ### #### # ## ##### ## ######## ## ########
## #### # # #### #### ## #### ### ## #### #### ## #########
## ## # ## # ## ### #### # ### ### ### ### #### ### ### #########
# ## ### # # ##### ### ### #### ##### ### #### ##### #### #### #########
# # # # # ### # ### ########## ###### ######### ##### ######### #### #########
## ## #### # # ##### ####### #### ######## #### ######## #### ########
#### # # # # # # ####### ## ###### ## ####### ## #######
# ## ## # ##### # ###### # ###### # ######
# # # #### ##### # ###### # ###### # ######
# # # ## ###### # ####### # ####### ## ####### ## #######
# # # #### # ################ ################ ################ ################
If 45% of the original random map contains walls and the process is repeated 5 times, the output might look like the following:
############################################################ ###....####################################.....############ ##......######################..#########.........########## ##......#####################....#######...........####.#### ##......###################.........................##...### ##......##################..........................###...## #........##############.............................###...## #........#############...............................#....## ##.......##############..................................### ##.......###..############..............................#### ##.......##....############.............................#### #..............############...###........................### #...............###########..#####...............##.......## #................#################...............##.......## ##.....#####..........###########....#..........###.......## ##....#######...........########....###.........####......## ##....#######............######....####........#####......## ##....#######.............####....#####.......#####......### #......######..............###....####........####......#### #.......######.............###...####.........###.......#### #........#####.............###..####.....................### ##........####..............#...####.....................### #####......##...................####.....................### ######...........................##.....................#### ######..................................................#### ######.........###.....................####.............#### ######......#########.................######............#### #######....#############.......##############.....###..##### ##############################################..############ ############################################################
Advantages
Some advantages include:
- Procedurally generated so no two levels are (likely) exactly the same.
- Relatively simple concept, and implementation.
- A natural, cave-like map to add variety, uniqueness or an alternative to room-based dungeons.
Disadvantages
Some disadvantages include:
- Generation of isolated cave sections, possibly blocking player advancement (see possible solutions below).
- Probably not appropriate for generating towns, so other map generators will probably need to be implemented.
- Very large maps tend to not look as natural, or may require some very fine tuning.
The isolated cave problem
The problem is that the results are inconsistent. The algorithm prone to generating disconnected maps. See example below:
############################################################ #####################################################..##### #####.....##################...###############............## #####......###########.####....########.#####..............# #####.......#########..###.....###############.............# ####.............#####.###....###################.........## ###...............########...####################........### ##.................#######...####################........### ##.......##.........#####.....##################.........### ##......####.........###.......################...........## ##.....########.................#######..######...........## ##...###########................######...#######..........## #########..######..............######....########........### ########....######..#####......#####.....##########......### #######......#############.....#####.....###########.....### #######.......############......###.......###########.....## #######.......###########.......###.......###########.....## ######.......####..######.......####.......#########......## #####.......####....#####.......####..........######.....### ####........####......####......####...........#####.....### ####.........###.......###......####...##......######.....## ####...##.....###.......#......###########.....#######.....# #####.####.....#####...........############....########....# ##########.....######..........############....#########..## #########.......#####...........##########.....############# #########.......####...............#####........############ ##########......####................###...........########## ###########....#####.....######.....####...........######### ################################...##########.....########## ############################################################
It also sometimes generates maps which consist of one huge open space:
############################################################ ############################################################ #################.####.######..######........############### ########...#####...##...####....####..........######...##### ###.####...####....###..####....####..........#####.....#### ##...###....##.....###...##.....###............###......#### ###.####...........###..........###.....###.........######## ########...........###...........#.......#.........######### #######.............#..............................######### ######.....##..........................................##### ###.......###...........................................#### ##.......####...........................................#### ##......................................................#### ##.....................................................##### ##.....................................................##### #.....................................##...............##### #.....................................##................#### #...........................###......###................#### ##...........###............###.....#####...............#### ###...........#..............##.....######............###### ######.......................##......######........######### ##########..................##.........#####......########## ###########................###..........####......########## ############................#...........####......########## ###.....#####.........##...............#####.......####..### ###.....#####.......#####.............#####..............### ###.....####.......#####..............#####.....##.......### ####...#####.......#####.....#####...######....####.....#### #############.##########....################..############## ############################################################
There are many ways to fix the disjoint segments problem. One approach might be to throw away maps that have disjoint segments in them. Another approach would be to connect the segments after the fact. Another still would be to fill in all but the biggest segment. We can't just retry when we get a disjoint map, because if the map is big then, statistically, that will be almost 100% of the time. Filling in all but the biggest segment will tend to produce a small area in a map that was supposed to be big. Connecting up the regions works, but it tends to look unnatural, as in the example from above, now connected:
############################################################ #####################################################..##### #####.....##################...###############............## #####......###########.####....########....................# #####.......#########..###.....###############.............# ####.............####..###....###################.........## ###...............###.####...####################........### ##.................##.####...####################........### ##.......##.........#.###.....##################.........### ##......####..........##.......################...........## ##.....########.................#######..######...........## ##...###########................######...#######..........## #########..######..............######....########........### ########............#####......#####.....##########......### #######......#############...............###########.....### #######.......############......###.......###########.....## #######.......###########.......###.......###########.....## ######.......####..######.......####.......#########......## #####.......####....#####.......####.....................### ####........####......####......####...........#####.....### ####.........###.......###......####...##......######.....## ####...##.....###.......#......###########.....#######.....# #####.####.....#####...........############....########....# ##########.....######..........############....#########..## #########.......#####...........##########.....############# #########.......####...............#####........############ ##########......####................###...........########## ###########....#####.....######.....####...........######### ################################...##########.....########## ############################################################
Rule Tweaking
The solution to both problems, as it turns out, is to revisit the original cellular automata rules. Recall that the original rule was
- There is a wall initially at P with 45% probability
- In the next generation, there is a wall at spot P if the number of tiles around P which are walls is at least 5
Or, in more compact notation:
- Winit(p) = rand(0,100) < 45
- R(p) = the number of tiles within 1 step of p which are walls
- W'(p) = R(p) >= 5
Now, one of the problems was that we tend to get big, open areas. So why not try filling those areas in? Change the rule to
- W'(p) = R(p) >= 5 or p is in the middle of an open space
Or more formally,
- Rn(p) = the number of tiles within n steps of p which are walls
- W'(p) = R1(p)>=5 || R2(p)=0
So how does it look?
Winit(p) = rand(0,100) < 45 Repeat 5: W'(p) = R1(p) >= 5 || R2(p) <= 1
############################################################ ##....###################################################### #.......###..#####..####....###########################..### #...#.........###.............##########..############....## ##...###...#..###..............########....######..###....## ###...######...#..##...........######.....######....###..### ####..######......##..##........####...#..######....######## ####..###.#.......#...##...#.....##...###..######...######## #####.........##...........##........####.....##.....####### #####.........##...........#.......##.....#.............#### ####...###...##................#...##......###...........### ####...###..##...###....##.....##..##..##..###....##.....### #########..###..####...###.............###..##..####.....### ########...##..#####...##...............#...#...####....#### #######........######......###...##....................##### #######..##.....######....##########...................##### ######..####.......####...#########...................###### ####....####..##....##.....#######...##..............####### ###.....###..#####......#...####....##................###### ##..##..###..###........##.........#....#......##......##### #..####..##...##.................###...##.....####......#### #.....#..###..#..##..........#..###..###.....#####......#### ##.......####.....#...##........##..###....#######......#### ######....###.......................###...#######....####### #######......................##.....###...#######...######## ########.................#######....####...#####....######## ########..............###########..######...........######## #########....####....######################........######### ###################.######################################## ############################################################
This is more interesting - it doesn't have any big open areas, it has a decent layout. It's almost fully connected. Still, it has some new problems: there are isolated single-tile walls in places, and in general it's not very smooth. But with a little tweaking:
Winit(p) = rand(0,100) < 40 Repeat 4: W'(p) = R1(p) >= 5 || R2(p) <= 2 Repeat 3: W'(p) = R1(p) >= 5
############################################################ ###...###########..#############################.....####### ##..........####....################..#########.........#### ##...........##.....####..#########.......####..######...### ##.......#..........###....###.................########..### ##......###........###........................#########..### ##.......##.........#........................##########...## ##.......###...........##.............###....#########.....# ##.......######.......####...........#####....#####........# ###.....#########....#####...........######...#####........# ###########################...........#####...#######.....## #############...###########.............##....########....## ############.........#######...................#######....## ###########...........########......###............##....### ###..#####.............#########...##########............### ##....###...............######################..........#### ###..........................######..#########..........#### ####..........................###.....#######...........#### ####.................##................##................### ####...###..........####...............#..................## ###...#####.........####..............##......##...........# ##....########......#####............####....####..........# ##....#########.....#####............####....####..........# ##.....######.......#####.............##.....####...##.....# ##......##..........#####....................####..####....# ###.................####.........###........############..## ###............##..######.###...############################ ####..........############################################## ######..#################################################### ############################################################
Notice that the initial fill percentage is a little lower, the cutoffs are different, and we switch rules after a few generations. This is more like the desired result. In the Example Output section, you can see some samples with these parameters, at various sizes.
Flood Fill
This algorithm creates good looking caves, but the problem is isolated caves. The way I solved this is by picking a random, open point on the map and flood filling. Any open point outside the flood filled portion gets turned back into a wall. I then check to see if the flood filled portion of the map is more than some threshold percent of the map. If the map is ~45% open it usually looks alright. If the percent is below this, I just start over.
This turns out to work quite well. On large maps, almost always you will select the largest open connected area, and you won't have to restart the regeneration very often, if at all. On very small maps, this doesn't happen as often, but its also very quick to regenerate because the map is small. It ends up that this method just does the right thing to rectify the non-connected maps naturally! -Jlund3
Horizontal Blanking
Another approach to fixing the problem of disconnected areas involves blanking a horizontal strip of walls, about 3 or 4 block tall, in the middle of of the map after the random fill, but before beginning the automata iterations. Depending on the rules, a horizontal strip of sufficient width will prevent a continuous vertical wall from forming, creating disconnected cave sections.
Example Output
Animated GIF of the cellular automata cave process with 12 smoothing iterations (Generated using haskell):
############################## ##..###....###.....########### #...........................## #.................##.........# ##..###..........#######.....# ########.........#######.....# ############......####......## #############...............## ###..########...............## ##....#######...###..#......## ##.....######...#######.....## ##......#####...######......## ##...#...###....#####.......## ##..##.........######.......## ##..........##########......## ###........#####..####.....### ###........####....###.....### ###....##...##.....###.....### ###...####........####......## ###...#####......#####......## ##....#####.....#####.......## ##.....###.....####.........## ##..............##..........## ###.........................## ####........................## ####.......................### ####..........##...........### #####...###..####.........#### ####################.....##### ##############################
############################################################ #########......###...##........####...####.....############# ####............................##.....##............####### ###................###.....##..........................##### ###...............#####...####..........................#### ###...............#####....####............#............#### ####...###.........####.......##.......................##### ##########..........###........##.....................###### ##########...........#..........##...................####### #########.......................#####..............######### ######.........................#######...#......############ #####..........................############....############# ####...........................###########......######..#### ###..........##.................#########................### ##.......#######........#..........######...###.........#### ##......########.......##............###...######.....###### ###.....#######...............#####........########..####### ###......#####...##...........######........################ ###......#####..####...........#####.........############### #######..#####..####............###...........#######....### ########..###...#####......###.................#####......## ########.......######......####.................###.......## ########.......######.......##....##..................##..## #######.......######....##.......####................####..# ######.......#######....###......####..........###..#####..# #####........######.....######....##..........##########...# ######........###........######...............########.....# ##########...............#######.............########.....## #############...#######..###########...##################### ############################################################
################################################################ #######..#####............####..####...###....###########...#### ###......####..................................#########.....### ##.......###.......................................####......### ##......####.............##.........................##......#### ##......#####......##...####................##..............#### ##......##############..#####...............###.............#### ##.....###############...#####...............##........##...#### ##.....################..######.........#.............####...### ##.....################...#####........###............####....## ###.....#####..##...##....####.........###.............###....## ####....####..............###..........###...................### ####....####.............####..........##....................### ###.....####...........#####.........................##.....#### ##.......##............#####....................##..####...##### ##.....................######................###########...##### ###..##........##......###############.....############....##### ########......####....#################..###############..###### #########...#################################################### ################################################################
############################################################ #########......###...##........####...####.....############# ####............................##.....##............####### ###................###.....##..........................##### ###...............#####...####..........................#### ###...............#####....####............#............#### ####...###.........####.......##.......................##### ##########..........###........##.....................###### ##########...........#..........##...................####### #########.......................#####..............######### ######.........................#######...#......############ #####..........................############....############# ####...........................###########......######..#### ###..........##.................#########................### ##.......#######........#..........######...###.........#### ##......########.......##............###...######.....###### ###.....#######...............#####........########..####### ###......#####...##...........######........################ ###......#####..####...........#####.........############### #######..#####..####............###...........#######....### ########..###...#####......###.................#####......## ########.......######......####.................###.......## ########.......######.......##....##..................##..## #######.......######....##.......####.........##.....####..# #####........#######....###......####........#####..#####..# ####........#######.....######...#####.......############..# ####.......######..........####..#########..#############..# ###........#####............###..########################.## ##.........####.............###..################.######..## #....###...####......####....#...######..#######...#####..## #.....#.....##......######.......#####....#####....#####..## #...................######........####....###.....#####...## #....................#####........#####..###......##......## #....................######........########................# ##......#............########.......#######................# ##......##...........#########......#######...............## ###.....#............####...##.....#######..##...........### ###..........#......####...........######..####..........### ##..........####....####...........#####..######.........### ##...........####..#####............##....######.........### ##............###..######......#...........####..........### ##............###..#######.....##........................### ##.......###...#....#######....#..........................## ###......###.........######.........................##.....# ###.......#..........######........#####...........####....# ###............###...######......########.........#####....# ###...........#####..######.....#########.........####.....# ###...........#####.#######.....########...........###.....# ###...........####..########...#########......##...###....## ###...........####...##################......####..###....## ###...........####......##############.......####..###....## ###...........####..........##########........##...###....## ###............####..........#########.............####..### ###...........#####...........#######..............######### ###.....##########............######.......##......######### ##.....###########.....###.....####.......####......######## ##.....############....###......##.......#####........###### ###...##############..#####.............#######.......###### ################################...##..##################### ############################################################
Example Code
C Code
Original article by Jim Babcock
#include <stdio.h>
#include <stdlib.h>
#include <time.h>
#define TILE_FLOOR 0
#define TILE_WALL 1
typedef struct {
int r1_cutoff, r2_cutoff;
int reps;
} generation_params;
int **grid;
int **grid2;
int fillprob = 40;
int r1_cutoff = 5, r2_cutoff = 2;
int size_x = 64, size_y = 20;
generation_params *params;
generation_params *params_set;
int generations;
int randpick(void)
{
if(rand()%100 < fillprob)
return TILE_WALL;
else
return TILE_FLOOR;
}
void initmap(void)
{
int xi, yi;
grid = (int**)malloc(sizeof(int*) * size_y);
grid2 = (int**)malloc(sizeof(int*) * size_y);
for(yi=0; yi<size_y; yi++)
{
grid [yi] = (int*)malloc(sizeof(int) * size_x);
grid2[yi] = (int*)malloc(sizeof(int) * size_x);
}
for(yi=1; yi<size_y-1; yi++)
for(xi=1; xi<size_x-1; xi++)
grid[yi][xi] = randpick();
for(yi=0; yi<size_y; yi++)
for(xi=0; xi<size_x; xi++)
grid2[yi][xi] = TILE_WALL;
for(yi=0; yi<size_y; yi++)
grid[yi][0] = grid[yi][size_x-1] = TILE_WALL;
for(xi=0; xi<size_x; xi++)
grid[0][xi] = grid[size_y-1][xi] = TILE_WALL;
}
void generation(void)
{
int xi, yi, ii, jj;
for(yi=1; yi<size_y-1; yi++)
for(xi=1; xi<size_x-1; xi++)
{
int adjcount_r1 = 0,
adjcount_r2 = 0;
for(ii=-1; ii<=1; ii++)
for(jj=-1; jj<=1; jj++)
{
if(grid[yi+ii][xi+jj] != TILE_FLOOR)
adjcount_r1++;
}
for(ii=yi-2; ii<=yi+2; ii++)
for(jj=xi-2; jj<=xi+2; jj++)
{
if(abs(ii-yi)==2 && abs(jj-xi)==2)
continue;
if(ii<0 || jj<0 || ii>=size_y || jj>=size_x)
continue;
if(grid[ii][jj] != TILE_FLOOR)
adjcount_r2++;
}
if(adjcount_r1 >= params->r1_cutoff || adjcount_r2 <= params->r2_cutoff)
grid2[yi][xi] = TILE_WALL;
else
grid2[yi][xi] = TILE_FLOOR;
}
for(yi=1; yi<size_y-1; yi++)
for(xi=1; xi<size_x-1; xi++)
grid[yi][xi] = grid2[yi][xi];
}
void printfunc(void)
{
int ii;
printf("W[0](p) = rand[0,100) < %i\n", fillprob);
for(ii=0; ii<generations; ii++)
{
printf("Repeat %i: W'(p) = R[1](p) >= %i",
params_set[ii].reps, params_set[ii].r1_cutoff);
if(params_set[ii].r2_cutoff >= 0)
printf(" || R[2](p) <= %i\n", params_set[ii].r2_cutoff);
else
putchar('\n');
}
}
void printmap(void)
{
int xi, yi;
for(yi=0; yi<size_y; yi++)
{
for(xi=0; xi<size_x; xi++)
{
switch(grid[yi][xi]) {
case TILE_WALL: putchar('#'); break;
case TILE_FLOOR: putchar('.'); break;
}
}
putchar('\n');
}
}
int main(int argc, char **argv)
{
int ii, jj;
if(argc < 7) {
printf("Usage: %s xsize ysize fill (r1 r2 count)+\n", argv[0]);
return 1;
}
size_x = atoi(argv[1]);
size_y = atoi(argv[2]);
fillprob = atoi(argv[3]);
generations = (argc-4)/3;
params = params_set = (generation_params*)malloc( sizeof(generation_params) * generations );
for(ii=4; ii+2<argc; ii+=3)
{
params->r1_cutoff = atoi(argv[ii]);
params->r2_cutoff = atoi(argv[ii+1]);
params->reps = atoi(argv[ii+2]);
params++;
}
srand(time(NULL));
initmap();
for(ii=0; ii<generations; ii++)
{
params = ¶ms_set[ii];
for(jj=0; jj<params->reps; jj++)
generation();
}
printfunc();
printmap();
return 0;
}
C# Code
Borrowed from csharpprogramming.tips with permission from owner Adam Rakaska.
public class MapHandler
{
Random rand = new Random();
public int[,] Map;
public int MapWidth { get; set; }
public int MapHeight { get; set; }
public int PercentAreWalls { get; set; }
public MapHandler()
{
MapWidth = 40;
MapHeight = 21;
PercentAreWalls = 40;
RandomFillMap();
}
public void MakeCaverns()
{
// By initilizing column in the outter loop, its only created ONCE
for(int column=0, row=0; row <= MapHeight-1; row++)
{
for(column = 0; column <= MapWidth-1; column++)
{
Map[column,row] = PlaceWallLogic(column,row);
}
}
}
public int PlaceWallLogic(int x,int y)
{
int numWalls = GetAdjacentWalls(x,y,1,1);
if(Map[x,y]==1)
{
if( numWalls >= 4 )
{
return 1;
}
if(numWalls<2)
{
return 0;
}
}
else
{
if(numWalls>=5)
{
return 1;
}
}
return 0;
}
public int GetAdjacentWalls(int x,int y,int scopeX,int scopeY)
{
int startX = x - scopeX;
int startY = y - scopeY;
int endX = x + scopeX;
int endY = y + scopeY;
int iX = startX;
int iY = startY;
int wallCounter = 0;
for(iY = startY; iY <= endY; iY++) {
for(iX = startX; iX <= endX; iX++)
{
if(!(iX==x && iY==y))
{
if(IsWall(iX,iY))
{
wallCounter += 1;
}
}
}
}
return wallCounter;
}
bool IsWall(int x,int y)
{
// Consider out-of-bound a wall
if( IsOutOfBounds(x,y) )
{
return true;
}
if( Map[x,y]==1 )
{
return true;
}
if( Map[x,y]==0 )
{
return false;
}
return false;
}
bool IsOutOfBounds(int x, int y)
{
if( x<0 || y<0 )
{
return true;
}
else if( x>MapWidth-1 || y>MapHeight-1 )
{
return true;
}
return false;
}
public void PrintMap()
{
Console.Clear();
Console.Write(MapToString());
}
string MapToString()
{
string returnString = string.Join(" ", // Seperator between each element
"Width:",
MapWidth.ToString(),
"\tHeight:",
MapHeight.ToString(),
"\t% Walls:",
PercentAreWalls.ToString(),
Environment.NewLine
);
List<string> mapSymbols = new List<string>();
mapSymbols.Add(".");
mapSymbols.Add("#");
mapSymbols.Add("+");
for(int column=0,row=0; row < MapHeight; row++ ) {
for( column = 0; column < MapWidth; column++ )
{
returnString += mapSymbols[Map[column,row]];
}
returnString += Environment.NewLine;
}
return returnString;
}
public void BlankMap()
{
for(int column=0,row=0; row < MapHeight; row++) {
for(column = 0; column < MapWidth; column++) {
Map[column,row] = 0;
}
}
}
public void RandomFillMap()
{
// New, empty map
Map = new int[MapWidth,MapHeight];
int mapMiddle = 0; // Temp variable
for(int column=0,row=0; row < MapHeight; row++) {
for(column = 0; column < MapWidth; column++)
{
// If coordinants lie on the the edge of the map (creates a border)
if(column == 0)
{
Map[column,row] = 1;
}
else if (row == 0)
{
Map[column,row] = 1;
}
else if (column == MapWidth-1)
{
Map[column,row] = 1;
}
else if (row == MapHeight-1)
{
Map[column,row] = 1;
}
// Else, fill with a wall a random percent of the time
else
{
mapMiddle = (MapHeight / 2);
if(row == mapMiddle)
{
Map[column,row] = 0;
}
else
{
Map[column,row] = RandomPercent(PercentAreWalls);
}
}
}
}
}
int RandomPercent(int percent)
{
if(percent>=rand.Next(1,101))
{
return 1;
}
return 0;
}
public MapHandler(int mapWidth, int mapHeight, int[,] map, int percentWalls=40)
{
this.MapWidth = mapWidth;
this.MapHeight = mapHeight;
this.PercentAreWalls = percentWalls;
this.Map = new int[this.MapWidth,this.MapHeight];
this.Map = map;
}
}
Implementations
- C
- Brogue source code
- C#
- Javascript
- Lua
- Python