Roguelike: Noise Terrain

Use Godot's FastNoiseLite to generate terrain — create noise, add fractal octaves for detail, shape an island with distance falloff, clean up disconnected tiles with flood fill, and spawn the player.

No login required.

Chapter 1

Noise Fundamentals

FastNoiseLite generates smooth, natural-looking value fields. You'll create a noise generator, sample it across the grid, and threshold values into walls and floors.

Noise-based generation creates terrain that looks natural -- rolling hills, islands, and organic boundaries without any hand-crafting.

Loading game...

Click the game window to interact with it

What You'll Build

You will use Godot's built-in FastNoiseLite to generate terrain that looks like natural geography. Noise functions produce smooth, continuous values across the grid — imagine rolling hills where neighboring points have similar heights. High values become land, low values become water. You'll layer fractal octaves to add coastline detail (each octave adds finer bumps at a smaller scale), then apply distance falloff from the center so edges always become ocean, shaping the noise into an island. Raw noise leaves disconnected land pockets the player can't reach, so you'll clean up with flood fill to keep only the largest connected landmass.

How it works

1
Create a FastNoiseLite generator
FastNoiseLite.new() creates a noise generator. Set its seed from your RandomNumberGenerator so the terrain is reproducible. Set the noise type to TYPE_SIMPLEX_SMOOTH — simplex noise produces smoother gradients than classic Perlin noise, with fewer directional artifacts.
2
Configure frequency and octaves
Frequency controls the scale of the noise features. Low values (0.03-0.05) produce large, smooth landmasses. High values produce small, fragmented terrain. Fractal octaves layer multiple noise samples — each octave doubles the frequency and halves the amplitude, adding finer detail on top of the broad shape.
3
Sample noise across the grid
Loop over every cell and call get_noise_2d(float(x), float(y)). This returns a value between -1.0 and 1.0 for each position. Neighboring cells get similar values, which is what makes the terrain look smooth and natural rather than random.
4
Apply distance falloff for island shaping
Calculate each cell's distance from the grid center. Subtract a factor proportional to that distance from the noise value. Cells near the center keep their values (land stays land), but cells near the edges get pushed below the threshold (becoming water). This shapes the noise field into an island.
5
Threshold into land and water
Compare each adjusted noise value against a threshold (e.g. -0.1). Values above become floor tiles (land), values below stay as wall tiles (water). The threshold controls the ratio of land to water — lower thresholds create more land.
6
Flood fill to remove disconnected land
Noise terrain often leaves isolated land pockets the player can't walk to. Flood fill from a starting floor tile near the center, then turn any unreachable floor tile back into a wall. This keeps only the largest connected landmass.
7
Spawn the player on a valid tile
Scan all remaining floor tiles and pick the one closest to the grid center. Set the player's grid position there and convert to pixel coordinates with map_to_local() for rendering.

Learning Goals

✓FastNoiseLite setup: noise type (TYPE_SIMPLEX_SMOOTH), frequency, seed assignment
✓Sampling noise with get_noise_2d() and understanding the -1.0 to 1.0 output range
✓Fractal octaves — layering multiple noise samples to add coastline detail
✓Distance falloff with clampf() to shape the noise field into an island
✓Flood fill to find connected floor tiles and remove unreachable pockets

GDScript Concepts in This Part

GDScript Randomness Practicerandf_range, randi_range, RandomNumberGenerator, pick_random, rand_weighted, and shuffle bags. Master randomness for spawns, loot, procedural content, and fair variation.GDScript Arrays & Loops PracticeLearn GDScript arrays and loops in Godot 4 with game-ready patterns: iterating with indices, safe removal, sorting enemies by distance, and choosing Array vs typed vs packed arrays.GDScript Procedural Generation PracticeLearn procedural map generation in Godot 4: drunkard's walk, cellular automata, BSP dungeons, noise terrain, flood fill connectivity, and seeded RandomNumberGenerator. Build roguelike dungeon generators in GDScript.

Tips

✨Lower frequency values (0.03-0.05) create larger, smoother landmasses. Higher values (0.08+) create fragmented archipelagos.
✨Apply distance falloff before thresholding so edges always become water — this is what gives you a clean island shape instead of terrain that bleeds off the map edges.
✨If your terrain looks too blobby, increase fractal_octaves from 2 to 4. Each octave adds smaller-scale detail that breaks up smooth coastlines.

What You'll Build

How it works

Create a FastNoiseLite generator

FastNoiseLite.new() creates a noise generator. Set its seed from your RandomNumberGenerator so the terrain is reproducible. Set the noise type to TYPE_SIMPLEX_SMOOTH — simplex noise produces smoother gradients than classic Perlin noise, with fewer directional artifacts.

Configure frequency and octaves

Frequency controls the scale of the noise features. Low values (0.03-0.05) produce large, smooth landmasses. High values produce small, fragmented terrain. Fractal octaves layer multiple noise samples — each octave doubles the frequency and halves the amplitude, adding finer detail on top of the broad shape.

Sample noise across the grid

Loop over every cell and call get_noise_2d(float(x), float(y)). This returns a value between -1.0 and 1.0 for each position. Neighboring cells get similar values, which is what makes the terrain look smooth and natural rather than random.

Apply distance falloff for island shaping

Calculate each cell's distance from the grid center. Subtract a factor proportional to that distance from the noise value. Cells near the center keep their values (land stays land), but cells near the edges get pushed below the threshold (becoming water). This shapes the noise field into an island.

Threshold into land and water

Compare each adjusted noise value against a threshold (e.g. -0.1). Values above become floor tiles (land), values below stay as wall tiles (water). The threshold controls the ratio of land to water — lower thresholds create more land.

Flood fill to remove disconnected land

Noise terrain often leaves isolated land pockets the player can't walk to. Flood fill from a starting floor tile near the center, then turn any unreachable floor tile back into a wall. This keeps only the largest connected landmass.

Spawn the player on a valid tile

Scan all remaining floor tiles and pick the one closest to the grid center. Set the player's grid position there and convert to pixel coordinates with map_to_local() for rendering.

Learning Goals

✓FastNoiseLite setup: noise type (TYPE_SIMPLEX_SMOOTH), frequency, seed assignment

✓Sampling noise with get_noise_2d() and understanding the -1.0 to 1.0 output range

✓Fractal octaves — layering multiple noise samples to add coastline detail

✓Distance falloff with clampf() to shape the noise field into an island

✓Flood fill to find connected floor tiles and remove unreachable pockets

Tips

✨Lower frequency values (0.03-0.05) create larger, smoother landmasses. Higher values (0.08+) create fragmented archipelagos.

✨Apply distance falloff before thresholding so edges always become water — this is what gives you a clean island shape instead of terrain that bleeds off the map edges.

✨If your terrain looks too blobby, increase fractal_octaves from 2 to 4. Each octave adds smaller-scale detail that breaks up smooth coastlines.