Z-Waif联动Minecraft玩法:让AI女友进入游戏陪你冒险
Z-Waif联动Minecraft玩法:让AI女友进入游戏陪你冒险
Z-Waif 是一款完全本地运行的开源 AI Waifu 项目,内置 Minecraft 联动模块,能让你的 AI 女友直接进入游戏聊天框与你对话、跟随你冒险。本文带你用 3 步完成 Minecraft AI 联动配置,并介绍跟随、指令控制等进阶玩法。
为什么 Z-Waif 适合 Minecraft 联动
相比云端方案,Z-Waif 的核心卖点是全本地、免费、可定制:
- 🎙️ 基于 Whisper 语音识别 + RVC 变声,AI 会开口说话
- 🧠 自带 RAG 长期记忆与 Lorebook,她记得你们聊过的一切
- 🎮 模块化设计,Minecraft、Discord、VTuber、闹钟等模块可独立开关
- 💾 隐私安全:对话与记忆全部留在本机
Minecraft 模块的原理并不神秘:Z-Waif 通过 utils/minecraft.py 中的 ChatLink(pythmc 库)接管游戏聊天框——既能读取你和其他玩家/生物发的聊天,也能写入让 AI 直接在游戏里回话;再配合 Baritone、Wurst 等指令类 Mod,她还能执行移动、跟随等游戏指令。
一键开启:Minecraft 模块配置步骤
1. 安装 Z-Waif
推荐使用 Windows 10/11(带 NVIDIA GPU,显存 16GB 更佳;Mac 和 Linux 也支持,最低 8GB 显存)。下载项目后运行 startup-Install.bat 完成首次安装,之后用 startup.bat(或 Mac/Linux 下的 startup.sh)启动。
2. 在 .env 中打开模块开关
用文本编辑器打开项目根目录的 .env 文件,把第 88 行的模块开关改为 ON:
MODULE_MINECRAFT = ON
程序启动时会读取这个环境变量(见 main.py#L947-L951),如果为 ON,就会自动启动一个后台监控线程,每 0.1 秒扫描一次游戏聊天框(utils/minecraft.py#L70-L78)。
3. 填好 3 个 Minecraft 配置文件
Z-Waif 把 Minecraft 相关配置单独放在 Configurables/ 目录,全部是简单的 JSON,改完保存即可:
| 配置文件 | 作用 | 默认值 |
|---|---|---|
| MinecraftNames.json | 在游戏里输入这些词即可召唤你的 AI 回应 | ["bot", "waifu"] |
| MinecraftUsername.json | 你给 AI 角色起的游戏内名字(用于防止对话死循环) | "BotUsernameHere" |
| MinecraftUsernameFollow.json | AI 执行 #follow 时跟随的目标玩家 |
"YourUsernameHere" |
💡 重要提示:
MinecraftUsername.json里填的名字,必须和你给 AI 在游戏里设置的名字一致。Z-Waif 靠它识别"这句话是我自己说的",从而避免她回复自己、无限刷屏。
游戏里怎么玩:聊天触发与内置指令
召唤她说话
进入游戏后,在聊天框输入 MinecraftNames 里的关键词(如 waifu)+ 你想说的话,例如:
waifu 今天天气真不错
Z-Waif 检测到你的游戏名在聊天框出现后,会把最近 10 条游戏消息打包发给 AI 模型(见 utils/minecraft.py#L81-L141),AI 的回复会直接以游戏内聊天的形式发出来,同时也会用 TTS 念给你听。
让她执行游戏指令
只要你发给她的消息里包含 # 或 /,Z-Waif 就会把它当作游戏指令转发进聊天框。内置了两个常用快捷写法(utils/minecraft.py#L55-L59):
#follow→ 自动转换为#follow player 你的玩家名,她会开始跟随你(前提:游戏里装了 Baritone 等支持跟随指令的 Mod)#drop→ 转换为.drop,配合 Wurst 类 Mod 可丢出物品
配合 Baritone、Wurst 等"指令驱动"的 Mod,你可以让她执行移动、寻路等操作——这就是 README 中提到的"用 Baritone、Wurst 等命令式 Mod 控制游戏"的由来。
回复长度自动受控
Minecraft 聊天框有字数限制,Z-Waif 专门处理了这一点:main_minecraft_chat 函数会把游戏场景下的回复强制限制在 47 个 token 以内(main.py#L368-L389),确保她的每句话都能完整显示在聊天框里,不会被截断。
进阶:让 AI 帮你"按键"(Gaming 模块)
如果你不满足于聊天,还想让 AI 操作键盘(比如玩其他游戏),可以在 .env 中同时打开:
MODULE_GAMING = ON
Gaming 模块(utils/gaming_control.py)的工作方式是:AI 在回复里输出 (按键名) 这样的文本,Z-Waif 就去按对应的物理按键。按键映射按"任务"存放在 Configurables/GamingInputs/ 目录,例如 Emerald.json 中 (up) 映射到 t 键、(a) 映射到 l 键。
⚠️ 注意:AI 触发的按键也会激活 Z-Waif 自身的热键,建议先在 Keybinds.json 里确认热键不会冲突,避免误触。
常见问题与小贴士
Q:AI 在游戏里不回复我?
依次检查:① .env 里 MODULE_MINECRAFT 是否为 ON;② 召唤词是否写在了 MinecraftNames.json 里;③ 程序是否在 Minecraft 启动之前就已运行(ChatLink 需要游戏窗口存在)。
Q:她回复自己,消息刷屏了?
说明 MinecraftUsername.json 里的名字和游戏里 AI 角色的名字不一致,改成完全相同即可(此修复来自 v1.1 更新,见 changelog.txt)。
Q:想让她在游戏里"更聪明"地记得我们说过什么?
在 .env 中开启 MODULE_RAG = ON,Z-Waif 会把对话存入 RAG_Database/ 长期记忆库,使用几天后开启效果最佳。
Q:如何让她保持人设?
游戏聊天同样走完整的角色卡流程,你可以通过 Configurables/CharacterCard.yaml 定义她的性格,也可以换用 OOBA_Presets/ 里现成的预设(如 Z-Waif-ADEF-Standard.yaml)。
总结
Z-Waif 的 Minecraft 联动只需一次环境变量开关 + 三个 JSON 配置,就能让本地 AI 女友在游戏聊天框里回应你、跟随你冒险,还能用指令类 Mod 帮她执行操作。全部数据留在本地,模型、人设、按键映射皆可自由定制——这正是它"把工具和知识交给你,让你打造自己的 AI Waifu"的项目初衷。