Spherewright

Spherewright

中文 · English

中文

Spherewright 通過 MCP 把外部 AI 智能體接入《戴森球計劃》。它提供結構化觀察和有界動作，同時讓採集、手搓、科研、施工、能量消耗、飛行、物流與保存繼續遵守遊戲的正常機制。

此包包含 Windows x64 版 Spherewright 0.3.3：

• 由《戴森球計劃》加載的 BepInEx 5 Plugin；
• 供外部 Agent 應用連接的單文件自包含 Spherewright.Mcp.exe；
• MCP 同步提供的開局移動 playbook。

用戶不需要源碼倉庫或.NET SDK。

支持範圍

• 《戴森球計劃》0.10.34.28529
• BepInEx 5.4.17
• Windows x64
• 單人和平模式（關閉黑霧/戰鬥）
• 任意沙盒設置和資源倍率；它們會被報告，但不會擴大 Spherewright 的動作能力

v0.3.3 已在本機分別驗證：新建非沙盒 1× 世界、導入非沙盒 100× 世界、導入沙盒 1× 世界。三者均通過正常動作完成第一座建築並保存。Spherewright 不調用沙盒工具，也不注入物品、能量或科技。黑霧/戰鬥、多人或 Nebula，以及廣泛的第三方 Mod 兼容性暫不支持。

安裝並連接 MCP

• 通過 Mod Manager 或 r2modman 安裝 Spherewright 及其 BepInEx 依賴。
• 從所選 Mod profile 啓動一次《戴森球計劃》，讓 Plugin 生成配置和受保護的運行時描述文件。
• 在該 profile 中找到 BepInEx/plugins/Arcueid_77-Spherewright/Spherewright.Mcp.exe。
• 將這個 EXE 註冊爲外部 Agent 應用中的本地 stdio MCP Server。不要在命令行中傳入運行時描述文件、認證 token 或存檔名。
• Spherewright 默認只讀。需要操作遊戲時，在該 profile 的 BepInEx/config/dev.spherewright.bridge.cfg 中設置 Safety.AllowWrites=true，然後重啓遊戲。

直接發給 Agent

連接 Spherewright MCP，先讀取當前遊戲狀態和內置說明。有受保護的續檔入口就繼續，否則創建新檔；如果當前是我手動載入的舊檔，先準備導入並等我明確確認。只按正常遊戲機制推進，遇到卡路或缺電時主動恢復，每完成一條產線就正常保存並彙報。

從新檔開始

讓遊戲停在空閒主菜單，啓用 Safety.AllowWrites 後告訴 Agent 創建一個 Spherewright 新檔。Spherewright 會通過正常新建流程創建和平、非沙盒、1× 世界，內部名稱爲 Spherewright_New_*。Agent 第一次行動前應讀取隨 MCP 發佈的 opening-movement playbook。

讀取舊檔繼續玩

在配置中同時啓用 Safety.AllowWrites=true 與 Safety.AllowUserSaveImport=true，重啓遊戲，然後由玩家在遊戲菜單中手動載入目標和平單人存檔。讓 Agent 準備導入；它會先展示無副作用預檢的說明，並等待你在後續消息中明確確認。確認後，Spherewright 只會通過正常保存 API 創建 Spherewright_Imported_* 獨立副本，原檔不會被覆蓋、改名、刪除或成爲恢復目標。Journal 從導入點開始，不補造此前的首次事件；以後玩家和 Agent 都在副本中繼續。

下載、證據與許可

• GitHub Releases：手動安裝包、校驗和與回滾說明
• v0.3.2：Sol Max 與 Luna Max 雙模型黑盒驗收對比
• 源碼與問題反饋

Spherewright 使用 MIT License。

English

Spherewright connects an external AI agent to Dyson Sphere Program through MCP. It exposes structured observations and bounded actions while keeping harvesting, handcrafting, research, construction, energy use, travel, logistics, and saving inside normal game mechanics.

This package contains Spherewright 0.3.3 for Windows x64:

• a BepInEx 5 Plugin loaded by Dyson Sphere Program;
• a self-contained single-file Spherewright.Mcp.exe for an external Agent application;
• the opening-movement playbook also exposed by the packaged MCP server.

End users do not need the source repository or a.NET SDK.

Supported scope

• Dyson Sphere Program 0.10.34.28529
• BepInEx 5.4.17
• Windows x64
• single-player peaceful mode with Dark Fog/combat disabled
• any sandbox setting or resource multiplier; they are reported but do not expand Spherewright's action surface

v0.3.3 was locally validated in a fresh non-sandbox 1× world, an imported non-sandbox 100× world, and an imported sandbox 1× world. Each used ordinary actions to construct its first building and save normally. Spherewright never calls sandbox tools or injects items, energy, or technologies. Dark Fog/combat, multiplayer or Nebula, and broad third-party Mod compatibility are not supported.

Install and connect MCP

• Install Spherewright and its BepInEx dependency through Mod Manager or r2modman.
• Launch Dyson Sphere Program once from the selected modded profile so the Plugin creates its configuration and protected runtime descriptor.
• In that profile, locate BepInEx/plugins/Arcueid_77-Spherewright/Spherewright.Mcp.exe.
• Register this EXE as a local stdio MCP server in the external Agent application. Do not pass a runtime descriptor, authentication token, or save identity on the command line.
• Spherewright starts observation-only. To allow gameplay actions, set Safety.AllowWrites=true in that profile's BepInEx/config/dev.spherewright.bridge.cfg, then restart the game.

Copy-paste prompt for your Agent

Connect to Spherewright MCP and first read the current game state and bundled guidance. Continue through a protected resume path when available; otherwise create a new world. If I manually loaded an existing save, prepare an import and wait for my explicit confirmation. Use only normal g