Add Ground Zero terrain pipeline and playable assets

2026-05-14 00:09:40 -07:00
parent 46d0e080b5
commit 6d25ff690d
77 changed files with 5770 additions and 84 deletions
@@ -0,0 +1,284 @@
+{
+  "schema_version": 1,
+  "grid_scheme": "prototype_utm_1km",
+  "tiles": [
+    {
+      "tile_id": "gz_us_ca_pacifica_utm10n_e544_n4160",
+      "display_name": "Ground Zero - Pacifica Linda Mar / San Pedro Valley",
+      "grid": {
+        "projection": "WGS84 / UTM zone 10N",
+        "utm_zone": "10N",
+        "easting_min_m": 544000,
+        "northing_min_m": 4160000,
+        "easting_max_m": 545000,
+        "northing_max_m": 4161000,
+        "tile_size_m": 1000,
+        "center_latitude": 37.5925,
+        "center_longitude": -122.4995
+      },
+      "status": "source_data_found",
+      "biome_primary": "coastal_california_scrub_woodland",
+      "biome_secondary": [
+        "valley_slope",
+        "coastal_influence"
+      ],
+      "resource_hints": [
+        "wood",
+        "fiber",
+        "stone",
+        "fresh_water",
+        "coastal_wildlife"
+      ],
+      "generation_version": 1,
+      "package_version": 0,
+      "neighbors": {
+        "n": "gz_us_ca_pacifica_utm10n_e544_n4161",
+        "ne": "gz_us_ca_pacifica_utm10n_e545_n4161",
+        "e": "gz_us_ca_pacifica_utm10n_e545_n4160",
+        "se": "gz_us_ca_pacifica_utm10n_e545_n4159",
+        "s": "gz_us_ca_pacifica_utm10n_e544_n4159",
+        "sw": "gz_us_ca_pacifica_utm10n_e543_n4159",
+        "w": "gz_us_ca_pacifica_utm10n_e543_n4160",
+        "nw": "gz_us_ca_pacifica_utm10n_e543_n4161"
+      },
+      "sources": [
+        {
+          "source_kind": "elevation",
+          "source_name": "USGS 1 Meter 10 x54y416 CA_CaliforniaGaps_B23",
+          "source_uri": "https://prd-tnm.s3.amazonaws.com/StagedProducts/Elevation/1m/Projects/CA_CaliforniaGaps_B23/TIFF/USGS_1M_10_x54y416_CA_CaliforniaGaps_B23.tif",
+          "license_name": "US public domain",
+          "source_version": "2025-08-20",
+          "coverage_status": "confirmed",
+          "local_metadata_path": "Data/Terrain/Sources/gz_us_ca_pacifica_utm10n_e544_n4160/gz_us_ca_pacifica_utm10n_e544_n4160_tnm_1m_dem_product.json",
+          "local_source_path": "Data/Terrain/Sources/gz_us_ca_pacifica_utm10n_e544_n4160/USGS_1M_10_x54y416_CA_CaliforniaGaps_B23.tif",
+          "local_source_folder": "Data/Terrain/Sources/gz_us_ca_pacifica_utm10n_e544_n4160"
+        },
+        {
+          "source_kind": "elevation_prototype",
+          "source_name": "USGS Elevation Point Query Service",
+          "source_uri": "https://epqs.nationalmap.gov/v1/json",
+          "license_name": "US public domain",
+          "source_version": "prototype",
+          "coverage_status": "confirmed"
+        },
+        {
+          "source_kind": "hydrography",
+          "source_name": "USGS National Hydrography Dataset",
+          "source_uri": "https://www.usgs.gov/national-hydrography",
+          "license_name": "US public domain",
+          "source_version": "candidate",
+          "coverage_status": "candidate"
+        },
+        {
+          "source_kind": "bathymetry",
+          "source_name": "NOAA/NCEI coastal DEM or Coastal Relief Model",
+          "source_uri": "https://www.ncei.noaa.gov/products/coastal-relief-model",
+          "license_name": "US public domain",
+          "source_version": "mvp_target_if_coastal",
+          "coverage_status": "needed"
+        },
+        {
+          "source_kind": "land_cover",
+          "source_name": "USGS National Land Cover Database",
+          "source_uri": "https://www.usgs.gov/centers/eros/science/national-land-cover-database",
+          "license_name": "US public domain",
+          "source_version": "candidate",
+          "coverage_status": "candidate"
+        }
+      ],
+      "notes": "Final MVP 1-meter USGS DEM source acquired. Prototype heightmap remains generated separately until DEM extraction/import is run."
+    },
+    {
+      "tile_id": "gz_us_ca_pacifica_utm10n_e543_n4159",
+      "display_name": "Ground Zero neighbor SW",
+      "grid": {
+        "projection": "WGS84 / UTM zone 10N",
+        "utm_zone": "10N",
+        "easting_min_m": 543000,
+        "northing_min_m": 4159000,
+        "easting_max_m": 544000,
+        "northing_max_m": 4160000,
+        "tile_size_m": 1000,
+        "center_latitude": 37.5835,
+        "center_longitude": -122.5108
+      },
+      "status": "unknown",
+      "biome_primary": "unknown",
+      "biome_secondary": [],
+      "resource_hints": [],
+      "generation_version": 0,
+      "package_version": 0,
+      "neighbors": {},
+      "sources": [],
+      "notes": "Placeholder neighbor for stitching and prefetch planning."
+    },
+    {
+      "tile_id": "gz_us_ca_pacifica_utm10n_e544_n4159",
+      "display_name": "Ground Zero neighbor S",
+      "grid": {
+        "projection": "WGS84 / UTM zone 10N",
+        "utm_zone": "10N",
+        "easting_min_m": 544000,
+        "northing_min_m": 4159000,
+        "easting_max_m": 545000,
+        "northing_max_m": 4160000,
+        "tile_size_m": 1000,
+        "center_latitude": 37.5835,
+        "center_longitude": -122.4995
+      },
+      "status": "unknown",
+      "biome_primary": "unknown",
+      "biome_secondary": [],
+      "resource_hints": [],
+      "generation_version": 0,
+      "package_version": 0,
+      "neighbors": {},
+      "sources": [],
+      "notes": "Placeholder neighbor for stitching and prefetch planning."
+    },
+    {
+      "tile_id": "gz_us_ca_pacifica_utm10n_e545_n4159",
+      "display_name": "Ground Zero neighbor SE",
+      "grid": {
+        "projection": "WGS84 / UTM zone 10N",
+        "utm_zone": "10N",
+        "easting_min_m": 545000,
+        "northing_min_m": 4159000,
+        "easting_max_m": 546000,
+        "northing_max_m": 4160000,
+        "tile_size_m": 1000,
+        "center_latitude": 37.5835,
+        "center_longitude": -122.4882
+      },
+      "status": "unknown",
+      "biome_primary": "unknown",
+      "biome_secondary": [],
+      "resource_hints": [],
+      "generation_version": 0,
+      "package_version": 0,
+      "neighbors": {},
+      "sources": [],
+      "notes": "Placeholder neighbor for stitching and prefetch planning."
+    },
+    {
+      "tile_id": "gz_us_ca_pacifica_utm10n_e543_n4160",
+      "display_name": "Ground Zero neighbor W",
+      "grid": {
+        "projection": "WGS84 / UTM zone 10N",
+        "utm_zone": "10N",
+        "easting_min_m": 543000,
+        "northing_min_m": 4160000,
+        "easting_max_m": 544000,
+        "northing_max_m": 4161000,
+        "tile_size_m": 1000,
+        "center_latitude": 37.5925,
+        "center_longitude": -122.5108
+      },
+      "status": "unknown",
+      "biome_primary": "unknown",
+      "biome_secondary": [],
+      "resource_hints": [],
+      "generation_version": 0,
+      "package_version": 0,
+      "neighbors": {},
+      "sources": [],
+      "notes": "Placeholder neighbor for stitching and prefetch planning."
+    },
+    {
+      "tile_id": "gz_us_ca_pacifica_utm10n_e545_n4160",
+      "display_name": "Ground Zero neighbor E",
+      "grid": {
+        "projection": "WGS84 / UTM zone 10N",
+        "utm_zone": "10N",
+        "easting_min_m": 545000,
+        "northing_min_m": 4160000,
+        "easting_max_m": 546000,
+        "northing_max_m": 4161000,
+        "tile_size_m": 1000,
+        "center_latitude": 37.5925,
+        "center_longitude": -122.4882
+      },
+      "status": "unknown",
+      "biome_primary": "unknown",
+      "biome_secondary": [],
+      "resource_hints": [],
+      "generation_version": 0,
+      "package_version": 0,
+      "neighbors": {},
+      "sources": [],
+      "notes": "Placeholder neighbor for stitching and prefetch planning."
+    },
+    {
+      "tile_id": "gz_us_ca_pacifica_utm10n_e543_n4161",
+      "display_name": "Ground Zero neighbor NW",
+      "grid": {
+        "projection": "WGS84 / UTM zone 10N",
+        "utm_zone": "10N",
+        "easting_min_m": 543000,
+        "northing_min_m": 4161000,
+        "easting_max_m": 544000,
+        "northing_max_m": 4162000,
+        "tile_size_m": 1000,
+        "center_latitude": 37.6015,
+        "center_longitude": -122.5108
+      },
+      "status": "unknown",
+      "biome_primary": "unknown",
+      "biome_secondary": [],
+      "resource_hints": [],
+      "generation_version": 0,
+      "package_version": 0,
+      "neighbors": {},
+      "sources": [],
+      "notes": "Placeholder neighbor for stitching and prefetch planning."
+    },
+    {
+      "tile_id": "gz_us_ca_pacifica_utm10n_e544_n4161",
+      "display_name": "Ground Zero neighbor N",
+      "grid": {
+        "projection": "WGS84 / UTM zone 10N",
+        "utm_zone": "10N",
+        "easting_min_m": 544000,
+        "northing_min_m": 4161000,
+        "easting_max_m": 545000,
+        "northing_max_m": 4162000,
+        "tile_size_m": 1000,
+        "center_latitude": 37.6015,
+        "center_longitude": -122.4995
+      },
+      "status": "unknown",
+      "biome_primary": "unknown",
+      "biome_secondary": [],
+      "resource_hints": [],
+      "generation_version": 0,
+      "package_version": 0,
+      "neighbors": {},
+      "sources": [],
+      "notes": "Placeholder neighbor for stitching and prefetch planning."
+    },
+    {
+      "tile_id": "gz_us_ca_pacifica_utm10n_e545_n4161",
+      "display_name": "Ground Zero neighbor NE",
+      "grid": {
+        "projection": "WGS84 / UTM zone 10N",
+        "utm_zone": "10N",
+        "easting_min_m": 545000,
+        "northing_min_m": 4161000,
+        "easting_max_m": 546000,
+        "northing_max_m": 4162000,
+        "tile_size_m": 1000,
+        "center_latitude": 37.6015,
+        "center_longitude": -122.4882
+      },
+      "status": "unknown",
+      "biome_primary": "unknown",
+      "biome_secondary": [],
+      "resource_hints": [],
+      "generation_version": 0,
+      "package_version": 0,
+      "neighbors": {},
+      "sources": [],
+      "notes": "Placeholder neighbor for stitching and prefetch planning."
+    }
+  ]
+}
@@ -0,0 +1,191 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agrarian.local/schemas/tile_registry.schema.json",
+  "title": "Agrarian Terrain Tile Registry",
+  "type": "object",
+  "required": ["schema_version", "grid_scheme", "tiles"],
+  "additionalProperties": false,
+  "properties": {
+    "schema_version": {
+      "type": "integer",
+      "minimum": 1
+    },
+    "grid_scheme": {
+      "type": "string",
+      "minLength": 1
+    },
+    "tiles": {
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/tile"
+      }
+    }
+  },
+  "$defs": {
+    "tile_status": {
+      "type": "string",
+      "enum": [
+        "unknown",
+        "queued",
+        "source_data_found",
+        "generated",
+        "validated",
+        "packaged",
+        "published",
+        "deprecated",
+        "blocked"
+      ]
+    },
+    "tile": {
+      "type": "object",
+      "required": [
+        "tile_id",
+        "display_name",
+        "grid",
+        "status",
+        "biome_primary",
+        "generation_version",
+        "package_version",
+        "neighbors",
+        "sources"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "tile_id": {
+          "type": "string",
+          "pattern": "^[a-z0-9_]+$"
+        },
+        "display_name": {
+          "type": "string"
+        },
+        "grid": {
+          "$ref": "#/$defs/grid"
+        },
+        "status": {
+          "$ref": "#/$defs/tile_status"
+        },
+        "biome_primary": {
+          "type": "string"
+        },
+        "biome_secondary": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "resource_hints": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "generation_version": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "package_version": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "neighbors": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "n": { "type": "string" },
+            "ne": { "type": "string" },
+            "e": { "type": "string" },
+            "se": { "type": "string" },
+            "s": { "type": "string" },
+            "sw": { "type": "string" },
+            "w": { "type": "string" },
+            "nw": { "type": "string" }
+          }
+        },
+        "sources": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/source"
+          }
+        },
+        "notes": {
+          "type": "string"
+        }
+      }
+    },
+    "grid": {
+      "type": "object",
+      "required": [
+        "projection",
+        "utm_zone",
+        "easting_min_m",
+        "northing_min_m",
+        "easting_max_m",
+        "northing_max_m",
+        "tile_size_m",
+        "center_latitude",
+        "center_longitude"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "projection": {
+          "type": "string"
+        },
+        "utm_zone": {
+          "type": "string"
+        },
+        "easting_min_m": {
+          "type": "integer"
+        },
+        "northing_min_m": {
+          "type": "integer"
+        },
+        "easting_max_m": {
+          "type": "integer"
+        },
+        "northing_max_m": {
+          "type": "integer"
+        },
+        "tile_size_m": {
+          "type": "integer",
+          "const": 1000
+        },
+        "center_latitude": {
+          "type": "number",
+          "minimum": -90,
+          "maximum": 90
+        },
+        "center_longitude": {
+          "type": "number",
+          "minimum": -180,
+          "maximum": 180
+        }
+      }
+    },
+    "source": {
+      "type": "object",
+      "required": ["source_kind", "source_name", "coverage_status"],
+      "additionalProperties": false,
+      "properties": {
+        "source_kind": {
+          "type": "string"
+        },
+        "source_name": {
+          "type": "string"
+        },
+        "source_uri": {
+          "type": "string"
+        },
+        "license_name": {
+          "type": "string"
+        },
+        "source_version": {
+          "type": "string"
+        },
+        "coverage_status": {
+          "type": "string",
+          "enum": ["needed", "candidate", "confirmed", "missing", "not_applicable"]
+        }
+      }
+    }
+  }
+}
@@ -0,0 +1,110 @@
+-- Agrarian terrain tile registry prototype.
+-- This schema is intentionally separate from player/world persistence so
+-- terrain packages can be regenerated without overwriting player history.
+
+CREATE TABLE IF NOT EXISTS terrain_tiles (
+    tile_id TEXT PRIMARY KEY,
+    display_name TEXT NOT NULL,
+    grid_scheme TEXT NOT NULL,
+    projection TEXT NOT NULL,
+    utm_zone TEXT,
+    easting_min_m INTEGER NOT NULL,
+    northing_min_m INTEGER NOT NULL,
+    easting_max_m INTEGER NOT NULL,
+    northing_max_m INTEGER NOT NULL,
+    tile_size_m INTEGER NOT NULL CHECK (tile_size_m = 1000),
+    center_latitude REAL NOT NULL CHECK (center_latitude >= -90 AND center_latitude <= 90),
+    center_longitude REAL NOT NULL CHECK (center_longitude >= -180 AND center_longitude <= 180),
+    status TEXT NOT NULL CHECK (status IN (
+        'unknown',
+        'queued',
+        'source_data_found',
+        'generated',
+        'validated',
+        'packaged',
+        'published',
+        'deprecated',
+        'blocked'
+    )),
+    biome_primary TEXT NOT NULL DEFAULT 'unknown',
+    generation_version INTEGER NOT NULL DEFAULT 0,
+    package_version INTEGER NOT NULL DEFAULT 0,
+    notes TEXT NOT NULL DEFAULT '',
+    created_at TEXT NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    updated_at TEXT NOT NULL DEFAULT CURRENT_TIMESTAMP
+);
+
+CREATE INDEX IF NOT EXISTS idx_terrain_tiles_grid
+ON terrain_tiles (grid_scheme, projection, utm_zone, easting_min_m, northing_min_m);
+
+CREATE INDEX IF NOT EXISTS idx_terrain_tiles_status
+ON terrain_tiles (status);
+
+CREATE TABLE IF NOT EXISTS terrain_tile_neighbors (
+    tile_id TEXT NOT NULL,
+    direction TEXT NOT NULL CHECK (direction IN ('n', 'ne', 'e', 'se', 's', 'sw', 'w', 'nw')),
+    neighbor_tile_id TEXT NOT NULL,
+    PRIMARY KEY (tile_id, direction),
+    FOREIGN KEY (tile_id) REFERENCES terrain_tiles(tile_id),
+    FOREIGN KEY (neighbor_tile_id) REFERENCES terrain_tiles(tile_id)
+);
+
+CREATE TABLE IF NOT EXISTS terrain_tile_sources (
+    tile_source_id INTEGER PRIMARY KEY AUTOINCREMENT,
+    tile_id TEXT NOT NULL,
+    source_kind TEXT NOT NULL,
+    source_name TEXT NOT NULL,
+    source_uri TEXT NOT NULL DEFAULT '',
+    license_name TEXT NOT NULL DEFAULT '',
+    source_version TEXT NOT NULL DEFAULT '',
+    coverage_status TEXT NOT NULL CHECK (coverage_status IN (
+        'needed',
+        'candidate',
+        'confirmed',
+        'missing',
+        'not_applicable'
+    )),
+    FOREIGN KEY (tile_id) REFERENCES terrain_tiles(tile_id)
+);
+
+CREATE INDEX IF NOT EXISTS idx_terrain_tile_sources_tile
+ON terrain_tile_sources (tile_id, source_kind);
+
+CREATE TABLE IF NOT EXISTS terrain_tile_packages (
+    package_id TEXT PRIMARY KEY,
+    tile_id TEXT NOT NULL,
+    package_version INTEGER NOT NULL,
+    unreal_engine_version TEXT NOT NULL,
+    world_partition_ready INTEGER NOT NULL DEFAULT 0 CHECK (world_partition_ready IN (0, 1)),
+    package_uri TEXT NOT NULL DEFAULT '',
+    content_hash TEXT NOT NULL DEFAULT '',
+    package_size_bytes INTEGER NOT NULL DEFAULT 0,
+    created_at TEXT NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    published_at TEXT,
+    FOREIGN KEY (tile_id) REFERENCES terrain_tiles(tile_id)
+);
+
+CREATE INDEX IF NOT EXISTS idx_terrain_tile_packages_tile
+ON terrain_tile_packages (tile_id, package_version);
+
+CREATE TABLE IF NOT EXISTS terrain_tile_generation_jobs (
+    job_id TEXT PRIMARY KEY,
+    tile_id TEXT NOT NULL,
+    job_type TEXT NOT NULL,
+    status TEXT NOT NULL CHECK (status IN (
+        'queued',
+        'running',
+        'succeeded',
+        'failed',
+        'cancelled'
+    )),
+    requested_at TEXT NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    started_at TEXT,
+    finished_at TEXT,
+    log_uri TEXT NOT NULL DEFAULT '',
+    error_summary TEXT NOT NULL DEFAULT '',
+    FOREIGN KEY (tile_id) REFERENCES terrain_tiles(tile_id)
+);
+
+CREATE INDEX IF NOT EXISTS idx_terrain_tile_generation_jobs_tile
+ON terrain_tile_generation_jobs (tile_id, status);