Dynamic Villager Trades Neoforge

你可以参考生成的原版数据包，了解一些已配置交易的示例。每个 JSON 文件都会扩展或替换（如果 replace 为 true）某个特定职业的交易，这些交易在 offers 字典中指定。字典中的每个条目代表一组交易，并指定可以从该组中选取的交易数量下限 min_trades 和上限 max_trades；此外，还可以选择性指定该组的亲和度（稍后会详细介绍）以及组内随机性（数值越低，村民越快确定具体交易）。如果 replace 为 false，交易会添加到同名的现有组中；否则，该组会被整体替换。虽然组名（键）可以任意设置，但它会影响交易在 GUI 中的显示顺序，因此默认数据包中的组名都以数字开头（否则会按字母顺序排列）。交易列表中的每个条目都指定了可选取该交易的最低等级（例如学徒）、交易类型（1.18–1.20 版本的说明见 SJVT wiki*，1.21 及更高版本请参考新版示例数据包）、交易使用时会应用到村民属性上的增量，以及可选的亲和度。村民的属性代表其与玩家过往互动的记忆，作用类似一种子职业，会让某些交易相较于其他交易更容易被选中。每个属性由一个任意名称（例如 “luck”）和一个数值构成，初始值为 0；每当使用具有该属性的交易时，数值就会根据该交易中指定的 “attributes” 增量进行调整（例如，购买掠夺或时运附魔书时）。请注意，每个村民都拥有配置中提到的所有属性，因此无需“声明”属性；增加任何名称的属性始终有效。另一方面，交易对各项属性的亲和度决定了村民的属性值会如何影响该交易被选中的概率。如果没有明确指定亲和度，系统会根据属性增量自动计算（增量越高，亲和度越高）。如果你希望某项交易增加某个属性，却不与该属性产生亲和度，或者反之，可以同时指定该交易的 attributes 和 affinities。如前所述，亲和度字典也可以放在交易组中，而不是某笔交易中。这样一来，不同组之间的交易就不会直接相互竞争：模组会先根据亲和度选择一个组，再从该组内选择一笔交易。如果各组中的交易数量相差很大，这种做法就很有用，因为它可以避免仅仅由于组较大，就导致该组更常被选中。只有在 max_trades > min_trades 时，这样做才有意义。

请注意，如果某个特定职业（例如模组添加的职业）缺少配置，模组会在运行时自动生成配置。该配置中的交易会与原版交易非常相似，但那些在原版中不一定会出现的交易，各自都会有独特的属性，并与同等级的交易归入同一组（基本上，村民会专精于特定交易，但仅限于原版中通常需要由村民自行选择的交易；不同等级的交易之间不会相互竞争）。

* 本模组还添加了另外两种交易类型：enchant_specific_book 和 sell_specific_potion_holding_item。

向图书管理员职业添加附魔书交易的说明

默认的图书管理员配置会在运行时生成，并为附魔书交易使用四个相同的组，唯一的区别是提供的经验值不同，这样交易就会尽可能贴近原版。因此，除非你打算整体替换图书管理员职业，否则应将每笔新交易都添加到这四个组中。属性方面，建议沿用现有属性（offense、defense、bow 等），以保持交易权重平衡。选择属性时，请注意：

– 亲和度过于相似的交易，可能会妨碍村民专精于玩家想要的交易。例如，如果你添加一笔同时对 “tool” 和 “fast” 属性具有亲和度的交易，那么专精于这两项属性的村民就会在效率附魔书和新书之间随机切换，无论玩家购买其中任何一本书多少次都是如此。这未必是坏事，因为玩家可能确实想从同一名村民那里购买这些书；缩小交易大厅规模正是本模组的目标之一。
– 亲和度与大多数其他交易差异过大的交易，也可能难以专精，因为玩家大多数时候都会获得无法提升目标属性的交易。例如，如果你添加两笔交易，并分别为它们设置两项全新的独有属性，那么玩家只能通过购买这两本书，才能让村民专精于它们。然而，附魔书种类繁多，这两笔交易一开始很少出现，玩家可能需要等待村民补货很多次，才有希望选中其中一本作为交易。另一方面，如果这些交易的属性分别是一个新的自定义属性和 “fire”，玩家就可以通过购买火焰附加等书籍，提高获得这些书的概率。
– 只有当这些附魔书确实与相应属性不兼容时，属性增量和亲和度才应设为负值。例如，如果你希望某本书与火焰附加同时出现的可能性极低（也许因为它与水有关），可以将 “fire” 设为负值。大多数情况下，这可能不是个好主意。
– 默认配置为 enchanter 属性使用 1 作为增量（让附魔书比其他交易更受青睐）；low_level 属性的增量设在 -1 到 0.5 之间（让低等级附魔书更受青睐。请注意，等级是相对于该附魔的最高等级而言的，因此火焰附加 II 和效率 V 都会使该属性降低 1，而效率 II 会使其增加 0.5）；书籍的主要类别（armor、sword、tool、bow、fishing、trident、crossbow、all）使用 1；次要类别之间则分配 1（例如，如果一本书属于 “melee”、”luck” 和 “resource”，每项属性都会增加 0.333）。添加交易时尽量遵循这些规则，以保持平衡。各类别都和其他属性一样，也是属性；你可以自由创建新类别，但如前所述，这可能会让你的交易更难获得。