和 ta 一起种田
跟你的 ta 一起玩《星露谷物语》：ta 有独立记忆，会跟随你、替你干农活、陪你下矿钓鱼，还会自己出门逛逛、帮你跑腿办事。「帮我把地浇了」「陪我去矿洞」，直接说就行。
如果你还没完成安装、激活、API 和角色这四步，先去《快速上手》走一遍再回来。
规矩和小事、让 ta 看见游戏画面、打游戏时发朋友圈这些四个游戏都有的，写在《游戏通用设置》里。
准备工作
- 《星露谷物语》1.6+（PC 版），Steam 或 GOG 均可。
- SMAPI（星露谷的 mod 加载器）：到 smapi.io 下载安装。安装后 Steam 会自动出现带 SMAPI 的启动选项，之后请一直用它启动游戏。
- Content Patcher：ta 的样子靠它读出来，少了它 ta 不会出现。到 Nexus 下载，解压进游戏的
Mods\。忘了装也没关系，KOA 装完 mod 会提醒你「安装完成，还差一个前置」，点「前往下载」就到下载页。
本地服务器内置在 KOA 启动器里，点游戏图标自动启动，配置自动同步，不需要单独设置。
安装 mod
-
一键安装
从 KOA 主页点「星露谷物语」进入面板，点顶栏的「自动安装mod所需文件」。启动器会通过 Steam 自动定位游戏目录，把 mod 装进游戏的
Mods\。 -
没自动找到？手动指
找到了会弹「确认安装目录」，对就点「安装到这里」，不对点「选择其它文件夹」。GOG 版或者装在别处、没找到的，会直接让你选，指到星露谷的安装目录就行。
-
用 SMAPI 启动进入存档
用带 SMAPI 的方式启动游戏进入任一存档，ta 就会出现在你身边。新建农场或老存档都可以。
星露谷篇最常见的翻车点：没用 SMAPI 启动游戏。直接点原版启动的话，所有 mod 都不会加载，ta 自然不会出现。
一起生活
-
进农场见面
进入存档后 ta 会出现并跟随你，日常移动、过场、换图都跟得上。
-
跟 ta 说话
用游戏自带的聊天框打字，ta 都听得到。想开口说，见《游戏通用设置》，按键说话默认是 V。
-
下达指令
不用记命令，「帮我浇水」「去砍点木头」「摸摸小鸡们」，直接说。ta 会动手去做，做完还会跟你说一声。
-
打开面板
按 F7。面板四行：「对话中」/「已暂停」，「跟随中」/「已停放」，「背包」，「正常」/「开挂中」，右边的按钮切换。开挂时 ta 干活快，一下弄一片。
按键在 GMCM 的 KoaMod 设置里改，面板叫「伴侣面板」，说话叫「按住说话」（其实是按一下开始、再按一下结束）。没装 GMCM 的话，改 Mods\KoaMod\config.json 里的 "CompanionPanelKey" 和 "PushToTalkKey"。
1.3.21 起，走路、干活时中文输入法不会再弹出来，打开聊天框它就回来。不想要的话，在 GMCM 的 KoaMod 设置里关掉「自动切换输入法」。
ta 能做什么
| 类别 | ta 会的事 |
|---|---|
| 日常 | 跟随、待命、独立出门逛逛、帮你跑腿办事、带你回家。ta 要带你回家之前会先问你，点「好，回家吧。」就走，点「再待一会儿。」就接着玩 |
| 农活 | 浇水、收割成熟的作物、给饲料槽添草料 |
| 采集 | 砍树、挖矿，矿洞里也能帮上忙，挖到的东西进 ta 的背包 |
| 钓鱼 | 自己找水边下竿，钓上来的鱼替你收着。这张图上没水，ta 会出门找个地方去钓。ta 钓着鱼你走开了，ta 留在那儿接着钓，聊天框里写着「留在……接着钓鱼」，钓到的放进 ta 背包。1.3.20 起 ta 自己出门钓鱼，很少再空手回来 |
| 动物 | 挨个摸摸农场的动物，动物们也会开心 |
| 互动 | 送 ta 礼物会有真实反应；ta 干活时手里会真的拿着水壶、镐子和斧头；亲亲有距离限制，不会隔半个鹈鹕镇锁住你 |
| 背包 | ta 的背包已扩容，能装更多东西 |
| 跑腿 | 去皮埃尔杂货店、玛妮牧场、铁匠铺、鱼店、木匠铺、哈维诊所、下水道帮你买东西，花的是你的钱。也能去矿洞帮你采指定的矿，ta 认得清石头和矿，不会只带一堆石头回来 |
| 没干完的活 | 你睡觉时 ta 还在外面钓鱼、跑腿，第二天早上东西已经在 ta 背包里了，聊天框里会写 ta 昨晚钓到了、买了什么，早上见面 ta 也会说起 |
| 表情 | 更丰富的表情变化（需要自定义表情精灵图，和原版机制相同） |
| 气泡语音 | 小气泡对话也会播放 TTS 语音 |
给 ta 换形象
装好后 ta 自带一套默认形象，开箱即用。想换的话：
-
用精灵图编辑器做
主页「工具」→「星露谷精灵图编辑器」，拼发型、衣服、配色。导出的精灵图会自动把水壶、镐、斧头画进干活的动作里。想让 ta 自己挑，在电脑上打开虚拟手机的「一起看看」App，点「开始共享」，把编辑器的画面给 ta 看。
-
导出，放进游戏
点「导出精灵图」，图会存到你电脑上，提示里写着存在哪。把它复制进游戏的
Mods\[CP] Koa\assets\，重进存档。 -
或者传到资料页，让形象跟着角色走
主页「资料」→「我的恋人」，在这个角色的「贴图」里给「星露谷 精灵图」和「星露谷 肖像」点「上传」。以后切换角色，游戏里的形象跟着换。
找画师订制或者自己画的，照下面的规格说明做好，换掉 Mods\[CP] Koa\assets\ 里的 character.png 和 portrait.png，或者照第 3 步传到资料页。约稿拿到的图格子对不上的，用「工具」里的「精灵图拼豆」裁开，拼成标准精灵图。
只想换走路形象的话，标准 4 行走路图（64×128）也能直接用：ta 干活时不播专属动作动画，但干活本身完全正常。
精灵图规格说明
这是 KOA 星露谷形象的官方规格，给自己动手或找画师订制的用户一份可靠参照。
角色图 character.png
整图 64×384 像素：4 列 × 12 行，每帧 16×32。行从上往下数，最上面是第 1 行：
| 第几行 | 内容 |
|---|---|
| 1 到 4 | 走路（下 / 右 / 上 / 左，各 4 帧） |
| 5 | 抚摸动物 |
| 6 | 浇水 |
| 7 | 收获 |
| 8 | 挖矿 |
| 9 | 砍树 |
| 10 | 待机，出门在外时用 |
| 11 | 花舞节跳舞（女） |
| 12 | 花舞节跳舞（男） |
- 第 5 到 9 行的动作画正面朝向一个方向就行。
- 浇水、挖矿、砍树的帧里，请把工具画进精灵图本身（水壶 / 镐 / 斧）。游戏里不会另外叠一层工具，画了就有，不画就没有，也不会出现两把工具。
- 第 11、12 行是花舞节用的，按角色性别用其中一行。编辑器导出时这两行是空的，要跳舞得自己画上。
- 只画前 4 行走路帧（整图 64×128）也行：动作动画自动跳过，活照样干。
肖像图 portrait.png
- 每帧 64×64，横向 2 列排布，帧序从左到右、从上到下。
- 单帧图（整图 64×64）也能用，对话时一直显示这一帧。
- 多帧图的前 6 帧可以当表情差分。在 KOA 星露谷面板的「表情对照表」里勾上「启用表情切换（自动按情绪切换肖像帧）」，ta 会按情绪换表情。
兼容承诺：以后新增动作只会在角色图下方追加新行，不会重排，也不会改已有行的含义。今天按这份规格订制的图，以后的版本一直能用。
Mod 兼容
| Mod | 状态 |
|---|---|
| 亲亲抱抱（Nexus 10062 & 49113） | 已适配，无使用次数限制 |
常见坑排查
ta 不出现
- 最常见：没用带 SMAPI 的方式启动游戏，mod 根本没加载。
- 没装 Content Patcher。KOA 星露谷面板顶栏下面会多一条提示，写着缺什么，点「前往下载」。
- 确认 KOA 启动器里星露谷面板正常运行（主页卡片有绿色状态灯）。
- 看 SMAPI 控制台窗口有没有红色报错，mod 冲突或版本不符都会在这里提示。
ta 不说话 / 没反应
- 确认 API Key 已填写、额度还在（《API 配置全指南》有报错对照表）。在面板的「直接聊天（测试用）」里说一句，那边也不回，就是 API 的问题。
- 按 F7 看第一行是不是「已暂停」，是的话点「恢复」。
- 到启动器「日志」页看服务器输出。
形象显示异常
- 错帧、花屏多半是精灵图尺寸不符，对照上方规格说明检查整图尺寸与行序。
- 换图后没生效：重进存档一次；确认替换的是
Mods\[CP] Koa\assets\里的文件。
解决不了就导出诊断包，到帮助中心指引的渠道反馈。