Villager API

村民 API

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

它能做什么？

这个模组让你能够创建完全自定义的村民，拥有你自己的：

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

所有操作均通过 villagerpacks 文件夹中的 JSON 文件处理。无需编码，无需复杂设置——只需制作你的文件并加载游戏即可。

快速示例

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

1. 创建 villagerpacks/my_pack/villagers/poi_types/alchemist.json 和 villagerpacks/my_pack/villagerapi_config.json
2. 定义工作站方块
3. 添加链接到该 POI 类型的职业文件
4. 设置你的交易
5. 为职业叠层放入纹理

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

你可以自定义什么？

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

这是为谁准备的？

如果你曾想过在不处理 Java 代码的情况下为你的整合包或模组添加村民，这就是为你准备的。它专为包制作者和模组开发者打造，他们想要村民相关内容，但不想费心学习编写 Java 代码。

该模组既可作为村民包等常规资源包，也可通过简单地将村民文件夹放入模组主目录来作为模组的一部分。多个包可以同时运行——后加载的包会在重叠处覆盖先前的包。

完整文档

请在此查看包含示例和所有可用选项的完整文档： https://github.com/frikinjay/villagerapi/blob/main/DOCUMENTATION.md

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

文档包括完整的包结构、所有 JSON 格式、物品组件示例以及一个完整的示例包，助你快速上手。