Smart Villagers AI

将普通村民变成由 AI 驱动、聪明健谈且能理解上下文的 NPC。

模组 Fabric Forge NeoForge 冒险加工实用游戏机制生物科技魔法

介绍

介绍由机器翻译自 Modrinth 原页面，仅供参考。

会顶嘴、记住你，还会请你帮忙的村民。走到村民面前，像平常一样和它聊天。它会
以角色身份回应，在头顶的对话气泡中显示内容；你可以选择使用哪种 AI，也可以在没有
AI 时使用内置对话。向它询问工作，就能接到真正的差事：收割庄稼、为锻造炉取铁、清理
田地里的僵尸。完成后，你会获得绿宝石报酬，村民对你的评价也会提高，整条街都会听说这件事。

Fabric、Forge 和 NeoForge · Minecraft 1.20.1、1.21.1、26.1.2、26.2 和 26.3 · 可搭配任何兼容 OpenAI 的 AI
服务商、本地模型，也可以完全不使用 AI

What's new in 2.0

2.0 版本——村庄广场更新——让与村民交谈成为游戏的一部分，而不再只是新奇功能：

村庄委托：用自己的话向村民询问工作，接受并完成任务，获得绿宝石和经验值报酬
声望与流言：完成委托会提升你在原版游戏中的声望（可能降低交易价格）；邻居会听说你的所作所为，并在交谈时提起；你伤害过的村民不会给你安排工作
对话气泡：显示在正在说话的村民头顶；AI 思考时会显示“…”气泡
三个进度，从初次交谈到成为村庄广场英雄
更聪明的上下文：生物群系、袭击、附近的怪物、你手持的物品、你的声望，以及尚未完成的委托
无 AI 时也更好玩：内置对话现在会聊工作、留意夜晚和下雨，还会传递村庄里的新消息
更懂礼貌：村民不再回复发给其他玩家的消息
Minecraft 26.1.2，你的 1.x 世界和配置也能继续使用

Village requests

Villagers who need you

对“有活儿给我干吗？”（或者“需要帮忙吗？”、“有什么跑腿的事吗？”、“¿tienes trabajo?”、“as-tu une quête ?”）这样问一个
有职业的村民。它会提出符合自身职业的委托，或请你处理
村庄周围的怪物。聊天中会出现一张委托卡片，列出委托条件，并提供 [接受]和[拒绝]选项；你也可以直接说“好”。

| 职业 | 委托物品 |
|————|———-|
| 农民 | 小麦、胡萝卜、马铃薯、甜菜根、南瓜、骨粉 |
| 图书管理员 | 纸、书、羽毛、墨囊 |
| 制图师 | 纸、玻璃板、指南针 |
| 牧师 | 腐肉、金锭、红石、玻璃瓶 |
| 盔甲匠、武器匠、工具匠 | 铁锭、煤，以及一桶熔岩、燧石或木棍 |
| 屠夫 | 猪排、生牛肉、生鸡肉、生羊肉、甜浆果 |
| 渔夫 | 生鳕鱼、生鲑鱼、线、煤 |
| 制箭师 | 木棍、燧石、线、羽毛 |
| 皮匠 | 皮革、兔子皮、燧石 |
| 牧羊人 | 白色羊毛、线、剪刀 |
| 石匠 | 黏土、石头、石英、安山岩 |
| 任意村民 | 击败僵尸、骷髅、蜘蛛、苦力怕或掠夺者 |

经验丰富的村民会提出更多要求，也会支付更多报酬（大师级村民最多会要求双倍数量）
进度会根据你的物品栏，或你接受委托后击杀的怪物数量计算；随时可以问“还差多少？”
再次与村民交谈即可交付：村民会收走物品，并支付绿宝石和经验值
/villagerai requests会列出你当前尚未完成的委托
最多可同时接取 3 个委托；同一村民再次发布委托前会有短暂等待时间；傻子村民和失业村民不会发布委托

Reputation and gossip

Word gets around

村民会读取 Minecraft 已为你记录的声望。完成委托会为你增加原版中的“少量正面”
流言（治疗僵尸村民也会获得这种流言），这会计入决定交易
价格的声望；村民之间也会互相传递流言。48 格范围内的邻居会听说这份
工作（“我听说你给农民 Kael 带了 16 个小麦”），并在与你交谈时提起。

每位村民都会把你视为陌生人、朋友（帮过忙或交易良好后），或者在你帮忙十次后，视为村庄的
英雄。伤害村民会让它变得警惕或敌对：在负面
流言消散前，它不会给你安排工作。

Speech bubbles

See who's talking

村民说的话会以气泡形式显示在发言者头顶，并标注其名字。AI思考时会显示“…”，
随后显示回答，持续时间取决于回答长度，最长几秒。气泡是原版文本显示实体，跟随村民移动，因此
附近所有人都能看到对话。使用 display.speechBubbles = false 关闭气泡。

AI providers

Any AI, or none

在 config/smartvillagers/config.toml 中选择预设：DeepSeek、OpenAI、OpenRouter、NanoGPT（按量付费或
订阅）、Ollama，或者选择LM Studio，使用自己电脑上的模型；也可以使用任意兼容 OpenAI 的端点。即使
没有配置服务提供商，请求、声望、流言和气泡也都能通过内置对话功能正常运作。

村民的提示词包含其个性与职业、你们最近的对话、生物群系、时间与天气、袭击和附近的怪物、你手持的物品、你的声望、它听到的消息，以及尚未完成的请求
AI只负责组织回复措辞。报价、进度和付款由模组决定，因此没人能靠说服村民来白拿绿宝石
玩家会在聊天内容发送给服务提供商之前，先同意一次 AI 使用；密钥和提示词绝不会写入日志
按玩家和每分钟设置的请求速率限制、并发上限及回复长度限制，让费用保持可预期
可选：通过 Simple Voice Chat 让村民朗读回复

Advancements

Commands

| 命令 | 谁可使用 | 作用 |
|———|—–|——|
| /villagerai consent accept 或 decline | 所有人 | 允许或拒绝 AI 回复 |
| /villagerai requests | 所有人 | 查看你尚未完成的请求及进度 |
| /villagerai request accept 或 decline | 所有人 | 接受或拒绝最近的报价（聊天按钮） |
| /villagerai request assign <villager> [fetch or slay] | 管理员 | 让村民向你发出请求 |
| /villagerai persona get / set / clear | 管理员（或获准时的所有人） | 查看村民的名字、特征、风格、背景故事及你与它的关系 |
| /villagerai memory clear [villager] | 管理员 | 清除对话、请求和消息 |
| /villagerai status、reload、test、debug | 管理员 | 诊断信息 |

Configuration

[display]
speechBubbles = true

[proximity]
ignorePlayerToPlayerChat = true

[requests]
enabled = true
maxActive = 3            # open requests per player
cooldownMinutes = 10     # before the same villager offers you another (20 = one Minecraft day)
reputationReward = 10    # vanilla positive gossip per finished request (0 to 25)

[ai]
provider = "DEEPSEEK"    # DEEPSEEK, NANOGPT, NANOGPT_SUBSCRIPTION, OPENAI, OPENROUTER, OLLAMA, LMSTUDIO, CUSTOM
model = "deepseek-flash"
apiKey = ""

现有的 1.x 配置会在首次启动时添加新键，不会重命名任何内容。完整列表见
README和
服务提供商指南。

Downloads and compatibility

Every loader, five versions

| Minecraft 版本 | Java 版本 | 加载器 |
|———–|——|———|
| 1.20.1 | 17+ | Fabric（需 Fabric API）、Forge 47 |
| 1.21.1 | 21+ | Fabric（需 Fabric API）、Forge 52、NeoForge |
| 26.1.2 | 25+ | Fabric（需 Fabric API）、NeoForge |
| 26.2 | 25+ | Fabric（需 Fabric API）、NeoForge 26.2.0.93 或更新版本 |
| 26.3 | 25+ | Fabric（需 Fabric API）、NeoForge 26.3.0.97 或更新版本 |

文件命名为 smartvillagers-<loader>-<minecraft>-2.0.0.jar。请将模组安装在服务器上；单人游戏则安装在
你的游戏中。Simple Voice Chat 为可选项（需安装在服务器和客户端），可用于语音回复。

FAQ