Z-Waif联动Minecraft玩法:让AI女友进入游戏陪你冒险

原创2026-11-15 11:02:022,638 阅读

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"的项目初衷。

登录后查看全文
z-waif