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 代码，也能添加村民相关内容。

既可以像村民整合包一样与常规资源包配合使用，也可以作为模组的一部分，只需将 villagers 文件夹放进模组主目录即可。多个整合包可以同时运行；内容重叠时，后加载的整合包会覆盖先加载的整合包。

完整文档

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

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

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