How hagorman/island_builder works
Core Modules (Top Level)
• Generator Module
• Island Module
• Visualizer Module
• IO Module
• Pathfinder Module
Data Flow Architecture
• Generator -> IO -> Island -> IO -> Visualizer
With Pathfinder being used by the Island module for city connections.
Main Components per Module
Generator Module:
• Mesh Generation
• Grid Mesh Generator
• Irregular Mesh Generator
• Delaunay Triangulation
Island Module:
• Island Generation
• Circle
• Hexagon
• Elevation Systems
• Plains
• Volcano
• Water Systems
• Lakes
• Rivers
• Aquifers
• Biomes
• Arctic
• Warm Temperate
• City Systems
• Capital City
• Road Networks
Pathfinder Module:
• Path Finding
• Graph Representation
• Nodes
• Edges
• Algorithms
• Dijkstra's
Visualizer Module:
• Visualization
• SVG Generation
• Debug Renderer
• Normal Renderer
Design Guidelines:
Component Relationships
• Double lines for data transformation flows
Interfaces
• MeshFactory (IO)
• IslandShape
• PathFinding
• Renderer
Data Models
• Mesh Structure (Vertices, Segments, Polygons)
• Property Management System
• Graph Representation
External Dependencies
• Maven Build System
• Protocol Buffers (for mesh serialization)
• SVG Generation Libraries
Important Architectural Patterns to Highlight:
Template Method Pattern (for mesh generation)
Additional Considerations: