AI村民[Gemini]

AI村民[Gemini]

让《我的世界》中的村民拥有自己的思想。

怪物

🧠 AI村民

让 Minecraft 村民拥有自己的思想。

AI村民 将普通的 Minecraft 村民转变为拥有 AI 驱动的对话、个性、持久记忆和自主决策 能力的智能角色。

村民不再只是站着等待交易，他们可以进行交流、记住你告诉他们的信息、评估周围环境、追求目标、对危险做出反应，并做出自己的决定。

✨ 功能特性

💬 AI 对话

使用 Minecraft 聊天功能直接与村民交谈。

潜行 + 右键点击一个已启用的村民开始对话，然后在聊天框中正常输入。

村民可以：

  • 自然回应你的消息
  • 讨论周围的环境
  • 记住对话中的信息
  • 与玩家发展熟悉度
  • 回复时展现各自的个性

当你正常与村民交互时，原版的 Minecraft 交易功能仍然有效。

🧠 持久记忆

村民并非完全没有记性。

每个 AI 村民都有自己的记忆，并能记住之前对话中的信息。

你甚至可以教给他们一些事实。

例如：

/aivillagers remember Naman owns the large wheat farm

这条信息会变成该村民记忆的一部分。

🎭 个性

并非每个村民的思维方式都相同。

AI村民 赋予村民独特的个性特征，这些特征会影响他们的行为和反应方式。

有些村民可能更：

  • 勇敢
  • 善于社交
  • 内向
  • 乐于助人
  • 谨慎

他们的个性会影响对话和自主决策。

🤖 自主村民

这就是 AI村民 超越普通对话模组的地方。

当启用自主行为时，村民可以观察周围的环境并决定他们下一步应该做什么。

他们可以追求诸如以下目标：

  • 🌾 收集资源
  • 🍞 寻找食物
  • 🏠 回家
  • 😴 睡觉
  • 🧑‍🤝‍🧑 社交
  • 🚶 跟随其他村民
  • 🏃 逃离危险
  • ⚔️ 攻击敌对生物
  • 📍 前往有用的地点

村民会持续评估自身处境，并从一组受控的动作中做出选择。

AI 无法执行任意的 Minecraft 命令或不受限制的操作。决策在执行前会经过验证，并通过模组的动作系统传递。

🧠 AI 的工作原理

AI村民 使用 Google Gemini 作为其 AI 大脑。

该模组会收集村民处境的紧凑视图，包括相关的世界信息和需求，然后请求 Gemini 做出决策或生成对话回复。

结果会经过验证后，村民才会执行动作。

Minecraft 世界
     ↓
村民感知
     ↓
需求与状况
     ↓
🧠 Gemini
     ↓
验证后的决策
     ↓
村民动作

🔑 设置 Gemini

AI村民 使用“自带 API 密钥”系统。

你需要自己的 Google Gemini API 密钥。

  1. 获取 Gemini API 密钥

通过 Google AI Studio 创建一个密钥。

  1. 启动一次 Minecraft

模组会创建其配置文件。

  1. 打开

.minecraft/config/ai-villagers.json

  1. 添加你的 API 密钥 "apiKey": "YOUR_GEMINI_API_KEY"
  2. 重启 Minecraft

或者使用：

/aivillagers reload

⚠️ 切勿与任何人分享你的 Gemini API 密钥。

不要将你的密钥发布在 Discord、截图、GitHub、Modrinth 评论区或错误报告中。

如果你不小心泄露了密钥，请通过 Google 撤销并创建一个新的。

⚙️ 配置

AI村民 提供配置选项来控制自主行为。

重要选项包括：

选项 描述
autonomousVillagers 启用或禁用村民的自主行为
autonomousCombat 允许自主村民对敌对生物做出反应
maxConcurrentDecisions 限制同时进行的 AI 决策数量
maxActionsPerDecision 限制单个决策产生的动作数量

如果你运营着一个大型村庄，降低并发设置有助于减少 AI/API 活动。

🛠️ 命令

使用：

/aivillagers enable

为你正在注视的村民启用 AI 行为。

/aivillagers disable

为目标的村民禁用 AI 行为。

/aivillagers status

查看目标 AI 村民的信息。

/aivillagers remember <fact>

教给村民一个事实。

示例：

/aivillagers remember Naman owns the large wheat farm

/aivillagers forget

清除目标村民存储的记忆。

/aivillagers reload

重新加载 AI村民 的配置。

需要以村民为目标的命令要求你在指定范围内注视该村民。

💬 与村民对话

开始

  • 注视一个已启用 AI 的村民。
  • 潜行 + 右键点击村民。
  • 你应该看到：

AI Villagers: Now talking with Villager...

  • 在 Minecraft 聊天框中正常输入你的消息。

结束

你可以通过以下方式结束对话：

  • 再次潜行 + 右键点击同一个村民
  • 使用 /aivillagers stop
  • 走远至超出现有的对话距离规则触发范围

⚠️ 重要须知

🌐 网络连接

AI 响应需要与 Gemini API 通信。

如果你的网络连接缓慢或不可用，响应可能会变慢或失败。

🔑 API 限制

Gemini API 的使用受 Google 自身的配额、限制和政策约束。

AI村民 无法控制这些限制。

🐌 AI 响应可能需要时间

AI 响应并非即时。

根据你的网络连接、API 可用性、模型处理速度和服务器性能，响应可能需要几秒钟。

当村民正在回复时，不要刷屏发送消息。

🧠 AI 并非完美

村民偶尔可能会做出奇怪、错误、有趣或意想不到的决定。

这也是实验的一部分。

该模组会验证 AI 的决策，但不保证 AI 生成的每个响应或决策都是合理的。

⚔️ 自主战斗

自主战斗仍是一个不断发展的功能。

村民有时可能会做出意想不到的战术决策，尤其是在特殊地形或危险情况下。

🚫 不要做的事

请不要：

  • 分享你的 Gemini API 密钥。
  • 上传包含你 API 密钥的 ai-villagers.json 文件。
  • 向村民刷屏发送数百条消息。
  • 在未测试服务器性能的情况下运行数量极其庞大的自主村民。
  • 在没有先检查你的 Gemini API 状态的情况下，将 API 配额错误报告为 Minecraft/模组错误。
  • 认为 AI 的回应代表了模组有意的固定行为。

🐛 发现 Bug？

发现哪里出错了？

请报告！

报告前：

  • 尽可能重现问题。
  • 在 Minecraft 日志中检查 [AI Villagers] 相关消息。
  • 记录问题发生时你在做什么。
  • 附上你的 Minecraft 版本、Fabric 版本、AI村民 版本以及相关的模组。

💬 需要帮助?

加入 AI Villagers Discord，并在需要帮助或想要报告问题时 @RealNamanYT。

报告 Bug 时，请包括：

  • Minecraft 版本：

  • Fabric Loader 版本：

  • AI村民 版本：

  • 其他相关模组：

  • 发生了什么：

  • 你期望发生什么：

  • 相关日志：

切勿在 Bug 报告中包含你的 Gemini API 密钥。

❤️ 反馈

AI村民 是一个不断发展的项目。

如果你喜欢这个模组、发现了有趣的事、发现了意想不到的村民行为，或者对新功能有想法，我们很乐意听取你的意见。

你的反馈有助于让村民变得更智能。

📜 许可证

AI村民 根据此 Modrinth 项目上指定的许可证发布。

完整的许可证文本请参见仓库/项目文件。