真实友善的同伴

真实友善的同伴

一个带有服务器托管AI、俄语和英语语音、世界感知工具、建筑以及可选个人恐怖元素的Verity扩展。

Verity 友好同伴

原版 Verity JE 3.4.1 的非官方附加模组,为长时间多人冒险添加可配置的世界内助手。

前置要求

Minecraft 1.21.1 · NeoForge 21.1.250–21.1.x · Java 21 · 原版 Verity JE 必须为 3.4.1。 请在服务器和每个客户端上安装原版 Verity 与本附加模组。原版 Verity 是独立且必需的前置依赖,不随本模组一起打包。

功能

  • 在普通聊天中说话,或按住 R 键发言,松开后发送。按 R 可中断语音播放。M 键循环切换麦克风;按键绑定可在“控制”中更改。所选麦克风会被保存并显示在录音 HUD 上。
  • 服务端进行俄语/英语识别并提供完整的语音回复。客户端无需 Python、AI 模型或 API 密钥。
  • 查看物品栏、附魔、效果、附近生物、已注册配方、进度以及可用的 FTB Quests 进度。可选集成需要对应模组。
  • 请求物品、效果、附魔和建筑,受服务器设置与保护检查限制。建筑使用免费方块;记录的撤销操作会保留之后的玩家改动。
  • 可单独选择名称、人格、面部、语言和语音。人格角色不会改变实体模型。
  • 可按玩家配置关系以及可选的个人恐怖/Boss 遭遇。随机恐怖默认关闭;个人 Boss 默认以零情绪触发。管理员可禁用这些系统。

需要服务端配置

主机必须配置独立的 Python 桥接和聊天后端:Google Gemini 或 LM Studio。桥接仅使用回环地址;所有凭据都保留在主机上。即使使用本地聊天,Google 语音和网络工具也可能需要访问互联网。API 配额适用,计费可能产生费用;免费额度并非无限。

麦克风音频会发送到 Minecraft 主机进行本地识别。云端聊天会接收消息、近期对话和所请求的游戏上下文;Google TTS 会接收回复文本。默认情况下,转写文本/回复会在聊天中公开,可由主机配置;语音播放为个人专属。

Beta 限制: 自定义 GUI/网络并非普遍支持。语音准确率会有波动,首次识别需要加载模型,云端语音可能排队。这是按键说话模式,不是持续通话。

使用 /companion help、/tts 和 /llm help。LLM 设置需要管理员权限。

致谢与文档

需要 VarmiteYT 的 Verity JE。本模组为独立、非官方附加模组;附加模组代码采用 MIT 许可。依赖项保留各自的许可证。头像为基于游戏内角色生成的 AI 插画,并非游戏内截图。

服务端配置 · 源代码、问题反馈与文档