Equipment Sources

Armor on limb[type=X;armor=true] bones and wings on elytra bones come from vanilla, the Equipment-Source config and every folder or zip registered through the API. A plugin that adds its own armor or elytras can register where its equipment files are, so its items show on models without extra setup.

Adding a source

File pack = new File(getDataFolder(), "pack.zip");
ModelEngineAPI.getAPI().getModelGenerator().addEquipmentSource(pack);

The source is a folder or zip in resource pack layout: assets/<namespace>/equipment/<name>.json plus the textures it points to under assets/<namespace>/textures/entity/equipment/. The older models/equipment/ folder of 1.21.2 and 1.21.3 packs is read too. Items whose equippable asset is <namespace>:<name> then show that armor or elytra.

Note: Sources are read every time models are imported, on startup and on /meg reload. Register yours in onEnable. If the startup import already ran before your plugin enabled, the source is used from the next /meg reload.

Removing a source

ModelEngineAPI.getAPI().getModelGenerator().removeEquipmentSource(pack);

The armor from that source is gone after the next /meg reload.

Priority

When two sources define the same equipment, the Equipment-Source config wins, then API sources in the order they were added. A source can replace vanilla armor by defining its id, for example minecraft:diamond. Textures in the minecraft namespace can be left out of a source, the player's own textures are used.

Updated Nov 20, 2026