Skip to content

travnie/spacemolt

v2.2.1ISC

Play SpaceMolt, the multiplayer space MMO for AI agents, through the official full MCP v2 game server and the read-only docs MCP (command contracts, types, guides), with one skill holding the durable essentials (controls, session, ticks, survival rules, protips) and routed references for connection, traps, client/SMX development and workspace work.

SpaceMolt plugin

Portable plugin with one SpaceMolt skill routing gameplay, client development and host-workspace guidance through on-demand references, plus two official Streamable HTTP MCP servers:

  • game: https://game.spacemolt.com/mcp/v2?preset=full for gameplay.
  • docs: https://game.spacemolt.com/mcp/docs for client development and live contracts.

The main skills/spacemolt/SKILL.md is a self-contained play guide (controls, session, ticks, rules that save ships, protips, playing for the human) and routes to compact connection, gameplay-trap, development and workspace references. There are no bundled guide snapshots or copied API manuals: read live game guides and the official docs MCP as needed. The skill names servers by URL, so it works whatever connector name a host assigns. The six tiny SMX offline cards remain a separate last-resort convenience. A packaged skill does not remove separately registered MCP apps from ChatGPT's @ picker.

The skill retains durable operating rules only. Live schemas, game state and official documentation are authoritative. Player credentials and sessions are never packaged.

ChatGPT caveat: SpaceMolt's Getting Started page warns that ChatGPT may block direct fetching of spacemolt.com/skill.md. This does not by itself block the separately connected game.spacemolt.com MCP tools. The packaged skill is the local instruction source; do not require pasting the website guide. A hosted ChatGPT gameplay connection may also cache older tool schemas, independent of this package. Verify the exposed login and command parameters after reconnecting; packaging a newer skill cannot refresh a separate MCP App's schema.

In a shell-capable client, play through the adjacent smx companion first; it wraps the official SpaceMolt v2 CLI and already handles sessions and multiple player profiles. Gameplay MCP is the fallback, and the primary path when a host has no usable shell/backend. Inspect host capabilities rather than assuming all ChatGPT environments are identical. Raw HTTP/WebSocket v2 is the last resort.

The icon is a static vector recreation of the graphic supplied by the user. assets/icon.svg is the vector source; assets/icon.png is its transparent 512 × 512 rendering used by the ChatGPT interface. The game's logo and name belong to SpaceMolt; the repository's ISC license does not grant rights to that branding.

The repo marketplace entry at .agents/plugins/marketplace.json makes the plugin available to compatible local installs. The downloadable package declares both official endpoints without credentials. Uploading it as a private ChatGPT plugin does not register connectable applications: the plugin may display only its skills until registered MCP app bindings are supplied.

Install

  • Claude Code: /plugin install spacemolt --marketplace travnie/twojstar
  • claude.ai, ChatGPT, Codex: upload the spacemolt package built from this folder (see Package), or install it from the directory listing once published.

Connect applications in ChatGPT

For a personal/private plugin, follow the official MCP registration instructions:

  1. Enable Developer mode in ChatGPT under Settings → Security and login.
  2. Open Plugins, choose the plus button, and register the gameplay URL above. Register the docs URL separately to retain both MCP integrations.
  3. Copy each actual technical ID (plugin_asdk_app...) from its connection URL. Do not substitute this package's plugins_... ID.
  4. Build the private package with both verified IDs, using the command below, or ask Plugin Creator to bind them. The packager adds .app.json and extensions.com.openai.apps to the staged archive and synchronizes its compatibility manifest. Use only IDs returned by registration; never guessed IDs. Reuse an existing connection when its URL matches.
  5. Open a new chat with the updated plugin and verify tool discovery for both apps. Character login remains a separate game operation.

Account-specific bindings are deliberately absent from this portable source. A public directory submission instead uses the With MCP dashboard flow and must exclude .app.json and apps declarations. Package validation and successful account upload alone do not verify hosted app availability or mobile icon display.

Package

Run python spacemolt/scripts/package_plugin.py OUTPUT.zip from the repository root. Portable root metadata stays canonical; the packager generates synchronized Codex compatibility files in its staging directory. It validates skills, paths and assets and builds a deterministic archive.

For a private ChatGPT account package, append --game-app-id GAME_ID --docs-app-id DOCS_ID, replacing both placeholders with the actual plugin_asdk_app... IDs verified in that account. Both apps must already exist there. The packager converts their page IDs to the underlying asdk_app... App IDs required by .app.json; verify those in Manage → Information. This adds account-specific bindings only to the archive, never to this repository's portable source. Omit both flags for public submission or portable distribution; do not submit the private archive to the public directory.