Megastructures

Concept

A megastructure sits at a system object location just like an asteroid or any other body (see locations for the wider model). It needs specific devices to complete. Anyone can contribute - your share is tracked.

Inspect requirements

GET /v1/locations/{code} on a megastructure location returns the standard location payload with an extra megastructure block describing overall progress and a per-device-type tally of needed versus contributed.

$ curl https://api.replicant.space/v1/locations/FLARM-OBJ-1 \
    -H "Authorization: Bearer $API_KEY"

{
  "code": "FLARM-OBJ-1",
  "type": "megastructure",
  "system": "FLARM",
  "megastructure": {
    "name": "Exodus Gate",
    "progress": 0.42,
    "requirements": {
      "surge_plate": { "needed": 12, "contributed": 5 },
      "ftl_beacon": { "needed": 6, "contributed": 3 },
      "autofactory": { "needed": 4, "contributed": 2 }
    }
  },
  "devices": [],
  "inventory": []
}

Contribute devices

Bring devices to the megastructure location, then POST their codes to /v1/locations/{code}/contribute. Accepted devices are consumed by the structure and their codes appear in accepted; anything ineligible (wrong type, wrong location, already pledged) comes back in rejected.

$ curl -X POST https://api.replicant.space/v1/locations/FLARM-OBJ-1/contribute \
    -H "Authorization: Bearer $API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"devices": ["A473F411", "F54FA154"]}'

{
  "location": "FLARM-OBJ-1",
  "accepted": ["A473F411", "F54FA154"],
  "rejected": [],
  "progress": 0.46,
  "status": "contribution_recorded"
}

Leaderboard

GET /v1/leaderboards/megastructure returns the all-time contribution leaderboard across the galaxy, ranked by total devices donated.

$ curl https://api.replicant.space/v1/leaderboards/megastructure \
    -H "Authorization: Bearer $API_KEY"

{
  "leaderboard": [
    { "rank": 1, "replicant": "Bob-19", "devices": 214 },
    { "rank": 2, "replicant": "Bob-04", "devices": 198 },
    { "rank": 3, "replicant": "Bob-22", "devices": 177 }
  ]
}