智能村民AI

智能村民AI

将普通村民转变为由AI驱动的智能、健谈、感知情境的NPC。

关于

智能村民AI

支持 Nightbeam Studio

智能村民AI 将普通村民转变为由 DeepSeek API 驱动的智能NPC。村民不再仅仅是简单的交易站，他们可以进行自然的对话、记住之前的互动、根据自己的职业做出反应、与玩家建立关系、提供生存建议，并对周围的世界做出响应。

Discord YouTube GitHub CurseForge Modrinth

特性

特性 描述
AI驱动的对话 由DeepSeek AI驱动的与村民的动态对话
职业个性 村民根据其职业和知识做出回应
村民记忆 记住对话、交易、声望变化、互动和近期事件
关系系统 村民根据玩家对待他们的方式做出不同的反应
环境感知 回应可以考虑生物群系、天气、时间、危险、装备、玩家状态和村庄状况
智能提示 获得探索、农业、交易、战斗、资源和进度建议
异步处理 AI请求异步运行，以最小化对游戏主线程的影响
完全可配置 控制AI模型、令牌数、温度、记忆、冷却时间、速率限制、超时和功能
后备对话 在没有配置或可用的实时AI API时，村民仍然可以使用后备对话
服务器友好 冷却时间、速率限制、垃圾消息防护、成本控制和服务端API安全

AI驱动的对话

与由DeepSeek AI驱动的村民进行动态对话。

村民可以：

  • 回答问题
  • 讨论Minecraft话题
  • 对玩家行为做出反应
  • 参与角色扮演场景
  • 提供有用的游戏信息

基于职业的个性

每个村民职业都有自己的个性和知识。

例如：

  • 农民讨论农作物和食物
  • 图书管理员分享知识
  • 牧师讨论神秘事物
  • 盔甲匠谈论装备
  • 渔夫分享钓鱼技巧
  • 傻子提供可疑的智慧

村民记忆

村民可以记住：

  • 之前的对话
  • 交易
  • 声望变化
  • 玩家互动
  • 近期事件

这使得对话感觉更自然和持久。

关系与声望系统

村民根据玩家对待他们的方式做出不同的反应。

通过以下方式影响声望：

  • 交易
  • 帮助村民
  • 保卫村庄
  • 攻击村民
  • 偷取资源
  • 制造麻烦

建立信任——或者变得臭名昭著。

环境感知回应

村民可以考虑：

  • 生物群系
  • 天气
  • 一天中的时间
  • 附近的危险
  • 装备
  • 玩家状态
  • 村庄状况

这使得对话感觉与现实世界紧密相连。

智能提示与生存建议

村民可以提供：

  • 探索技巧
  • 农业建议
  • 交易建议
  • 战斗警告
  • 资源推荐
  • 进度指导

异步API处理

所有AI请求都异步处理，以最小化性能影响并避免阻塞游戏主线程。

配置

智能村民AI在首次启动时自动生成配置文件。

常见的配置选项包括：

  • DeepSeek API密钥
  • 模型名称
  • 最大令牌数
  • 温度
  • API请求超时
  • 玩家冷却时间
  • 全局速率限制
  • 记忆限制
  • AI、提示和记忆开关
  • 后备行为

示例：

[smartvillagers.api]
apiKey = "YOUR_DEEPSEEK_API_KEY"
model = "deepseek-chat"
maxTokens = 150
temperature = 0.8
requestTimeoutMs = 15000
maxMessagesPerMinute = 30

[smartvillagers.features]
enabled = true
enableMemory = true
enableHints = true
enableQuests = true

[smartvillagers.memory]
maxMemoryEntries = 20
maxConversationHistory = 10

[smartvillagers.ratelimits]
playerCooldownMs = 2000
villagerCooldownMs = 1000
maxMessageLength = 300
maxResponseLength = 500

[smartvillagers.server]
logApiErrors = true

切勿公开分享你的API密钥。在服务器上，请仅将其保存在服务端配置中。

后备对话

如果API被禁用、不可用或未配置，村民仍然可以使用后备对话，因此模组在没有实时AI访问的情况下仍然可用。

服务器友好设计

智能村民AI包括：

  • 冷却时间
  • 速率限制
  • 垃圾消息防护
  • 成本控制
  • 服务端API安全

命令

/villagerai reload
/villagerai info
/villagerai toggle
/villagerai memory clear
/villagerai debug

命令可能因版本而异。

安装

  1. 安装所需的模组加载器。
  2. 将智能村民AI放入你的 mods 文件夹。
  3. 启动Minecraft一次。
  4. 打开生成的配置文件。
  5. 添加你的DeepSeek API密钥。
  6. 配置所需的设置。
  7. 重启游戏或服务器。
  8. 右键点击村民开始聊天。

隐私与AI声明

当AI对话启用时：

  • 玩家的消息可能会发送到配置的DeepSeek API。
  • API密钥应保持私密。
  • 切勿通过村民对话分享敏感信息。
  • 服务器所有者应在启用AI聊天时告知玩家。

兼容性

支持：

  • 原版村民
  • 单人游戏
  • 专用服务器

计划中或取决于版本的支持：

  • Minecraft 1.20.1+
  • Minecraft 1.21+
  • Forge
  • NeoForge
  • Fabric

安装前请务必验证与特定版本的兼容性。

常见问题解答

我需要DeepSeek API密钥吗？

是的。实时AI对话需要DeepSeek API密钥。

没有密钥也可以使用后备对话。

模组能离线工作吗？

部分可以。后备对话可以离线工作，但AI对话需要互联网连接。

它会导致我的服务器卡顿吗？

该模组使用异步处理，并包含冷却时间以减少性能影响。

村民能记住玩家吗？

可以。当记忆功能启用时，村民可以记住对话、交易和与声望相关的事件。

我可以禁用记忆功能吗？

可以。记忆功能可以在配置中禁用。

我可以限制API使用量吗？

可以。可以使用冷却时间、令牌限制、消息限制和全局速率限制来控制使用量和成本。

它与整合包兼容吗？

是的。智能村民AI专为RPG、生存、冒险和角色扮演整合包设计。

请务必测试与你的特定整合包的兼容性。

路线图

计划中的特性：

  • 动态村民任务
  • AI生成的知识书籍
  • 村庄八卦网络
  • 袭击恐慌对话
  • 流浪商人故事
  • 语音支持
  • 本地AI模型
  • 离线AI支持
  • 高级角色扮演特性

社区与支持

加入Nightbeam社区