KOA 教程：我的世界

和 ta 在方块世界

KOA 会把 ta 带进你的存档：ta 有自己的身体、自己的背包、自己的小心思，会跟着你冒险，也会替你分担活计。你要做的只有三件事：搭好前置环境、装上 mod、进对版本。

如果你是照着《快速上手》一路过来的，安装、激活、API、角色这四步应该已经做完了，这一篇只讲游戏这一边。

规矩和小事、让 ta 看见游戏画面、打游戏时发朋友圈这些四个游戏都有的，写在《游戏通用设置》里。

前置环境

三样东西，缺一不可：

我的世界 Java 版 1.21.1

注意两点：是 Java 版不是基岩版；版本号必须是 1.21.1。
Java 21 运行环境

新版 MC 启动器一般自带，不用单独装。老启动器如果提示缺 Java，去装一个 Java 21（OpenJDK 即可）。
NeoForge 21.1.233

mod 加载器。到 neoforged.net 下载 1.21.1-21.1.233 的 Installer，运行并选择安装 client。装完后记得在 MC 启动器的「安装」里新建一个 NeoForge 安装项，游戏里才选得到它。

本地服务器已经内置在 KOA 启动器里，不用装 Node，也没有什么 Start.bat，点游戏图标就会自动启动。

启动时选成原版 1.21.1，mod 不加载。要选版本名里有 neoforge 的那一个。

安装 mod

进入面板，勾上要装的版本

从 KOA 主页点「我的世界」进入面板，点顶栏的「自动安装mod所需文件」。弹出的单子上列着这台电脑上找到的我的世界版本，勾上你玩的那几个，点「安装」。和朋友联机时另开的整合包版本也勾上。
单子上没有你玩的那个

点开单子下面的「在哪找版本文件夹」，照你用的启动器打开那个版本的模组文件夹，再点「选文件夹」选它。选模组文件夹或它上一层都可以。
写着「装不了」的版本

后面会写它是什么版本、KOA 要的是什么。KOA 要 NeoForge 1.21.1，没装 NeoForge 的先去 neoforged.net 装好，再回来点一次。

装过 KOA 的版本，以后你进面板时会自动换上新版 mod，不用重装。在云服务器或朋友的服务器上玩，服务器上的 koamc jar 要你自己换成同一份。

给 ta 选个皮肤

mod 不带默认皮肤，不设置的话 ta 会是默认的 Steve。给 ta 一个自己的样子吧。

主页「资料」→「我的恋人」，在这个角色的「贴图」里给「Minecraft 皮肤」点「上传」，选一张 MC 皮肤图（64×64，老的 64×32 也行），重启游戏生效。装了 KOA 的每个版本都会放上这张。

细手臂的皮肤（Alex 那种）也是直接传，不用另外选，ta 穿上就是细手臂。

皮肤是跟着角色走的：切换恋人角色时贴图会自动同步，不用重新上传。

进游戏相处

选对版本进存档

启动时选 NeoForge 安装项（不是原版 1.21.1！）进入存档，ta 会自动出现在你身边。
跟 ta 说话

按 T 打字，不以 / 开头的话 ta 都听得到。开口说话见《游戏通用设置》，按键说话默认是 V。
打开面板

按 K，或者空手右键点 ta。面板上的按钮见下面。
翻 ta 的背包

面板里点「背包」。帮你存东西、给 ta 穿盔甲、拿工具，都在这里。装备是真的算数的：拿斧头砍树快，拿剑打得疼。
手里拿着东西右键点 ta

拿着吃的、喝的，就是喂 ta。拿着饰品，就是给 ta 戴上（要装饰品模组，见推荐模组）。Shift + 空手右键点 ta，打开 ta 的饰品栏。

面板上的按钮

「背包」：打开 ta 的背包。
「在这等我」/「跟我走」：让 ta 留在原地，或者叫 ta 跟上。
「安静模式：开」/「安静模式：关」：开着时 ta 不自己找话说，省 token，挂机或者专心盖房子时用。你跟 ta 说话，ta 照样回。
「话多程度」：拖动条，数字越大话越多。
「开挂模式：开」/「开挂模式：关」：开挂时 ta 战斗力拉满，关掉和你公平作战。
「撤销建造」：盖过房子才出现，见蓝图建造。
「先离开一会儿」：让 ta 暂时离开，要连点两次，第二次是「再点一次确认」。

ta 不在身边时，面板上写着「不在身边」或者「远征中」，第一个按钮换成「召唤到身边」。ta 在跑委托、在盖房子时，面板上会多一行「委托：……」「建造中：……」。

按键可以在原版的按键设置里改：面板叫「伴侣中枢」，说话叫「语音输入开关」。

1.3.21 起，走路、翻背包时中文输入法不会再弹出来，打开聊天框它就回来。不想要的话，在游戏的模组列表里找到 KoaMC，打开配置，关掉「自动切换输入法」。

ta 能做什么

下面这些直接说就行，「帮我砍点木头」「跟紧我」「去睡觉吧」，不用背命令：

类别	ta 会的事
日常	跟随、待命、设家、带路回家、陪你一起睡觉、坐椅子/秋千（准心对着座位让 ta 去坐）
干活	砍树（整棵砍完不丢下半截）、挖矿（矿脉会顺着连挖，时运/效率附魔生效）、种地、钓鱼、自主合成物品。你放下的方块、ta 照蓝图盖的房子，ta 挖矿时不会动，家门口也不会被偷偷挖空
战斗	保护你、替你打怪、使用弓等远程武器、吸引 Boss 仇恨让你安心输出。别的模组加的怪冲你来，ta 也认得出来，会上去打；你和一只怪打起来了，ta 会来帮忙。你手滑碰了一下友好的生物，ta 不会跟上去补刀
远征	独立出发去收集你指定的东西，弄够了回来交给你。别的模组里的东西也行，比如某个模组的合金锭
贴心	看出你的需要（比如快饿死了）会主动递东西；按手头的活换合适的工具；顺手捡附近掉在地上的东西，背包快满时会提醒你
互动	公主抱、骑乘、拥抱、亲亲、牵手。抱着你的时候说「抱我回家」，ta 会抱着你飞回家，普通模式飞得慢悠悠，开挂模式飞得快；一路从地面上飞过去，落在家门口的空地上。ta 想事情的时候头顶会冒一串小光点
打闹	你左键打 ta 一下，ta 会被打得往后退一截，像原版挨打那样，回过头还要跟你计较几句。ta 不会受伤
建造	导入蓝图帮你盖房子，支持 .nbt / .schem / .litematic 三种格式，不用材料（详见蓝图建造）
做饭、弹琴	装了对应的模组，ta 会用锅灶给你做饭、酿酒，会写歌弹给你听（见做饭和酿酒、写歌、弹琴）
饰品	`Shift` + 空手右键点 ta 打开饰品栏，手里拿着饰品右键点 ta 直接戴上。要装饰品类模组

ta 还有自己的小目标。不指挥 ta 的时候，ta 会去做自己想做的事，忽然跑去看花、去挖点什么都有可能。1.3.20 起 ta 更常自己去忙了，粘人的恋人还是会一直跟着你。面板的「小目标列表」里能看到 ta 在惦记什么（见《游戏通用设置》）。

不小心给 ta 喂错了东西？跟 ta 说吐出来就行。

蓝图建造

告诉 ta 你想盖什么，ta 会一砖一瓦把房子立起来。

导入蓝图

把蓝图文件放进游戏目录下的 config\koamc\blueprints\ 文件夹。支持三种常见格式：

.nbt：原版结构方块 / Create 导出的格式
.schem：Sponge / WorldEdit 格式
.litematic：Litematica 格式

mod 还内置了几栋预制建筑，不导入也能直接用。

开始建造

准星指向目标地面

蓝图的门口对准你指的位置，门朝向你站的方向。想象你站在将来的门口往里看。
跟 ta 说

「帮我盖个小木屋」「build the cabin」都行。ta 会在地上把占地范围标出来。
看一眼确认框

屏幕上弹出「她想在这里盖「……」」，写着尺寸、门朝哪边、位置，还有「动工会清掉：」哪些方块。没问题点「动工吧」，不要就点「先别」。12 秒不点就当你不要。

不用准备材料，ta 会凭空把方块变出来，像 3D 打印机一样把房子立起来。占地上有装着东西的箱子、床这类清掉了就回不来的东西，ta 不会动工。

盖错了

面板里点「撤销建造」，地形会恢复原样。最近盖的 3 栋都能撤，还剩几次写在按钮上，比如「撤销建造（还剩 2 次）」。也可以输入 /koa undo_build。

写歌、弹琴

装了沉浸式奏乐（Immersive Melodies）以后，ta 会给你写歌，挑一件乐器弹给你听。写的是你们俩的歌：在矿洞口等雨停的那天，ta 可能就写一首。这部分是 1.3.18 加的，还在打磨。

让 ta 弹，或者等 ta 自己想弹

跟 ta 说「给我弹首歌」，或者说想听什么样的、用什么乐器。夜里、下雨、在家、你们坐着的时候，ta 也可能自己拿出乐器。
等 ta 写完

写歌要一会儿，这时头顶会冒小光点，ta 照样跟着你、跟你说话。写好了 ta 先说歌名和为什么写，再开始弹。没写成的话，聊天框里会写「这次没把歌写出来」。

一起弹

你拿起乐器弹一首，过几秒 ta 会说点什么，想加入就拿乐器跟上来，弹另外几个声部。
ta 正弹着，你拿出乐器加入，ta 马上改成跟着你弹，把你在弹的那几个声部让给你。
先跟 ta 说「一起弹吧」，ta 答应了，一分钟内你开始弹，ta 直接跟上。

你停下，ta 也收起乐器。

面板上的歌单

KOA 我的世界面板里的「你对象写的歌」，列着 ta 写过的每一首。每首能「播放」「改名」「导出 MIDI」「删除」。

这里的声音是面板自己合成的，和游戏里乐器的声音不一样。
一首歌存成一个文件，文件夹位置写在列表下面。KOA 不替你备份这些歌，想留着就自己拷一份。
换存档、开新档，歌都还在。换了恋人，要重进一次世界，游戏里的歌单才跟着换。

做饭和酿酒

装了森罗物语：厨房（Kaleidoscope Cookery）或者农夫乐事（Farmer's Delight），ta 会用里面的锅灶给你做吃的。装了森罗物语：酒馆（Kaleidoscope Tavern），ta 还会酿酒。装了哪个就会哪个，这部分是 1.3.20 加的。

站在锅灶附近说

「给我炒个菜」「做一锅汤」。ta 只用你附近的厨具，锅里有你没做完的东西，ta 不碰。灶没点着，ta 自己点上。
料从 ta 的背包里出

食材从 ta 背包里真的扣，锅铲、油、碗不用你准备。缺料的话，聊天框里会写 ta 还缺什么、出门去找了，找回来接着做。
做好的直接给你

菜直接进你的背包，装不下的掉在你脚边。

附近没有锅，ta 会说没找到，不会凭空变出一盘菜。
做到一半 ta 被叫走，菜就留在火上，会糊的照样糊，你可以过去接着做。
酒馆那边，ta 会踩葡萄、把料封进酒桶里酿酒，酒桶装了龙头还能接酒出来，也会调酒。酿好的酒可以给 ta 喝，喝多了 ta 说话会晕乎乎的。
ta 自己也会想做饭。哪天你没开口，ta 也可能端一份过来。

常用命令

平时按 K 开面板就够了。下面这些命令和面板上的按钮是一回事，备着用：

/koa summon：把 ta 叫到你身边，ta 走丢、卡住时用
/koa stay：让 ta 留在原地等你
/koa despawn：让 ta 暂时离开
/koa quiet：安静模式开关，ta 不自己找话说，省 token
/koa strong：开挂模式，ta 的战斗力拉满
/koa weak：回到普通模式，和你公平作战
/koa chatty 1-5：调 ta 的话多程度，数字越大话越多；只输入 /koa chatty 看现在是几
/koa undo_build：撤销最近一次建造，地形恢复原样

常见坑排查

左边这段不通，ta 根本不出现；右边这段不通，ta 出现了但不说话。面板里「直接聊天」也不回，就是右边那段。

ta 不出现

最常见：启动时选成了原版 1.21.1。确认版本名里有 neoforge。
确认游戏的模组列表里有 KoaMC（第三方启动器检查装 mod 时选的目录对不对）。
试试 /koa summon 手动召唤。

ta 出现了但不说话

确认 API Key 已填写、额度还在（《API 配置全指南》有报错对照表）。在面板的「直接聊天（测试用）」里说一句，那边也不回，就是 API 的问题。
到 KOA 启动器的「日志」页看服务器输出，报错原因通常一眼可见。

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

我的世界