StarCoPlay 安装指南

从零开始，5 分钟拥有你的 AI 搭子

📋 开始之前

请确认你具备以下条件，避免安装中途卡住。

系统要求

☑ Windows 10+ 或 macOS 12+
☑ 16GB 内存（需运行两个游戏实例）
☑ 星露谷物语 1.6.x（Steam 版）

你还需要

☑ StarCoPlay 平台 Token（点此注册获取）
☑ 约 5 分钟的时间

💡无需安装 Python 或任何开发工具，全程只需安装 Mod + 游戏内输入指令即可。

🔧 第一步：安装 SMAPI

SMAPI 是星露谷的 Mod 加载框架，类似 Minecraft 的 Forge。StarCoPlay 依赖它运行。

下载 SMAPI

前往 SMAPI 官网下载最新版本：smapi.io

运行安装程序

Windows：解压后双击安装程序，按提示选择游戏目录即可。

macOS：解压后在终端运行 install on Mac.command

验证安装成功

通过 SMAPI 启动游戏，如果窗口标题栏（最上方）出现 SMAPI 版本号，说明安装成功。

📦 第二步：安装 StarCoPlay Mod

下载 Mod 安装包

加入 StarCoPlay QQ 内测群，从群文件中下载最新版本的 StarCoPlay Mod 安装包。

💡QQ 群号会在你注册并通过审核后提供。安装包是一个压缩包，包含 StarCoPlay 文件夹。

找到游戏的 Mods 文件夹

将压缩包中的 StarCoPlay 文件夹放入游戏的 Mods 目录。

💡不知道 Mods 文件夹在哪？按以下步骤找到：

Steam 版（Windows）

打开 Steam，右键点击「星露谷物语」→ 管理 → 浏览本地文件
会打开一个文件夹，这就是游戏目录
在里面找到 Mods 文件夹（如果没有就新建一个）
把 StarCoPlay 文件夹拖进去

典型路径：
C:\Program Files (x86)\Steam\steamapps\common\Stardew Valley\Mods\StarCoPlay\

Steam 版（macOS）

~/Library/Application Support/Steam/steamapps/common/
Stardew Valley/Contents/MacOS/Mods/StarCoPlay/

确认文件结构

安装完成后，Mods 目录下应该有 StarCoPlay 文件夹，里面包含 manifest.json 和 StarCoPlay.dll 等文件。

⚠️不要把 StarCoPlay 文件夹再嵌套一层！应该是 Mods/StarCoPlay/manifest.json，而不是 Mods/StarCoPlay/StarCoPlay/manifest.json。

🎮 第三步：启动游戏与联机

💡AI 搭子以第二个玩家的身份加入你的联机世界。所以你需要先开启联机模式，然后让 AI 加入。

通过 SMAPI 启动游戏

双击桌面上的 SMAPI 图标（或在 Steam 中启动游戏），确保窗口标题栏出现 SMAPI 版本号。

进入存档，建造联机小屋

进入你的存档后，前往木匠罗宾的商店，花费 100 金币 建造一个联机小屋（Cabin）。

⚠️必须先建造联机小屋才能让其他人（包括 AI）加入你的游戏。如果没有小屋，联机模式无法使用。

开启联机模式

在游戏菜单中，选择「主持」（Host），开启联机功能。其他玩家现在可以加入你的世界了。

⌨️ 第四步：配置并启动 AI

在游戏中按 T 打开聊天栏，然后依次输入以下三条指令：

绑定账号

/agent_token [你的 Token]

绑定你的平台账号。Token 在注册时会生成，可在官网账户页面查看。

例如：/agent_token qwertyuiop

⚠️Token 是你的身份凭证，请妥善保管。如果丢失，需要重新注册。

启动新游戏实例

/agent_new

启动第二个星露谷游戏实例。新窗口会自动打开，然后你需要在其中手动加入联机。

例如：/agent_new

新窗口打开后，在其中选择「加入局域网游戏」，地址填：

127.0.0.1

启动 AI 控制

在第一个游戏窗口（主机）的聊天栏中输入：

/agent_control [玩家昵称]

将指定的玩家角色交给 AI 控制。填入第二个实例创建的角色昵称。

例如：/agent_control 小萌妹

✅ 搞定！AI 搭子已上线

🏃AI 角色会开始在农场上自主走动、浇水、收获
💬你可以在聊天框中和它对话，试试说「你好」或「帮我浇一下水」
🎮享受和 AI 搭子一起种田、探矿、过节的时光吧！

⚠️ 内测须知

产品处于内测阶段，AI 搭子可能偶尔做出不太智能的行为，这是正常现象
建议使用新建存档进行体验，避免影响已有进度
遇到问题欢迎反馈，帮助我们改进！

❓ 遇到问题？

常见问题

现象	可能原因	解决方法
指令输入后没反应	Token 输入有误	检查 Token 是否正确，重新复制粘贴
AI 不动 / 无反应	Mod 未正确安装或未加载	检查 Mods 目录和 SMAPI 控制台是否有报错
第二个实例连不上	未开启联机 / 没有联机小屋	确保主机已开启联机且建造了联机小屋
AI 卡在某个位置	寻路被障碍物阻挡	输入 `/agent_gn` 强制让 AI 回家睡觉，下次醒来会重置位置
/agent_new 后窗口没弹出	游戏路径未检测到	确认通过 SMAPI 启动的游戏（标题栏有版本号）
联机搭子加入游戏无法找到房主	房主没有建联机小屋	去罗宾那花 100 金币买一个联机小屋

游戏内指令一览

在游戏中按 T 打开聊天栏输入指令，或输入 /agent_help 查看全部命令。

指令	说明
/agent_token <Token>	设置平台 Token（`clear` 清空）
/agent_control <玩家名>	查看在线玩家 / 设置 AI 控制的玩家
/agent_new	启动第二个游戏实例
/agent <指令>	对 AI 搭子下达自然语言指令
/agent_status	查看 AI 完整状态
/agent_cancel	取消 AI 当前动作
/agent_gn	让搭子回家睡觉
/agent_players	列出在线玩家
/agent_ping	测试服务器连通性
/agent_bug <描述>	反馈问题

还是解决不了？

扫码加入微信内测群，和开发者直接交流，我们会第一时间帮你解决。

📷 微信内测群二维码

准备好了吗？

开始注册 →