How wiktorbor/minecraft-procedural-settlement-generation-project works
GDMC Settlement Generator procedurally turns a Minecraft build area into a medieval settlement: it analyzes terrain, plans districts, roads, and plots, builds biome-aware structures, and flushes accumulated blocks to the world. The main runtime orchestrator is SettlementGenerator; the README documents its stages and the single-buffer write strategy. The graph preserves major documented capabilities, including district MDP assignment, connector paths, and perimeter defenses. Some subsystem links are supported by the README rather than inspected implementation; unsampled source is not assumed to have been read.
Main entry points: settlement_generator.py Generation pipeline · settlement_planner.py Settlement planner · orchestrators Structure builders · main.py Entry point
Components 22
Runtime orchestration
- Entry point
main.py - Generation pipeline
generators/settlement_generator.py
Analysis and planning
- Terrain analysis
analysis/world_analysis.py - District type MDP
ai/district_mdp.py - Settlement planner
planning/settlement_planner.py - District planner
planning/settlement/district_planner.py - Road planner
planning/infrastructure/road_planner.py - Road placement
planning/infrastructure/road_placer.py - Plot planner
planning/settlement/plot_planner.py
Settlement state and data
- Analysis results
data/analysis_results.py - Build area
data/build_area.py - Generation config
data/configurations.py - Settlement entities
data/settlement_entities.py - Settlement state
data/settlement_state.py
Structure construction
- Biome palettes
palette/palette_system.py - Structure selector
structures/structure_selector.py - Structure builders
structures/orchestrators - Build context
structures/base/build_context.py
World interface
- Terrain modification
world_interface/terraforming.py - Block buffer
world_interface/block_buffer.py - World block writer
world_interface/structure_placer.py
Other components
- Minecraft world
Connections 23
- Minecraft world → Entry point: provides world
- Entry point → Generation pipeline: starts generation
- Generation pipeline → Terrain analysis: analyzes terrain
generators/settlement_generator.py - Terrain analysis → Analysis results: produces maps
- Generation pipeline → Settlement planner: plans settlement
generators/settlement_generator.py - Settlement planner → District planner: plans districts
planning/settlement_planner.py - District planner → District type MDP: assigns types
planning/settlement/district_planner.py - Settlement planner → Road planner: plans roads
planning/settlement_planner.py - Generation pipeline → Road placement: places roads
generators/settlement_generator.py - Settlement planner → Plot planner: plans plots
planning/settlement_planner.py - Generation pipeline → Settlement state: updates state
generators/settlement_generator.py - Generation pipeline → Settlement entities: creates markers
generators/settlement_generator.py - Generation pipeline → Biome palettes: selects materials
generators/settlement_generator.py - Generation pipeline → Structure selector: selects buildings
generators/settlement_generator.py - Structure selector → Structure builders: dispatches builds
structures/structure_selector.py - Structure builders → Build context: builds through
structures/orchestrators/fortification.py - Build context → Block buffer: records blocks
structures/base/build_context.py - Generation pipeline → Terrain modification: levels terrain
generators/settlement_generator.py - Generation pipeline → Block buffer: accumulates blocks
generators/settlement_generator.py - Generation pipeline → World block writer: flushes buffer
generators/settlement_generator.py - World block writer → Minecraft world: writes blocks
- Generation pipeline → Settlement state: adds connectors
generators/settlement_generator.py - Generation pipeline → Structure builders: builds fortification
generators/settlement_generator.py