Star CoPlay

StarCoPlay 安装指南

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

开始之前

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

系统要求

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

你还需要

  • ☑ StarCoPlay 内测邀请码 + 平台 Token（）
  • ☑ 约 5 分钟的时间
无需安装 Python 或任何开发工具，全程只需安装 Mod + 游戏内输入指令即可。

准备清单流程图

分两个阶段：先备齐游戏环境，再注册激活账号。回答「是」沿主线一路向下，回答「否」就先去右边补齐，补完连回主线。不知道某一步怎么做？直接点对应的方框，会跳到下方详细教程。

是否是否是否是否是否想要一个 AI 搭子第一阶段 · 准备游戏环境有《星露谷物语》Steam 正版吗？点击查看：准备工作装好 SMAPI加载框架了吗？点击查看第一步：安装 SMAPI装好 StarCoPlayMod 了吗？点击查看第二步：安装 Mod第二阶段 · 注册与激活账号注册官网账号了吗？(注册后为游客)点击前往：注册账号用邀请码激活了吗？(激活得内测身份 + Token)点击前往：用邀请码激活拿到 Token！进游戏激活搭子 →
两个阶段都齐全后，就能在游戏里用 Token 激活搭子了。已经准备好的话，直接跳到下方「第一步」开始安装。

第一步：安装 SMAPI

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

请务必使用最新版 SMAPI 4.5.2。旧版本可能与游戏 1.6.x 或 StarCoPlay 不兼容。如果你此前装过旧版 SMAPI，请用新版覆盖更新。
1

下载 SMAPI

前往 SMAPI 官网下载最新版安装包：

前往官网 smapi.io →

国内访问官网较慢，或下载遇到困难？加入 QQ 内测群，从群文件获取 SMAPI 安装包，我们已备好最新版。

SMAPI 官网下载页截图
2

运行安装程序

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

Windows SMAPI 安装器界面

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

macOS SMAPI 安装器界面
3

验证安装成功

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

游戏启动后窗口标题栏 SMAPI 版本号截图

第二步：安装 StarCoPlay Mod

1

下载 Mod 安装包

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

安装包是一个压缩包，包含 StarCoPlay 文件夹。群文件中始终提供最新版本，我们会持续更新。
2

找到游戏的 Mods 文件夹

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

不知道 Mods 文件夹在哪？按以下步骤找到：
Steam 版（Windows）
  1. 打开 Steam，右键点击「星露谷物语」→ 管理 → 浏览本地文件
  2. 会打开一个文件夹，这就是游戏目录
  3. 在里面找到 Mods 文件夹（如果没有就新建一个）
  4. 把 StarCoPlay 文件夹拖进去
典型路径：
C:\Program Files (x86)\Steam\steamapps\common\Stardew Valley\Mods\StarCoPlay\
在 Steam 中右键游戏 → 浏览本地文件
Steam 版（macOS）
~/Library/Application Support/Steam/steamapps/common/
Stardew Valley/Contents/MacOS/Mods/StarCoPlay/
Mods 文件夹截图 — StarCoPlay 文件夹位置
3

确认文件结构

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

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

第三步：启动游戏与联机

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

通过 SMAPI 启动游戏

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

通过 SMAPI 启动游戏
2

进入存档，建造联机小屋

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

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

开启联机模式

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

游戏中开启联机功能

第四步：配置并启动 AI

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

指令里的下划线「_」怎么打？按住 Shift + 数字键 0 右边的 - 键（Windows 和 Mac 通用）。
务必切换到英文半角输入法，中文输入法下打出的可能是全角字符「＿」，游戏无法识别。
1

绑定账号

/agent_token 你的Token

绑定你的平台账号。Token 在注册并用邀请码激活后生成，可在官网「我的」页面查看复制。

正确示例/agent_token qwertyuiop

⚠️ 注意 agent_token 中间是下划线「_」，不要打成空格；指令和 Token 之间留一个空格，直接接上 Token 即可，不要加括号。

Token 是你的身份凭证，请妥善保管。如果丢失，可在官网「我的」页面重新查看。
2

启动新游戏实例

/agent_new

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

正确示例/agent_new

⚠️ 注意 agent_new 中间是下划线「_」，不要打成空格；这条指令直接输入即可，不需要参数，也不要加括号。

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

127.0.0.1
第二个实例「加入局域网」界面截图
3

启动 AI 控制

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

/agent_control 玩家昵称

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

正确示例/agent_control 小萌妹

⚠️ 注意 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 <描述>反馈问题

还是解决不了？

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

QQ 内测群二维码

QQ 群号

564214272

准备好了吗？

开始注册 →