# SpaceCorps 2027 · Comprehensive Agent Manual & Technical Reference > Exhaustive technical documentation, release verification protocol, client-server communications schema, and operational guide for SpaceCorps 2027. - Canonical URL: https://play.spacecorps.tech/ - Machine Summary: https://play.spacecorps.tech/llms.txt - Markdown Page: https://play.spacecorps.tech/index.md - Release Feed: https://play.spacecorps.tech/release.json - Patch Notes: https://play.spacecorps.tech/patchnotes.md (JSON: https://play.spacecorps.tech/patchnotes.json) - Pilot Codex & Game Wiki: https://play.spacecorps.tech/wiki.html (JSON: https://play.spacecorps.tech/wiki.json, Raw Markdown: https://play.spacecorps.tech/wiki/) - Sitemap: https://play.spacecorps.tech/sitemap.xml - Organization Apex: https://spacecorps.github.io/ --- ## 1. System Overview & Technology Stack SpaceCorps 2027 is a real-time multiplayer space combat and trading simulation game client. It is built natively on the Space3d engine, engineered by SpaceCorps. - **Client Language:** Rust 2024 edition. - **Platforms:** A game for computers: macOS (universal, Apple silicon and Intel), Windows (x86_64 and ARM64) and Linux (x86_64 and ARM64). The Android and iOS apps are in development and are not available. An early web version for desktop browsers exists (the address is in `web.json`); it was tested only in Chrome on a computer and is not the main way to play. - **Rendering Technology:** Native graphics backends via Space3d: - macOS: Apple Metal API with native ARM64 Apple Silicon and x86_64 Intel universal binaries. - Windows: Direct3D 12 and Vulkan. - Linux: Vulkan 1.3 with X11 and Wayland support. - **Networking:** Secure WebSockets / TLS with continuous state replication to the Sliplane-hosted dedicated server (`https://spacecorps-game.sliplane.app`). - **Telemetry & Privacy:** Zero surveillance, zero third-party ads, zero tracking cookies. Settings and authentication session tokens are stored locally on the user's filesystem in `~/.spacecorps2027`. --- ## 2. When to Use This Guide AI agents, automated test suites, and scripting environments should invoke this manual for: 1. **Automating Cross-Platform Deployments (macOS, Windows and Linux):** Selecting the exact binary asset URL, extracting files, and handling OS security controls without user intervention. 2. **Deterministic Checksum Validation:** Verifying SHA-256 digests against authoritative build artifacts before launching or redistributing packages. 3. **Multi-Region / Custom Server Redirection:** Configuring client connection files in `~/.spacecorps2027/` to target private shards or staging deployments on Sliplane. 4. **Automated Diagnostic Health Checks:** Querying `https://spacecorps-game.sliplane.app/health` to confirm server readiness. 5. **Localization Resolution:** Mapping user language preferences to the 10 available UI and text catalogs. 6. **Game Systems & Lore Intelligence Retrieval:** Querying `wiki.json` for ship performance tables, alien counter-strategies, and production chains. --- ## 3. Package Inventory & Release Artifacts (v0.5.10) Every release published to `https://github.com/SpaceCorps/play/releases` updates `release.json` with cryptographic digests: ### Asset Matrix 1. **macOS Universal:** - Filename: `SpaceCorps2027-macos-universal.dmg` - Target Architectures: `aarch64` (Apple Silicon M1/M2/M3/M4) + `x86_64` (Intel) - Size: 174,967,348 bytes (175.0 MB) - SHA-256: `640faf9b6c10419683ffc149aa37e4449f9a8d39de7f24ea42abefc435373244` - URL: `https://github.com/SpaceCorps/play/releases/latest/download/SpaceCorps2027-macos-universal.dmg` 2. **Windows x86_64:** - Filename: `SpaceCorps2027-windows-x86_64.zip` - Target Architectures: `x86_64` (AMD64 / Intel 64) - Size: 166,395,589 bytes (166.4 MB) - SHA-256: `beb7b3983ffed9ea4286463bc8576529c25eb285f0cd54bacecd3cfd55832b21` - URL: `https://github.com/SpaceCorps/play/releases/latest/download/SpaceCorps2027-windows-x86_64.zip` 3. **Linux AppImage:** - Filename: `SpaceCorps2027-linux-x86_64.AppImage` - Target Architectures: `x86_64` - Size: 160,651,768 bytes (160.7 MB) - SHA-256: `c3efee4534c04d93375856dec1207e0814319c48f5b6f0a28a01221290f6b8a0` - URL: `https://github.com/SpaceCorps/play/releases/latest/download/SpaceCorps2027-linux-x86_64.AppImage` 4. **Linux Tarball:** - Filename: `SpaceCorps2027-linux-x86_64.tar.gz` - Target Architectures: `x86_64` - Size: 167,231,676 bytes (167.2 MB) - SHA-256: `96760633e5e1e4ff2827927ecd59df1651c1c94a5e117aefed158de9411d2d20` - URL: `https://github.com/SpaceCorps/play/releases/latest/download/SpaceCorps2027-linux-x86_64.tar.gz` 5. **Windows x86_64:** - Filename: `SpaceCorps2027-windows-aarch64.zip` - Target Architectures: `aarch64` - Size: 164,452,806 bytes (164.5 MB) - SHA-256: `ce3f48840a599eeea61fb7fd5efcc4f92a0a4c60d39bad7c4a16e4064d36eb6d` - URL: `https://github.com/SpaceCorps/play/releases/latest/download/SpaceCorps2027-windows-aarch64.zip` 6. **Linux AppImage:** - Filename: `SpaceCorps2027-linux-aarch64.AppImage` - Target Architectures: `aarch64` - Size: 159,013,384 bytes (159.0 MB) - SHA-256: `88aff11f42445c798b1039e0ae716511db64902e6e56b3352a8c3814c412c9e4` - URL: `https://github.com/SpaceCorps/play/releases/latest/download/SpaceCorps2027-linux-aarch64.AppImage` 7. **Linux Tarball:** - Filename: `SpaceCorps2027-linux-aarch64.tar.gz` - Target Architectures: `aarch64` - Size: 165,371,731 bytes (165.4 MB) - SHA-256: `c84773c7ba9c5721a281da83bc83fa5af0828d305ab6fe7e47cea2c037fe2acb` - URL: `https://github.com/SpaceCorps/play/releases/latest/download/SpaceCorps2027-linux-aarch64.tar.gz` Signed checksums: each release also carries `SHA256SUMS` (the SHA-256 of every package above, `https://github.com/SpaceCorps/play/releases/latest/download/SHA256SUMS`) and `SHA256SUMS.minisig`, its signature by the SpaceCorps release key ([minisign](https://jedisct1.github.io/minisign/)). The in-game updater installs an update only when that signature verifies. --- ## 4. Platform Security & Installation Runbooks ### macOS Security Handling Because early test releases do not have an Apple Developer ID notarization ticket, Gatekeeper applies quarantine flags to downloads: 1. **GUI Steps (macOS 15 Sequoia+):** - Drag `SpaceCorps 2027.app` to `/Applications`. - Double-click to launch -> Dialog prompts "SpaceCorps 2027 cannot be opened". Click **Done**. - Navigate to **System Settings > Privacy & Security**. - Scroll to the Security header where it states `"SpaceCorps 2027 was blocked"`. - Click **Open Anyway** and enter your macOS password or Touch ID. 2. **Automated CLI Remediation:** ```bash xattr -dr com.apple.quarantine "/Applications/SpaceCorps 2027.app" ``` ### Windows Security Handling Windows Defender SmartScreen displays a warning on uncataloged executables: 1. Extract the zip: the whole game is in `spacecorps2027.exe` (no `assets` subfolder). 2. Launch `spacecorps2027.exe`. 3. In SmartScreen modal, click **More info** -> **Run anyway**. ### Linux Execution AppImages require execute permissions and user-space FUSE support: ```bash chmod +x SpaceCorps2027-linux-x86_64.AppImage ./SpaceCorps2027-linux-x86_64.AppImage ``` If running in a Docker container or environment without `/dev/fuse`: ```bash ./SpaceCorps2027-linux-x86_64.AppImage --appimage-extract-and-run ``` Alternatively: ```bash tar -xzf SpaceCorps2027-linux-x86_64.tar.gz cd SpaceCorps2027 ./spacecorps2027 ``` --- ## 5. Network Protocol & Infrastructure - **Default Server URL:** `https://spacecorps-game.sliplane.app` - **Health Check:** `GET /health` -> `200 OK` - **Custom Shard Configuration:** Edit the local preferences file: - Unix: `~/.spacecorps2027/settings.json` - Windows: `%USERPROFILE%\.spacecorps2027\settings.json` ```json { "server": "https://custom-shard.sliplane.app", "language": "en" } ``` --- ## 6. Internationalization Matrix SpaceCorps 2027 ships with comprehensive translations across 13 languages: | Code | Language Name | Native Name | Web Address Parameter | | :--- | :--- | :--- | :--- | | `en` | English | English | `https://play.spacecorps.tech/?lang=en` | | `de` | German | Deutsch | `https://play.spacecorps.tech/?lang=de` | | `es` | Spanish | Español | `https://play.spacecorps.tech/?lang=es` | | `fr` | French | Français | `https://play.spacecorps.tech/?lang=fr` | | `it` | Italian | Italiano | not on the download page yet (it shows English) | | `hu` | Hungarian | Magyar | not on the download page yet (it shows English) | | `pt-BR` | Portuguese (Brazil) | Português (Brasil) | `https://play.spacecorps.tech/?lang=pt-BR` | | `sv` | Swedish | Svenska | `https://play.spacecorps.tech/?lang=sv` | | `tr` | Turkish | Türkçe | not on the download page yet (it shows English) | | `ru` | Russian | Русский | `https://play.spacecorps.tech/?lang=ru` | | `ja` | Japanese | 日本語 | `https://play.spacecorps.tech/?lang=ja` | | `ko` | Korean | 한국어 | `https://play.spacecorps.tech/?lang=ko` | | `zh-CN` | Chinese (Simplified) | 简体中文 | `https://play.spacecorps.tech/?lang=zh-CN` | `?lang=` picks the language of the download page (10 of the 13). In the game: Settings › General › Interface Language, or `SPACECORPS_LANG=` for one run. --- ## 7. Pilot Codex & Game Wiki (Machine Feeds) The complete SpaceCorps 2027 knowledge base is programmatically synchronized from the base game repository (`assets/wiki`): - **Interactive Codex Browser:** `https://play.spacecorps.tech/wiki.html` - **Structured JSON Catalog:** `https://play.spacecorps.tech/wiki.json` - **Raw Markdown Archive:** `https://play.spacecorps.tech/wiki/` The catalog contains 77 articles in 6 modules: 1. `01-General`: Danger Sectors, Getting Started in SpaceCorps, Recipe Book and Builds, Spacemap Travel. 2. `02-Ships`: Ironclad, Kitefin, Miyuki, Nomad, Ostirion, Paragon, Protos, Storm, Wraith. 3. `03-Mechanics`: Active Ship Abilities, Achievements, Asteroid Mining, Auction, The Black Hole, Cargo Boxes, Clans, Combat Mechanics, Company Pilots, Daily Rewards, Dark Matter and Dark Matter Plates, Davidski, Dormant Swamp, Drone Mechanics, Dungeons, Drone Formations, Giant Excavator, Groups, The Hangar in Flight, Inventory & Equipment, Invite Friends, P.E.T.s, Pilot Skills, Quests, Ranks, Research, Seasons and Rewards, Servers, Shield Mechanics, Ship Designs, The Signals, Skylab, Solo Gates, Speed Calculation, Statistics, Wipe Timeline & Seasons. 4. `04-Aliens`: Bulwark, Crystalys, Goombah, Phantasm, Seeker. 5. `05-Swarms`: Crystalys Swarm, Dormant Swarm, Goombah Swarm, Phantasm Swarm, Pirate Swarm, Seeker Swarm, Swarms, Tesseract Swarm. 6. `06-Items`: Boosters, Containers, Cosmetics, Drones, Extras, The Forge, Hull Plating, Item Trees, Lasers & Ammo, Items Overview, Propulsion & Speed, Resources, Rockets, Shields & Defense, Special Items.