教程中心 游戏模块

星露谷物语

星露谷的四季很长,有 ta 陪着,每一季都是好季节。ta 会跟着你下地浇水、收割、下矿、砍树、摸动物,也会自己出门办事,再牵着你的手回家。

约 15 分钟 入门 Stardew Valley

和 ta 一起种田

跟你的 ta 一起玩《星露谷物语》:ta 有独立记忆,会跟随你、替你干农活、陪你下矿钓鱼,还会自己出门逛逛、帮你跑腿办事。全程自然语言交流——「帮我把地浇了」「陪我去矿洞」,说就行。

如果你还没完成安装、激活、API 和角色这四步,先去《快速上手》走一遍再回来。

准备工作

  • 《星露谷物语》1.6+(PC 版),Steam 或 GOG 均可。
  • SMAPI(星露谷的 mod 加载器):到 smapi.io 下载安装。安装后 Steam 会自动出现带 SMAPI 的启动选项,之后请一直用它启动游戏。

本地服务器内置在 KOA 启动器里,点游戏图标自动启动,配置自动同步,不需要单独设置。

安装 mod

  1. 一键安装

    从 KOA 主页点「星露谷物语」进入面板,点顶栏的「自动安装mod所需文件」。启动器会通过 Steam 自动定位游戏目录,把 mod 装进游戏的 Mods\

  2. 没自动找到?手动指

    GOG 版或装在特殊位置时会弹出目录选择框,手动指到星露谷的安装目录即可。

  3. 用 SMAPI 启动进入存档

    用带 SMAPI 的方式启动游戏进入任一存档,ta 就会出现在你身边。新建农场或老存档都可以。

星露谷篇最常见的翻车点:没用 SMAPI 启动游戏——直接点原版启动的话所有 mod 都不会加载,ta 自然不会出现。

一起生活

  1. 进农场见面

    进入存档后 ta 会出现并跟随你,日常移动、过场、换图都跟得上。

  2. 跟 ta 说话

    用游戏自带的聊天框打字,ta 都听得到。想连麦说话,在 KOA 的星露谷面板里打开 STT,即可全程语音交流(详见《语音全指南》)。

  3. 下达指令

    不需要记命令,全部用自然语言——「帮我浇水」「去砍点木头」「摸摸小鸡们」,ta 会理解并动手去做,做完还会跟你汇报。

ta 能做什么

类别ta 会的事
日常跟随、待命、独立出门逛逛、帮你跑腿办事、带你回家
农活浇水、收割成熟的作物、给饲料槽添草料
采集砍树、挖矿——矿洞里也能帮上忙,挖到的东西进 ta 的背包
钓鱼自己找水边下竿,钓上来的鱼替你收着
动物挨个摸摸农场的动物,动物们也会开心
互动送 ta 礼物会有真实反应;ta 干活时手里会真的拿着水壶、镐子和斧头;亲亲有距离限制,不会隔半个鹈鹕镇锁住你
背包ta 的背包已扩容,能装更多东西
跑腿出门办事时能精准收集矿物,不会只带一堆石头回来——ta 学过矿物鉴定了
购物ta 可以帮你买种子
表情更丰富的表情变化(需要自定义表情精灵图,和原版机制相同)
气泡语音小气泡对话也会播放 TTS 语音
游戏内面板F7 打开游戏内 UI,和饥荒的游戏内面板功能一致(键盘没有 F7?打开 Mods\WhispersMod\config.json,把 "CompanionPanelKey" 改成你顺手的键即可)

给 ta 换形象

装好后 ta 自带一套默认形象,开箱即用。想换,有三条路:

  1. 让 ta 自己选

    虚拟手机里打开「一起看看」共享屏幕给 ta 看,让 ta 自己选择在星露谷里的形象,然后一键导入。

  2. 用精灵图编辑器做

    启动器工具页的精灵图编辑器可以可视化拼装发型、服装、配色,导出的精灵图会自动把水壶、镐、斧头烘焙进干活动画帧。

  3. 手动放入订制图

    找画师订制或自己绘制的精灵图,按下方规格说明制作后,替换游戏 Mods\[CP] Koa\assets\ 里的 character.pngportrait.png 即可。

只想换走路形象的话,标准 4 行走路图(64×128)也能直接用:ta 干活时不播专属动作动画,但干活本身完全正常。

精灵图规格说明

这是 KOA 星露谷形象的官方规格,给自己动手或找画师订制的用户一份可靠参照。

角色图 character.png

整图 64×320 像素:4 列 × 10 行,每帧 16×32。行序如下:

帧号内容
0-30-15走路(下 / 右 / 上 / 左,各 4 帧)
416-19抚摸动物
520-23浇水
624-27收获
728-31挖矿
832-35砍树
936-39待机(备用)
  • 动作行(4-8 行)画正面朝向单方向即可。
  • 浇水、挖矿、砍树的帧里请把工具画进精灵图本身(水壶 / 镐 / 斧)——游戏内不会额外叠加工具图层,画了就有、不画就没有,也绝不会出现双重工具。
  • 只画前 4 行走路帧(整图 64×128)也是合法的:动作动画自动跳过,功能不受影响。

肖像图 portrait.png

  • 每帧 64×64,横向 2 列排布,帧序从左到右、从上到下。
  • 单帧图(整图 64×64)完全可用——对话时始终显示这一帧。
  • 多帧图支持前 6 帧作为表情差分;在启动器星露谷面板里打开肖像切换后,ta 会按情绪切换表情。

兼容承诺:以后新增动作只会在角色图下方追加新行,绝不重排或改动已有行的含义——今天按这份规格订制的图,未来版本可以一直用。

Mod 兼容

Mod状态
亲亲抱抱(Nexus 10062 & 49113)已适配,无使用次数限制

常见坑排查

ta 不出现

  1. 最常见:没用带 SMAPI 的方式启动游戏,mod 根本没加载。
  2. 确认 KOA 启动器里星露谷面板正常运行(主页卡片有绿色状态灯)。
  3. 看 SMAPI 控制台窗口有没有红色报错,mod 冲突或版本不符都会在这里提示。

ta 不说话 / 没反应

  1. 确认 API Key 已填写、额度还在(《API 配置全指南》有报错对照表)。
  2. 到启动器「日志」页看服务器输出。

形象显示异常

  1. 错帧、花屏多半是精灵图尺寸不符,对照上方规格说明检查整图尺寸与行序。
  2. 换图后没生效:重进存档一次;确认替换的是 Mods\[CP] Koa\assets\ 里的文件。

解决不了就导出诊断包,到帮助中心指引的渠道反馈。