warfactoryracine/gameData/Biomes/biome_index.json

{
  "biome_system_version": "1.0",
  "description": "Comprehensive biome definitions for WindRegion-based climate simulation system",
  "last_updated": "2024-09-29",

  "classification_system": {
    "special_climate_zones": {
      "description": "Biomes created by extreme weather token accumulation",
      "priority_range": [1, 5],
      "evaluation_order": "first",
      "override_normal_biomes": true
    },
    "normal_biomes": {
      "description": "Standard biomes based on temperature and rainfall patterns",
      "priority_range": [10, 20],
      "evaluation_order": "second",
      "fallback_system": true
    }
  },

  "biome_definitions": {
    "special_climate_zones": [
      {
        "biome_id": "wetlands",
        "file": "wetlands.json",
        "priority": 1,
        "token_requirement": "flood_tokens > flood_threshold",
        "description": "Marshes and swamps from recurring flooding patterns"
      },
      {
        "biome_id": "coastal_plain",
        "file": "coastal_plain.json",
        "priority": 2,
        "token_requirement": "rain_tokens >= 150 AND coastal_proximity <= 5",
        "description": "Low-lying coastal areas with maritime influence and salt-tolerant vegetation"
      },
      {
        "biome_id": "cliffs",
        "file": "cliffs.json",
        "priority": 3,
        "token_requirement": "elevation >= 50 AND coastal_proximity <= 2",
        "description": "Dramatic vertical coastal formations with extreme wind exposure"
      },
      {
        "biome_id": "sandy_coast",
        "file": "sandy_coast.json",
        "priority": 4,
        "token_requirement": "rain_tokens >= 100 AND coastal_proximity <= 3",
        "description": "Expansive sandy beaches and dune systems with tourism potential"
      },
      {
        "biome_id": "rocky_shore",
        "file": "rocky_shore.json",
        "priority": 5,
        "token_requirement": "rain_tokens >= 120 AND coastal_proximity <= 2",
        "description": "Rugged coastal areas with tidal pools and marine ecosystems"
      },
      {
        "biome_id": "hurricane_zone",
        "file": "hurricane_zone.json",
        "priority": 6,
        "token_requirement": "hurricane_tokens > 0",
        "description": "Storm-resistant coastal vegetation in hurricane-prone areas"
      },
      {
        "biome_id": "storm_prairie",
        "file": "storm_prairie.json",
        "priority": 7,
        "token_requirement": "highWind_tokens > storm_threshold AND rain_tokens > 300",
        "description": "Wind-resistant grasslands with adequate moisture"
      },
      {
        "biome_id": "badlands",
        "file": "badlands.json",
        "priority": 8,
        "token_requirement": "highWind_tokens > storm_threshold AND rain_tokens <= 300",
        "description": "Sparse vegetation in extreme wind and drought conditions"
      }
    ],
    "normal_biomes": [
      {
        "biome_id": "tropical_rainforest",
        "file": "tropical_rainforest.json",
        "priority": 10,
        "requirements": "rain_tokens >= 500 AND temperature >= 25",
        "description": "Dense equatorial forests with maximum biodiversity"
      },
      {
        "biome_id": "hot_desert",
        "file": "hot_desert.json",
        "priority": 11,
        "requirements": "rain_tokens <= 50 AND temperature >= 20",
        "description": "Arid regions with minimal vegetation and extreme heat"
      },
      {
        "biome_id": "temperate_forest",
        "file": "temperate_forest.json",
        "priority": 12,
        "requirements": "rain_tokens >= 300 AND temperature >= 15 AND temperature <= 25",
        "description": "Seasonal forests in moderate climate zones"
      },
      {
        "biome_id": "grassland",
        "file": "grassland.json",
        "priority": 13,
        "requirements": "rain_tokens >= 200 AND temperature >= 10",
        "description": "Temperate grasslands ideal for agriculture"
      },
      {
        "biome_id": "tundra",
        "file": "tundra.json",
        "priority": 14,
        "requirements": "temperature <= -10",
        "description": "Arctic regions with permafrost and minimal vegetation"
      },
      {
        "biome_id": "alpine",
        "file": "alpine.json",
        "priority": 15,
        "requirements": "temperature <= 0 AND elevation >= 2000",
        "description": "High-altitude mountain regions above treeline"
      },
      {
        "biome_id": "cold_desert",
        "file": "cold_desert.json",
        "priority": 16,
        "requirements": "rain_tokens <= 30 AND temperature <= 10",
        "description": "High-altitude or high-latitude arid regions with cold temperatures"
      },
      {
        "biome_id": "hills",
        "file": "hills.json",
        "priority": 17,
        "requirements": "elevation >= 500 AND elevation <= 1500 AND rain_tokens >= 150",
        "description": "Rolling hill country with diverse microclimates and mixed vegetation"
      },
      {
        "biome_id": "rocky_plateau",
        "file": "rocky_plateau.json",
        "priority": 18,
        "requirements": "elevation >= 800 AND rain_tokens >= 100 AND rain_tokens <= 400",
        "description": "Elevated flat-topped terrain with exposed bedrock and hardy vegetation"
      },
      {
        "biome_id": "scrubland",
        "file": "scrubland.json",
        "priority": 1,
        "requirements": "fallback_biome",
        "description": "Semi-arid transition zones with sparse vegetation - default fallback biome"
      }
    ]
  },

  "token_thresholds": {
    "climate_zone_tokens": {
      "storm_threshold": 2.0,
      "flood_threshold": 3.0,
      "hurricane_requirement": "wind >= 2.5 AND rain >= 2.0"
    },
    "normal_biome_tokens": {
      "rain_abundant": 500,
      "rain_moderate": 300,
      "rain_limited": 200,
      "rain_minimal": 50,
      "rain_very_minimal": 30
    },
    "temperature_ranges": {
      "tropical": 25,
      "temperate_warm": 20,
      "temperate_cool": 15,
      "cold": 10,
      "freezing": 0,
      "arctic": -10
    },
    "elevation_thresholds": {
      "sea_level": 0,
      "hills": 500,
      "mountains": 1000,
      "high_mountains": 2000,
      "alpine_zone": 2500
    }
  },

  "biome_selection_algorithm": {
    "step_1": "Check special climate zone tokens (priority 1-5)",
    "step_2": "If no special zones match, evaluate normal biomes (priority 10+)",
    "step_3": "Use highest priority match, or fallback to 'scrubland' if none match",
    "step_4": "Apply forest feature integration for forest-compatible biomes"
  },

  "integration_notes": {
    "climate_system": "Biomes are generated from accumulated tokens from mobile WindRegions",
    "congo_vs_sahara": "System designed to create tropical_rainforest (Congo) vs hot_desert (Sahara)",
    "token_accumulation": "Permanent climate record from WindRegion movements over 300 cycles",
    "special_zones": "Extreme weather creates unique biomes not found in traditional climate models",
    "forest_features": "Existing forest features from geological phases influence final biome selection"
  },

  "validation_patterns": {
    "congo_basin": {
      "expected_biome": "tropical_rainforest",
      "token_pattern": "rain_tokens > 500 from ITCZ convergence",
      "latitude": "equatorial (45-55%)"
    },
    "sahara_desert": {
      "expected_biome": "hot_desert",
      "token_pattern": "rain_tokens < 50 due to no ITCZ influence",
      "latitude": "subtropical (25-35%)"
    },
    "hurricane_coasts": {
      "expected_biome": "hurricane_zone",
      "token_pattern": "hurricane_tokens from coastal storm activity"
    }
  }
}