Status and downloads API

GET /health

Returns { ok: true, time } for container/load-balancer probes.

GET /server/status

Returns online state, allowed game versions derived from published releases, accepted plugin versions, the newest served plugin version, and server time. If PLUGIN_VERSIONS is configured it controls accepted versions; otherwise published plugin versions populate status.

GET /plugin-releases

{
  "servedPluginVersion": "0.2.1",
  "releases": [
    {
      "gameVersion": "1.40.8",
      "pluginVersion": "0.2.1",
      "fileName": "CompCube-bs1.40.8.dll",
      "sha256": "...",
      "size": 123456,
      "uploadedAt": "2026-08-25T12:00:00.000Z",
      "downloadUrl": "https://api.compcube.net/plugin-releases/1.40.8/download"
    }
  ]
}

Download

GET /plugin-releases/{gameVersion}/download returns the DLL as an attachment with X-CompCube-Plugin-Version and X-Checksum-SHA256 headers. A version without a published manifest/file returns 404.

The internal upload route is not a public developer API. It requires the deploy secret and should be used only by the trusted plugin workflow.