terrain-forge 0.4.0

A modular procedural generation engine for terrain, dungeons, and maps
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61

# TerrainForge Showcase

## Showcase 1: Multi-Algorithm Semantic Analysis

TerrainForge provides **13+ procedural generation algorithms** with intelligent **semantic analysis** that understands and classifies the generated terrain.

### Cellular Automata → Cave Systems
![Cellular Regions](demo/output/showcase/cellular_regions.png)
*16 regions classified as Chambers, Tunnels, Alcoves, and Crevices with 4 strategic markers*

### BSP Trees → Structured Dungeons  
![BSP Masks](demo/output/showcase/bsp_masks.png)
*Walkable zones and no-spawn areas automatically identified*

### Room Accretion → Organic Layouts
![Room Regions](demo/output/showcase/rooms_regions.png)
*3 organic regions with natural room-to-hall transitions*

### Maze Generation → Path Networks
![Maze Connectivity](demo/output/showcase/maze_connectivity.png)
*Junction analysis with connectivity graph visualization*

---

## Showcase 2: Advanced Pipeline Composition

**Chain multiple algorithms** together for complex, layered terrain generation with full semantic understanding.

### BSP + Cellular → Structured Caves
```rust
// Generate structured rooms, then apply cellular automata for organic feel
let (grid, semantic) = generate_pipeline("bsp > cellular", 80, 60, seed);
```
![Pipeline BSP Cellular](demo/output/showcase/pipeline_bsp_cellular.png)

### Rooms + Voronoi → Organic Territories  
```rust
// Create rooms, then apply Voronoi for territorial boundaries
let (grid, semantic) = generate_pipeline("rooms | voronoi", 80, 60, seed);
```
![Pipeline Rooms Voronoi](demo/output/showcase/pipeline_rooms_voronoi.png)

### Multi-Stage Complex Pipeline
```rust
// Three-stage generation: caves → rooms → territories
let (grid, semantic) = generate_pipeline("cellular > rooms > voronoi", 80, 60, seed);
```
![Pipeline Complex](demo/output/showcase/pipeline_complex.png)

---

## Key Features Demonstrated

✅ **13+ Generation Algorithms** - Cellular, BSP, Maze, Rooms, Voronoi, DLA, Drunkard Walk, and more  
✅ **Semantic Analysis** - Automatic region classification and marker placement  
✅ **PNG Visualizations** - Color-coded regions, walkable masks, connectivity graphs  
✅ **Pipeline Composition** - Chain algorithms with `>` (sequential) and `|` (parallel)  
✅ **Framework Agnostic** - Works with any grid source or game engine  
✅ **Configurable Systems** - Algorithm-specific optimizations and parameters

*Generate these examples yourself: `cd demo && ./scripts/generate_showcase.sh`*