村民潜力

让每个 Minecraft 村民都拥有类似原版的个性化天赋、真正的职业成长和专业化交易。

村民潜能（Villager Potential）

村民潜能（Villager Potential）将村民从可互换的交易机器转变为拥有自身优势和职业生涯的个体。每个村民天生对不同职业拥有不同的天赋，继承父母的特性，通过在工作中投入实际时间提升技能，发展专长，并记住所学到的交易。

该模组保持与原始 Minecraft 接近。它不添加自定义方块、物品、实体或替代交易菜单。相反，它扩展了现有的村民系统，并保留原版及模组交易池的权威性。

主要特性

个体职业天赋

每个村民在每种职业上都会获得一个永久的成长速度加成。一个村民可能是个优秀的农民，但却是糟糕的图书管理员，而另一个村民可能拥有完全不同的优势。稀有天赋可以造就非凡的专家。

遗传与继承

孩子继承父母天赋的混合体，并带有可配置的随机变化和突变。职业经验、学到的交易和市场需求的不会继承：每个新村民仍然必须打造自己的职业生涯。

通过实际工作提升

村民在加载、被雇佣、工作时间保持清醒且能够使用正确工作站时，便会获得职业技能。交易会提高他们的活动倍率并加速训练，但购买不会直接给予技能点或原版交易等级。

技能控制着熟悉的“新手到大师”的进阶过程。已有的村民永远不会失去他们已获得的等级。如果村民失去对工作站的访问权限，其成长将停止，并且交易会被阻止，直到再次获得有效的工作站。

专业化

当村民开始从事某项职业时，会获得一个持久化的专长。专长会将现有的交易池偏向至合适的类别，而不会发明原版或其他模组未提供的交易。定义由数据驱动，并可通过数据包进行扩展。

持久且不断发展的交易知识

默认情况下，已习得的交易仍属于该村民的职业知识。破坏工作站、更换职业或重新加载配置不再会静默地重新随机化村民所知道的一切。

可选的交易记忆模式有：

• 持久（Persistent） — 已学到的交易保持已有状态，新等级会添加交易。
• 原版（Vanilla） — 原版重新随机化，但仍记录交易历史。
• 加权记忆（Weighted Memory） — 近期见过的交易出现概率降低，并随时间恢复。
• 耗尽（Exhaust） — 使用过的候选交易会暂时不可用。
• 循环（Cyclic） — 候选交易在每个周期出现一次后才会重复。

每种职业都保留其自身的技能、专长、活跃度、已学交易、交易历史和市场供求。回归旧职业将恢复该职业生涯。

基于需求和睡眠的补货机制

成功的购买会提高所用特定交易的物品需求。大多数需求的交易会要求多支付高达 12.5% 的该物品。这是为了平衡交易并提高需求高商品的售价。你可以在配置中更改此设定！

村民只有在真正入睡并醒来后才会重新补货。完成睡眠会重置累积的需求并恢复基于需求调整的价格。 在夜间，村民不会工作，也不会获得经验值。

支持版本

• Minecraft 1.20.1 — Forge 47.4.10 至 47.x
• Minecraft 1.21.1 — NeoForge 21.1.233 至 21.1.x

请使用与您的 Minecraft 版本和模组加载器都匹配的 JAR 文件。Forge 版本使用 Java 17；NeoForge 版本遵循 Minecraft 1.21.1 并使用 Java 21。 支持在服务器上运行！

配置

所有游戏玩法设置均按世界存储在：

<world>/serverconfig/villager_potential-server.toml

（适用于 1.20.1 版本），以及在：

config/villager_potential-server.toml

（适用于 1.21.1 版本）！

这包括天赋生成、稀有天赋、继承、技能成长、活跃度、专长强度、交易记忆行为、需求定价、库存影响和诊断信息。

管理及诊断命令可通过以下命令使用：

/villagerpotential

兼容性

• 保守地使用现有的原版和模组职业及交易列表。
• 未知交易仍可使用，不会被移除。
• 包含一个带版本号的 API 以及供其他模组使用的生命周期/交易钩子。
• 不声称与 Bukkit 或 Paper 兼容。

许可证

村民潜能（Villager Potential）使用 Apache License 2.0 许可。