{
  "_comment": "BUILDABLE ITEMS — cost-based improvements. A build costs the `cost` below (in `resources`) and takes effect when purchased; it is only AVAILABLE once the research it `requires` is complete (data/research.json → `projects.<id>`). `category` says where it applies: `ship` = improve the player's ship, `planet` = improve things on planets, `station` = improve space stations, `general` = new capabilities for the player. `repeatable` builds can be bought more than once (treat as false when absent). Add a build = one entry under `builds` (the key is the build's id). Keys starting with `_` (like `_template`) are documentation, not data. The build state/UI is not implemented yet — this file is the data layer that will drive it.",
  "resources": {
    "credits": {
      "label": "Credits",
      "description": "Money — the galaxy's currency."
    },
    "minerals": {
      "label": "Minerals",
      "description": "Raw materials — mined from resource worlds."
    }
  },
  "builds": {},
  "_template": {
    "label": "Buildable Item",
    "description": "What this is and what it does.",
    "category": "ship",
    "cost": {
      "credits": 250,
      "minerals": 40
    },
    "requires": [],
    "repeatable": false,
    "effects": {},
    "theme": {
      "color": "#ffc94d"
    }
  }
}