Appendix A: Project File Structure

When you click Generate Project Structure in the Setup panel, the plugin creates the following directory layout inside your output directory.

Directory tree

<project-root>/
├── Layers/
│   ├── Base/
│   │   ├── aoi_<name>.shp              ← AOI polygon(s)
│   │   └── Base_Grid/
│   │       └── <AOI>/
│   │           ├── Hex_Tiles_<AOI>.shp
│   │           ├── Hex_Grid_Edges_<AOI>.shp
│   │           ├── Intersection_Helpers_<AOI>.shp
│   │           ├── Centroid_Helpers_<AOI>.shp
│   │           └── Segments/            ← only if AOI was segmented
│   │               ├── seg_r0_c0.shp
│   │               └── ...
│   ├── Elevation/
│   │   ├── <source>_<AOI>.tif           ← downloaded DEM raster
│   │   └── HexPalette/
│   │       └── <AOI>_hex_elevation.shp  ← elevation per hex
│   ├── OSM/
│   │   ├── roads.gpkg
│   │   ├── water.gpkg
│   │   ├── landcover.gpkg
│   │   ├── buildings.gpkg
│   │   └── poi.gpkg
│   ├── Mosaic/
│   │   └── <AOI>/
│   │       ├── manual_terrain_forest.shp
│   │       ├── manual_water_lake_major.shp
│   │       ├── manual_road_highway.shp
│   │       └── ...                      ← one shapefile per class
│   ├── Labels/
│   │   └── <category>_<AOI>.shp         ← one per label category
│   └── Reference/
│       └── (OpenTopoMap basemap, if added)
├── Export/
│   ├── <project>_<w>x<h>.png
│   └── ...
└── hexmosaic.project.json               ← saved project settings

QGIS layer groups

The plugin creates these groups in the Layers panel, ordered top to bottom:

Group	Contents
Mosaic	Automated and manual game layers
OSM	Downloaded OpenStreetMap features
Base	AOI polygons, hex grids, helpers
Elevation	DEM rasters and hex elevation layers
Reference	Basemap tiles (OpenTopoMap)

Layers render in this order — Mosaic on top, Reference on the bottom.

Configuration files

File	Location	Purpose
hexmosaic.project.json	Project output directory	Per-project UI state and settings
hexmosaic.config.json	data/ (default) or project directory	Classification thresholds, game classes, processing rules
hexmosaic_profile.json	profiles/	Feature class definitions and OSM tag matching rules
layer_specs.csv	styles/	Maps game layer names to .qml style files

Style files

Style files (.qml) live in the styles/ directory, organized by category:

styles/
├── hex_tiles.qml
├── hex_edges.qml
├── aoi.qml
├── elevation/
│   └── *.qml                ← DEM color ramps
├── osm/
│   ├── roads/
│   ├── water/
│   ├── landcover/
│   ├── buildings/
│   └── poi/
└── layer_specs.csv