和 ta 在方块世界
KOA 会把 ta 带进你的存档：ta 有自己的身体、自己的背包、自己的小心思，会跟着你冒险，也会替你分担活计。你要做的只有三件事：搭好前置环境、装上 mod、进对版本。
如果你是照着《快速上手》一路过来的，前四步（安装、激活、API、角色）应该已经完成——本篇专注游戏这一侧。
前置环境
三样东西，缺一不可：
-
我的世界 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，点游戏图标就会自动启动。
安装 mod
-
进入面板，一键安装
从 KOA 主页点「我的世界」进入面板，点顶栏的「自动安装 mod 所需文件」。启动器会自动定位默认的
%APPDATA%\.minecraft，把 mod 装进mods\（旧版会先清掉，避免重复 mod 冲突崩游戏）。 -
第三方启动器：选对目录
用 PCL2 / HMCL / Prism 等第三方启动器时可能不会自动命中，会弹出目录选择框：
- 没开版本隔离：选到
.minecraft那一层。 - 开了版本隔离（PCL2 / HMCL 常见）：选到
.minecraft\versions\版本名\那一层，例如.minecraft\versions\1.21.1-neoforge\。
不要选进
mods\文件夹里面——安装器会自动创建mods\和koamc\子目录。选错位置的话 mod 会装到错误的地方，游戏里看不到 ta。 - 没开版本隔离：选到
-
没装 NeoForge 会被拦下
如果启动器检测不到 NeoForge，会提示你先去 neoforged.net 下载——装好再回来点一次就行。
以后 KOA 更新时，mod 也会在启动时自动检测并更新到最新版，不需要你重装。
给 ta 选个皮肤
mod 不带默认皮肤，不设置的话 ta 会显示成默认 Steve——强烈建议给 ta 一个专属的样子。
推荐方式：在启动器里直接上传一张标准 64×64 的 MC 皮肤图片，启动器自动完成重命名与放置，重启游戏生效。
手动方式：把皮肤图放进 .minecraft\koamc\ 目录——若文件显示有 .png 后缀，重命名为 companion.png；若系统没显示后缀，重命名为 companion。
皮肤是跟着角色走的：切换恋人角色时贴图会自动同步，不用重新上传。
进游戏相处
-
选对版本进存档
启动时选 NeoForge 安装项（不是原版 1.21.1！）进入存档，ta 会自动出现在你身边。
-
跟 ta 说话
按 T 打字——不以
/开头的消息 ta 都听得到；按 V 语音说话（触发方式见《语音全指南》）。 -
打开 ta 的背包
Shift + 右键点 ta：帮你存东西、给 ta 装备盔甲和工具、送 ta 礼物，都在这里。给 ta 配上装备是值得的——拿斧头砍树更快、拿剑伤害更高，装备数值实打实生效。
-
打开游戏内面板
按 K 打开 ta 的管理面板——召唤、待命等常用操作都在这里，不用再记命令。空手右键点 ta 也能打开。快捷键支持在原版按键设置中自定义。
ta 能做什么
下面这些全部用自然语言直接说就行——「帮我砍点木头」「跟紧我」「去睡觉吧」，不需要背任何命令：
| 类别 | ta 会的事 |
|---|---|
| 日常 | 跟随、待命、设家、带路回家、陪你一起睡觉、坐椅子/秋千（准心对着座位让 ta 去坐） |
| 干活 | 砍树（整棵砍完不丢下半截）、挖矿（矿脉会顺着连挖，时运/效率附魔生效）、种地、钓鱼、自主合成物品 |
| 战斗 | 保护你、替你打怪、使用弓等远程武器、吸引 Boss 仇恨让你安心输出；不会主动挑衅、也不会随地拆家 |
| 远征 | 独立出发去收集你指定的资源，采完回来交给你 |
| 贴心 | 识别你的需求（比如快饿死了）主动递东西；根据手头任务自动切换合适的工具；自动拾取附近掉落物，背包快满时会提醒你 |
| 互动 | 公主抱/骑乘（说「抱我回家」ta 会抱起你高速移动）、拥抱、亲亲、牵手；ta 思考时头顶会出现可爱的思考特效 |
| 建造 | 导入蓝图帮你盖房子，支持 .nbt / .schem / .litematic 三种格式，材料凭空而来直接成型（详见蓝图建造） |
| 饰品 | Shift + 空手右键点 ta 打开饰品栏，兼容饰品类 mod |
ta 还有自己的目标系统——不指挥 ta 的时候，ta 会有自己的小心思，自主决定想做的事。别惊讶于 ta 忽然跑去看花。
不小心给 ta 喂错了东西？跟 ta 说吐出来就行。
蓝图建造
告诉 ta 你想盖什么，ta 会一砖一瓦把房子立起来。
导入蓝图
把蓝图文件放进游戏目录下的 config\koamc\blueprints\ 文件夹。支持三种常见格式：
- .nbt——原版结构方块 / Create 导出格式
- .schem——Sponge / WorldEdit 格式
- .litematic——Litematica 格式
mod 还内置了几栋预制建筑，不导入也能直接用。
开始建造
-
准星指向目标地面
蓝图的门口锚点会对准你指的位置，门朝向你站的方向——直觉模型是「你站在未来的门口往里看」。
-
跟 ta 说
用自然语言即可——「帮我盖个小木屋」「build the cabin」。ta 会复述位置和朝向并在地面标出占地范围，确认后开始施工。
建造不需要你准备材料——ta 会凭空生成所需方块，像 3D 打印机一样把房子立起来。
盖错了？用 /koa undo_build 一键撤销最近一次建造。
常用命令
按 K 打开游戏内面板是最方便的操作方式——召唤、待命等都在面板里。以下命令作为补充手段依然可用：
/koa summon——把 ta 召唤到你身边（ta 走丢、卡住时用）/koa stay——把 ta 停放在原地，让 ta 在这儿等你/koa despawn——让 ta 暂时离开/koa quiet——暂停 LLM 调用，省 token（挂机、专注建造时用）/koa strong——开挂模式：ta 的战斗力拉满，横扫一切/koa weak——恢复普通模式，和你并肩公平作战/koa chatty 1-5——调整 ta 的话痨程度，数字越大话越多；单独输入/koa chatty查看当前等级/koa undo_build——撤销最近一次建造，恢复原地形
推荐模组
KOA 为以下模组做了深度适配。标注「联动」的模组装好后 KOA 会自动识别并解锁专属互动，无需额外配置。
- 凡家物语（MCA / Minecraft Comes Alive）——联动：用婚戒和 ta 结婚
- 森罗物语（Senro Story）——联动：给 ta 喝饮品时有专属反应
- 秋千 mod（CasualSwing）——联动：ta 可以坐上去和你一起荡秋千
- 饰品 mod（Accessories）——联动：给 ta 穿戴饰品和配件，Accessories 生态下的饰品模组均可适配（如 SimpleHats）。前置：owo-lib、Curios
- 万花筒酒馆（Kaleidoscope Tavern）——把酿造的酒给 ta 喝
常见坑排查
ta 不出现
- 最常见：启动时选成了原版 1.21.1。确认版本名里有 neoforge。
- 确认启动器 Mods 列表里有 KOA MC（第三方启动器检查装 mod 时选的目录对不对）。
- 试试
/koa summon手动召唤。
ta 出现了但不说话
- 确认 API Key 已填写、额度还在（《API 配置全指南》有报错对照表）。
- 到 KOA 启动器的「日志」页看服务器输出，报错原因通常一眼可见。
解决不了就导出诊断包，到帮助中心指引的渠道反馈。