How louis-e/arnis works
Arnis is a geospatial world generator: users select a real-world area and settings, the program gathers geographic and terrain data, interprets it into terrain and built features, then writes a playable world in supported game formats. The graph emphasizes that workflow and includes documented optional capabilities such as Mapillary imagery and gameplay datapacks. Some subsystem links are supported by the SOURCE INDEX rather than excerpts; unsampled implementation details and UI-to-generation wiring are not inferred.
Main entry points: world_editor/mod.rs World editor · retrieve_data.rs Data retrieval · osm_parser.rs OSM parsing · elevation/mod.rs Elevation data
Components 21
Selection and data
- CLI settings
src/args.rs - Desktop GUI
src/gui.rs - Data retrieval
src/retrieve_data.rs
Geospatial preparation
- OSM parsing
src/osm_parser.rs - Overture data
src/overture/mod.rs - Projection
src/projection/mod.rs - Elevation data
src/elevation/mod.rs - Land cover
src/land_cover/mod.rs
World generation
- Feature processing
src/element_processing/mod.rs - Building generation
src/element_processing/buildings.rs - Terrain generation
src/ground_generation.rs - Cave generation
src/caves/mod.rs
World output
- World editor
src/world_editor/mod.rs - Game world formats
src/world_editor/common.rs
Optional features
- Gameplay datapacks
src/datapack/mod.rs - Mapillary imagery
src/mapillary/mod.rs - Facade pipeline
src/mapillary/pipeline.rs - 3D models
src/models_3d/pipeline.rs - Progress reporting
src/progress.rs
Other components
- Area selector
- Minecraft / Luanti
Connections 23
- Area selector → Desktop GUI: selects area
README.md - Area selector → CLI settings: sets options
README.md - CLI settings → Data retrieval: configures retrieval
src/args.rs - Data retrieval → OSM parsing: provides OSM data
src/retrieve_data.rs - Data retrieval → Projection: uses coordinates
- Data retrieval → Elevation data: fetches elevation
- OSM parsing → Feature processing: dispatches features
src/osm_parser.rs - Overture data → OSM parsing: parses map features
src/overture/mod.rs - Projection → OSM parsing: transforms coordinates
src/osm_parser.rs - Elevation data → Terrain generation: supplies heights
src/elevation/mod.rs - Land cover → Terrain generation: informs surfaces
src/land_cover/mod.rs - Feature processing → Building generation: dispatches buildings
src/element_processing/mod.rs - Feature processing → World editor: places features
- Terrain generation → World editor: sets terrain
- Cave generation → World editor: carves terrain
src/caves/mod.rs - World editor → Game world formats: writes world
src/world_editor/mod.rs - Game world formats → Minecraft / Luanti: opens generated world
README.md - World editor → Gameplay datapacks: adds gameplay extras
src/datapack/mod.rs - Mapillary imagery → Facade pipeline: provides imagery
src/mapillary/pipeline.rs - Facade pipeline → Building generation: exports facade textures
- 3D models → World editor: places 3D models
src/models_3d/pipeline.rs - Data retrieval → Progress reporting: reports progress
src/retrieve_data.rs - Elevation data → Progress reporting: reports progress
src/elevation/mod.rs