自定义交易

Custom Villagers 允许你在 Forge 1.12.2 中通过 JSON 文件定义村民职业：哪种物品或工作方块赋予该职业、村民的外观，以及每个等级的所有交易——物品、数量、附魔、药水、染色盔甲、藏宝图。Minecraft 1.14–1.17 的 13 种职业以可编辑文件的形式开箱即用，并且村民按照 1.14 的方式升级：每次交易获得经验，达到阈值时进入新等级，使用 1.14 的交易界面，带有可滚动的报价列表和经验条。

工作原理

• 职业文件：config/customvillager/professions/ 中的每个 *.json 就是一个职业。首次启动时，模组会在那里放入 1.14 的 13 种职业——盔甲匠、屠夫、制图师、牧师、农民、渔夫、制箭师、皮匠、图书管理员、石匠、牧羊人、工具匠、武器匠（交易表来自 Minecraft Wiki，1.12.2 中缺失的物品已替换）——以及一个描述格式的 README.md。编辑它们、删除它们、添加你自己的。语法错误的文件会被跳过并在日志中留下一条消息；未知的物品、附魔和药水 id 会在启动时报告。
• 赋予职业——有两种模式（professions.cfg）。SNEAK_CLICK（默认）：潜行并右键点击一个从未交易过的村民，同时手持该职业的物品——盔甲匠对应熔炉、牧羊人对应剪刀，等等。BLOCK：将该职业的工作方块放在村民附近，就像 1.14 中的工作站点一样——8 格范围内最近的、从未交易过的村民会接受这份工作，并一直绑定到该方块，直到它死亡或方块被破坏；在村民交易之前破坏方块，它会变回随机原版职业，可以自由接受另一份工作。捆绑文件使用原版替代物作为工作方块（熔炉、骨块、阳光探测器、干草捆、睡莲、发射器、书架、石砖、羊毛、铁砧、铁块）——jobBlock 接受任何方块，包括来自其他模组的方块。已经交易过的村民会保留其职业；傻子村民永远不会接受工作（可配置）。
• 升级：新手 → 学徒 → 老手 → 专家 → 大师，分别在 10 / 70 / 150 / 250 经验时达成。村民支付绿宝石的交易按等级给予 2 / 10 / 20 / 30 / 30 经验，村民出售物品的交易给予 1 / 5 / 10 / 15 / 30——这些是 1.14 的数值，任何交易都可以设置自己的 xp。升级会在你关闭界面几秒后发生，伴有生命恢复效果和粒子，就像原版一样。空手潜行并右键点击村民可以查看其等级和经验。
• 随机报价：pick 会从该等级的池子中给予村民该数量的随机交易（捆绑文件使用 2，与 1.14 一致）；数量、附魔、药水和颜色对每个村民只随机一次——两个图书管理员永远不会出售相同的书。
• 交易界面：就是 1.14 的那个——带有滚动条的报价列表、缺货标记、物品提示、标题中显示村民等级，以及一个经验条，预览所选交易给予的经验；点击会把付款从你的物品栏移动到槽位中（最多一整组）。更喜欢经典窗口？modernTradeGui=false 会保留 1.12 界面，只添加等级和经验条。
• 升级和界面也适用于原版 1.12 村民和其他模组的村民（它们保留自己的交易）。两者都可以在配置中关闭。

文件格式

相同的参考内容也在文件旁边的 config/customvillager/professions/README.md 中。

{ "professionId": "armorer", "displayName": "Armorer", "displayNames": { "ru_ru": "Бронник" }, "item": "minecraft:furnace", "jobBlock": "minecraft:furnace", "texture": "minecraft:textures/entity/villager/smith.png", "zombieTexture": "minecraft:textures/entity/zombie_villager/zombie_smith.png", "pick": 2, "trades": [ { "level": 1, "buy": { "item": "minecraft:coal", "count": 15 }, "sell": { "item": "minecraft:emerald", "count": 1 }, "maxUses": 16 } ] }