Villager API
一个简单、数据驱动的框架,用于创建自定义村民职业、类型和交易,无需编写任何代码。只需将 JSON 文件放入文件夹即可完成。您还可以将自定义交易覆盖或合并到原版或其他模组村民的交易中。
功能介绍
本模组允许您通过以下方面创建完全自定义的村民:
- 职业 - 拥有自定义工作台和交易列表的新职业
- 类型 - 与特定生物群系绑定的不同村民外观
- 交易 - 完全控制村民在每个等级买卖的物品
- 英雄礼物 - 为袭击战后的奖励提供自定义战利品表
所有内容均通过 villagerpacks 文件夹中的 JSON 文件处理。无需编码,无需复杂设置——只需制作文件并启动游戏即可。
快速示例
想要一个使用哭泣的黑曜石方块作为工作台的炼金术士村民吗?
- 创建
villagerpacks/my_pack/villagers/poi_types/alchemist.json和villagerpacks/my_pack/villagerapi_config.json - 定义工作台方块
- 添加链接到该兴趣点类型的职业文件
- 设置您的交易
- 放入职业的纹理覆盖层
就是这样。模组会自动处理注册、交易机制及其他所有事项。
可自定义项
- 工作台 - 任意方块均可成为工作站点
- 交易池 - 精确定义村民在每个经验等级(学徒至大师)提供的交易
- 物品组件 - 完整支持附魔、自定义名称、药水以及 Minecraft 使用的所有数据组件
- 藏宝图 - 出售指向模组或原版结构的藏宝图,并带有自定义标记
- 生物群系外观 - 根据村民生成的位置使其呈现不同的外观
- 生物群系专属交易 - 相同的职业,但根据村民的生物群系类型拥有不同的库存
适用对象
如果您曾希望向整合包或模组中添加村民内容,却不想处理 Java 代码,那么这就是为您准备的。它专为那些希望在不学习或编写 Java 代码的情况下获得村民内容的整合包制作者和模组开发者而设计。
既可作为普通的资源包(如村民包)运行,也可作为模组的一部分运行,只需将 villagers 文件夹放在模组的主目录中即可。多个包可以同时运行——在存在重叠时,后面的包会覆盖前面的包。
完整文档
在此查看包含示例和所有可用选项的完整文档:
您可以在此在线生成打包文件,无需手动创建所有文件: Villager Pack Generator
文档包括完整的包结构、所有 JSON 格式、物品组件示例以及一个完整的示例包以帮助您入门。
Villager API
A simple data-driven framework for making custom villager professions, types, and trades without touching any code. Just drop JSON files in a folder and you're done. You can also override or merge custom trades into vanilla or other modded villager's trades.
What does it do?
This mod lets you create completely custom villagers with your own:
- Professions - New jobs with custom workstations and trading lists
- Types - Different villager appearances tied to specific biomes
- Trades - Full control over what villagers buy and sell at each level
- Hero Gifts - Custom loot tables for post-raid rewards
Everything is handled through JSON files in the villagerpacks folder. No coding, no complex setup—just make your files and load up the game.
Quick Example
Want an Alchemist villager who uses a crying obsidian block as their workstation?
- Create
villagerpacks/my_pack/villagers/poi_types/alchemist.jsonandvillagerpacks/my_pack/villagerapi_config.json - Define the workstation block
- Add the profession file linking to that POI type
- Set up your trades
- Drop in textures for the profession overlay
That's it. The mod handles registration, trade mechanics, and everything else.
What can you customize?
- Workstations - Any block can be a job site
- Trading pools - Define exactly what villagers offer at each experience level (Novice through Master)
- Item components - Full support for enchantments, custom names, potions, and all the data components Minecraft uses
- Treasure maps - Sell maps to modded or vanilla structures with custom markers
- Biome appearances - Make villagers look different depending on where they spawn
- Biome-specific trades - Same profession, different inventory based on villager's biome type
Who and what is this for?
If you've ever wanted to add villagers to your modpack or mod without dealing with Java code, this is for you. It's built for pack makers and modders who want villager content without the headache of getting into learning and writing java code.
Works with both regular resource pack like villager packs and as part of mods by simply putting a villagers folder in your mods main directory. Multiple packs can run at once—later packs override earlier ones where there's overlap.
Full Documentation
Check the complete documentation with examples and all available options here:
You can generate a pack online here without having to manually create all the files: Villager Pack Generator
The docs include the full pack structure, all JSON formats, item component examples, and a complete example pack to get you started.
下载 Villager API
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Villager API
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Villager API
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Villager API
下载 Villager API
下载 Villager API
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Villager API
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Villager API
下载 Villager API
下载 Villager API
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
新增
- Fabric 现已支持 Minecraft 26.4 快照(测试版)。此为专为 26.4 快照 4 构建的独立版本;在 26.4 快照上请使用此版本,而非 26.3 构建。NeoForge 尚不支持 26.4。
说明
- 村民包、职业、村民类型、交易、村庄英雄礼物以及额外村庄房屋的功能与 26.3 保持一致。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
模组
一个用于收集生物掉落物的多区块模组。
模组
显示你正在注视的方块的信息。(适用于 Minecraft 1.16+ 的 Hwyla/Waila 分支)
模组
查看物品与配方
模组
在游戏画面角落显示附近世界地形、玩家、生物和实体的地图。可创建路径点,帮助你找到标记过的位置。
模组
使用 JavaScript 编辑配方、添加自定义物品、编写世界事件!
模组
适用于 MC 1.18+ 的 Effekseer 加载器
评论 0
登录后参与评分
还没有评论,来抢沙发吧