{
  "_comment": "The galaxy is already LIVED IN: it was settled long before the player. For now EVERY planet hosts a settlement (allPlanetsSettled): each world gets the one kind that fits its class (settledKindByClass — a habitable rocky world earns a colony, every other world gets its mining outfit, gas giants ride cloud bases). Flip allPlanetsSettled to false to return to the old probabilistic layer (per-type chance + needs in data/systems.json). The free-space kinds (deepSpaceStation, waypoint) still roll per type. kinds = the shared vocabulary (label, theme, population range, anchor type). Core→rim density gradient lives in data/galaxy.json (settlements.gradient).",
  "allPlanetsSettled": true,
  "settledKindByClass": {
    "rocky": { "habitable": "colony", "default": "miningStation" },
    "gas": "cloudBase",
    "ice": "miningStation",
    "lava": "miningStation"
  },
  "kinds": {
    "colony": {
      "label": "Colony",
      "description": "A settled habitable world — cities, farms, life.",
      "theme": { "color": "#7ce8a4" },
      "population": { "min": 40000, "max": 9000000 },
      "anchor": "planet"
    },
    "miningStation": {
      "label": "Mining Station",
      "description": "Orbital rigs and habitats striping minerals from a resource world.",
      "theme": { "color": "#e8b45f" },
      "population": { "min": 80, "max": 4000 },
      "anchor": "planet"
    },
    "cloudBase": {
      "label": "Cloud Base",
      "description": "A mining city riding the upper clouds of a gas giant.",
      "theme": { "color": "#6fc3e8" },
      "population": { "min": 500, "max": 120000 },
      "anchor": "planet"
    },
    "deepSpaceStation": {
      "label": "Deep-Space Station",
      "description": "A free-floating station adrift in open system space — refinery, gate, or trading post.",
      "theme": { "color": "#c9a7ff" },
      "population": { "min": 200, "max": 60000 },
      "anchor": "space"
    },
    "waypoint": {
      "label": "Waypoint",
      "description": "A small navigation beacon — the faint trace of a crossed galaxy.",
      "theme": { "color": "#8fa0c9" },
      "population": { "min": 0, "max": 12 },
      "anchor": "space"
    }
  }
}