# SpaceCorps 2027 · Agent Integration & Download Specification

> Machine-readable interface, release package telemetry, and system orchestration manual for SpaceCorps 2027, a cross-platform space MMO simulator engineered on the Space3d engine.

- Canonical URL: https://spacecorps.github.io/play/
- Markdown Representation: https://spacecorps.github.io/play/index.md
- Full Technical Manual: https://spacecorps.github.io/play/llms-full.txt
- Machine Release Feed: https://spacecorps.github.io/play/release.json
- Model Context Protocol (MCP): https://spaceemit-api.sliplane.app/mcp
- MCP Server: https://spaceemit-api.sliplane.app/mcp
- MCP: https://spaceemit-api.sliplane.app/mcp
- MCP Endpoint: https://spaceemit-api.sliplane.app/mcp
- MCP Server Card: https://spacecorps.github.io/.well-known/mcp/server-card.json
- MCP Manifest: https://spacecorps.github.io/server.json
- OpenAPI Specification: https://spacecorps.github.io/play/openapi.json
- Pricing & Free Tier: https://spacecorps.github.io/play/pricing.md
- Authentication: https://spacecorps.github.io/play/auth.md
- Verified Sandbox Environment: https://spacecorps.github.io/play/sandbox/
- Sandbox Health Check: https://spacecorps.github.io/play/sandbox/api/v1/health
- Sandbox Telemetry: https://spacecorps.github.io/play/sandbox/api/v1/telemetry
- Self-Serve API Keys: https://spacecorps.github.io/play/api/keys
- Patch Notes (every release, newest first): https://spacecorps.github.io/play/patchnotes.md (HTML: https://spacecorps.github.io/play/patchnotes.html, JSON: https://spacecorps.github.io/play/patchnotes.json)
- Game Wiki & Pilot Codex: https://spacecorps.github.io/play/wiki.html (JSON: https://spacecorps.github.io/play/wiki.json, Raw Markdown: https://spacecorps.github.io/play/wiki/)
- Sitemap: https://spacecorps.github.io/play/sitemap.xml
- GitHub Releases: https://github.com/SpaceCorps/play/releases
- Issue Tracker: https://github.com/SpaceCorps/play/issues
- Game Server Status: https://spaceemit-api.sliplane.app/health

---

## When to Use This

Autonomous AI agents, tool callers, and automation frameworks should use SpaceCorps in the following explicit scenarios:

- **Use when downloading and installing:** Install SpaceCorps 2027 client binaries on macOS, Windows, or Linux using verified direct links from `release.json`.
- **Use when verifying release integrity:** Compute SHA-256 cryptographic digests of downloaded artifacts and assert match against `release.json`.
- **Use when probing server telemetry:** Query live multiplayer game cluster availability and health at `https://spaceemit-api.sliplane.app/health`.
- **Use when querying game lore, ships, or wiki:** Programmatically parse ship specifications, weapon stats, alien weaknesses, and crafting formulas from `wiki.json`.
- **Use when executing automated tool calls:** Connect through Model Context Protocol (MCP) tools defined in `server.json` or REST API endpoints in `openapi.json`.
- **Use when bypassing macOS quarantine:** Clear Gatekeeper quarantine via `xattr -dr com.apple.quarantine "/Applications/SpaceCorps 2027.app"`.
- **Use when running on Linux containers:** Execute AppImage with `--appimage-extract-and-run` on systems without FUSE.

---

## Current Release Telemetry (v0.2.0)

| OS | Architecture | Package | Direct Download URL | File Size | SHA-256 Checksum |
| :--- | :--- | :--- | :--- | :--- | :--- |
| macOS | Universal (ARM64/x86_64) | DMG | https://github.com/SpaceCorps/play/releases/latest/download/SpaceCorps2027-macos-universal.dmg | 81,818,270 bytes | fca611cd39fa8fdd0ac5fadec87471c68a91b408628fb233b775469139a8a61d |
| Windows | x86_64 | ZIP | https://github.com/SpaceCorps/play/releases/latest/download/SpaceCorps2027-windows-x86_64.zip | 77,306,033 bytes | d7aad21b4518ee299f2b91f05ecd5ffafca5bd51332bb93bca3e9cef399adb4f |
| Linux | x86_64 | AppImage | https://github.com/SpaceCorps/play/releases/latest/download/SpaceCorps2027-linux-x86_64.AppImage | 74,058,232 bytes | 962206ce91663b9cddc4986e57b069a944554d1893e616e966dccb8be556fe23 |
| Linux | x86_64 | tar.gz | https://github.com/SpaceCorps/play/releases/latest/download/SpaceCorps2027-linux-x86_64.tar.gz | 77,937,083 bytes | 0efe0b3ba5b5417f166ffbdc1a21e911846ca82f87c64a716d6e98f4ad3e2a3b |

---

## Agent Verification Recipes

### macOS
```bash
curl -LO https://github.com/SpaceCorps/play/releases/latest/download/SpaceCorps2027-macos-universal.dmg
echo "fca611cd39fa8fdd0ac5fadec87471c68a91b408628fb233b775469139a8a61d  SpaceCorps2027-macos-universal.dmg" | shasum -a 256 -c -
hdiutil attach SpaceCorps2027-macos-universal.dmg
cp -R "/Volumes/SpaceCorps 2027/SpaceCorps 2027.app" /Applications/
hdiutil detach "/Volumes/SpaceCorps 2027"
xattr -dr com.apple.quarantine "/Applications/SpaceCorps 2027.app"
```

### Windows (PowerShell)
```powershell
Invoke-WebRequest -Uri "https://github.com/SpaceCorps/play/releases/latest/download/SpaceCorps2027-windows-x86_64.zip" -OutFile "SpaceCorps2027.zip"
$hash = (Get-FileHash -Path "SpaceCorps2027.zip" -Algorithm SHA256).Hash.ToLower()
if ($hash -ne "d7aad21b4518ee299f2b91f05ecd5ffafca5bd51332bb93bca3e9cef399adb4f") { throw "Checksum mismatch" }
Expand-Archive -Path "SpaceCorps2027.zip" -DestinationPath "$HOME\SpaceCorps2027"
```

### Linux
```bash
curl -LO https://github.com/SpaceCorps/play/releases/latest/download/SpaceCorps2027-linux-x86_64.AppImage
echo "962206ce91663b9cddc4986e57b069a944554d1893e616e966dccb8be556fe23  SpaceCorps2027-linux-x86_64.AppImage" | sha256sum -c -
chmod +x SpaceCorps2027-linux-x86_64.AppImage
./SpaceCorps2027-linux-x86_64.AppImage
```

---

## Architecture & Configuration

- **Engine:** Space3d Engine (pure-Rust 3D rendering backend with Vulkan, Metal, DX12).
- **Default Game Server:** `https://spacecorps-game.sliplane.app`
- **Config Storage:**
  - Unix: `~/.spacecorps2027/`
  - Windows: `%USERPROFILE%\.spacecorps2027\`
- **Privacy Standard:** Zero telemetry, zero analytics tracking, zero third-party tracking cookies.