Villager API - 村民API

村民 API

一个简单的数据驱动框架，用于创建自定义村民职业、类型和交易，无需接触任何代码。只需将 JSON 文件放入文件夹即可完成。

它能做什么？

这个模组让你可以创建完全自定义的村民，包括：

• 职业 - 带有自定义工作站和交易列表的新工作
• 类型 - 与特定生物群系绑定的不同村民外观
• 交易 - 完全控制村民在每个等级买卖的物品
• 英雄礼物 - 袭击后奖励的自定义战利品表

所有内容都通过 villagerpacks 文件夹中的 JSON 文件处理。无需编码，无需复杂设置——只需创建文件并加载游戏。

快速示例

想要一个使用哭泣黑曜石块作为工作站的炼金术士村民？

• 创建 villagerpacks/mypack/villagers/poitypes/alchemist.json 和 villagerpacks/mypack/villagerapiconfig.json
• 定义工作站方块
• 添加链接到该 POI 类型的职业文件
• 设置你的交易
• 放入职业覆盖纹理

就这样。模组会处理注册、交易机制和所有其他事项。

你可以自定义什么？

• 工作站 - 任何方块都可以成为工作站点
• 交易池 - 精确定义村民在每个经验等级（从新手到大师）提供的物品
• 物品组件 - 完全支持附魔、自定义名称、药水和 Minecraft 使用的所有数据组件
• 藏宝图 - 出售指向模组或原版结构的自定义标记地图
• 生物群系外观 - 让村民根据生成地点看起来不同
• 生物群系特定交易 - 相同职业，根据位置有不同的库存

这是为谁设计的？

如果你曾经想为你的整合包或模组添加村民，但又不想处理 Java 代码，那么这个模组就是为你准备的。它专为那些想要村民内容，但又不想陷入学习和编写 Java 代码的麻烦的整合包制作者和模组开发者而设计。

既可以通过类似村民包的常规资源包使用，也可以作为模组的一部分，只需在模组主目录中放入一个 villagers 文件夹。多个包可以同时运行——后面的包会在有重叠时覆盖前面的包。

完整文档

查看包含示例和所有可用选项的完整文档：

https://github.com/frikinjay/villagerapi/blob/main/DOCUMENTATION.md

你可以在这里在线生成包，无需手动创建所有文件：

村民包生成器

文档包括完整的包结构、所有 JSON 格式、物品组件示例以及一个完整的示例包来帮助你入门。