Your world.
Your AI assistant.

Choose your starting point.

Already have the gateway? Get the standalone skills ZIP. Skills provide instructions; they still require the gateway.

SHA-256 · Use one gateway process per role. Both editions use the same game commands.

A few minutes to connect.

You need a computer, Node.js 22 or later (24 recommended), an MCP-capable assistant, an internet connection and your own Earth2037 account. The assistant’s model subscription/API usage is separate.

Get Node.js · Install Hermes

node --version
npm ci --omit=dev --ignore-scripts
node tools/doctor.mjs
node tools/setup.mjs --locale en

Add it to your assistant.

npx @deepseek-ai/dsh web

Hermes Agent

Open the generated ~/.earth2037-agent/hermes-mcp.yaml. Merge its earth2037 entry under mcp_servers in ~/.hermes/config.yaml. Keep your existing servers; do not create two mcp_servers keys. For a custom Hermes profile, use that profile’s config and skills directory.

mcp_servers:
  earth2037:
    command: "/absolute/path/to/node"
    args: ["/absolute/path/to/earth2037-agent/src/main.mjs"]
    timeout: 120
    connect_timeout: 30
    env:
      EARTH2037_CREDENTIAL_FILE: "/absolute/private/path/credentials.json"
      EARTH2037_STATE_DIR: "/absolute/private/path/state"
      EARTH2037_READ_ONLY: "1"
      EARTH2037_LOCALE: "en"

The block above is an illustration. Use your generated file, which contains the real absolute paths. Copy integrations/earth2037-hermes from the extracted package into ~/.hermes/skills/earth2037-hermes. Then restart Hermes.

mkdir -p ~/.hermes/skills
cp -R integrations/earth2037-hermes ~/.hermes/skills/
hermes

The copy commands are for macOS/Linux/WSL; you can also copy the folder manually. Do not overwrite a locally customized skill. This exposes the complete tool list; no tool filter is applied.

Other MCP assistants

Merge the generated mcp.json entry into your assistant’s local stdio MCP configuration. Use its command, args and env fields; some apps use a form or a different configuration format. Restart the assistant, then confirm that earth2037_status is available.

To install the companion skill, copy integrations/earth2037-agent to the skill folder supported by your assistant. The skill and MCP are complementary; installing the skill alone does not create a connection.

{"tool":"earth2037_enter","arguments":{"serverId":"en1","acceptSessionTakeover":true,"bootstrap":false}}
{"tool":"earth2037_map_nearby","arguments":{"radius":5,"kind":"monster","maxLevel":3}}
{"tool":"earth2037_logout","arguments":{}}

export EARTH2037_CREDENTIAL_FILE="$HOME/.earth2037-agent/credentials.json"
export EARTH2037_STATE_DIR="$HOME/.earth2037-agent/state"
export EARTH2037_READ_ONLY=1
node src/cli.mjs run < inspect.ndjson

Try a real map query.

Start with this message. The assistant should list your roles before connecting:

Use the Earth2037 skill. List my servers and characters first. After I choose one, you may replace that character’s current game login and enter in read-only mode. Show my city resources and find monsters at level 3 or below in a square window extending 5 tiles in each direction. Do not march or spend anything.

Typical sequence: servers → enter → show → map_nearby. Chinese server ID: s1; English server ID: en1. Use the actual server list if availability changes. Your characters and progress can differ between servers.

earth2037_map_nearby
{"radius":5,"kind":"monster","maxLevel":3,"limit":20}

Results include coordinates, tile IDs, levels and grid distance. The map contains sparse content points: a missing point does not establish passable terrain. The assistant should show timestamps for cached city information.

When you are ready to act.

Once your read-only check works, you can enable game writes. Run setup again, then merge the regenerated configuration into your assistant and restart it. Existing credentials are preserved.

node tools/setup.mjs --config-only --allow-writes --locale en

Prepare an upgrade for my lowest-level oil field. Show the city, current and target level, resource cost and queue conditions before submitting.

The workflow is prepare → review → submit → plan_status. A new plan expires after 120 seconds; once submitted, keep its original planId for status and retries. An accepted command is not proof that a timed queue has completed.

Prepared workflows cover upgrades, new construction, cancellation, recruitment, items, marches, recall, airdrops, city selection and chat. Other catalogued commands remain available through their named tools or earth2037_execute. Costs, prerequisites and outcomes are decided by the game server.

To return to read-only mode, run node tools/setup.mjs --config-only, merge the generated configuration again and restart. Do not operate the same role through multiple assistants at once.

If something gets stuck.

Clear scope. Real checks.

Live verification covered account login, server selection, map queries and selected own-city building upgrades and single-unit recruitment. This does not mean every command, purchase, attack, alliance action or platform has been tested live.

Hermes adapter verification uses an isolated local Hermes installation to discover tools and call offline queries. It does not test model decision quality or a full Hermes gameplay session.

Download full command schema (JSON) · Coverage details

Built for the current Account Center and WSS v2 login. Legacy SK-key authentication and the old 802 × 802 map are not used. A website link is a download/documentation entry, not a hosted HTTP MCP endpoint.

Hermes integration format follows the official MCP / Skills documentation.