Armory API
by Xun
Armory API is a library that defines customizable tool and armor sets for Minecraft mods, and it runs on the server side only.
What it does
The library is built around two types, ToolSet and ArmorSet, which group the tools and armor a mod registers. A ToolSet does not have to be limited to the standard vanilla tool collection, because it can hold custom tool types added through ToolPieceType instances. Each ToolPieceType carries its own item factory, statistics and properties, so a mod can introduce new tool categories alongside the vanilla ones.
Armory API handles item registration automatically and reduces the duplicated code that a mod would otherwise write to register each tool and piece of armor. The registration step is carried out by a loader-specific implementation, so the core logic stays independent of Fabric, Forge and NeoForge. Helper APIs let a mod create custom tool and armor behaviors that extend beyond vanilla functionality.
The project was extracted from XunLib and keeps its scope small, with minimal dependencies. Only mods that explicitly depend on Armory API require it. The library is released under the MIT License and is open source, with its source code and issue tracker public. Files are published for Fabric, Forge and NeoForge, and the latest build targets 1.21.1 for each of them.
Key features
Customizable tool sets
ToolSet and ArmorSet group tools and armor into sets that a mod can define and manage.
Custom tool categories
ToolPieceType lets a mod add tool categories, each with its own item factory, statistics and attributes.
Automatic item registration
Items in a set are registered without each mod writing its own registration code.
Helper APIs for custom behavior
Helper APIs implement custom tool and armor behavior, so mods can change how these items work.
Modular use
Each system can be used separately, so a mod can take only ToolSet or only ArmorSet.
Compatibility
Latest build for each game version and loader.
Only full game releases are shown. This mod publishes no snapshot builds.
Questions
Does Armory API need to be installed on the client?
Which loaders does Armory API support?
Do other mods need Armory API?
In the catalog
Armory API is one of 3,514 Library mods on ModsFinder, and one of 2,348 Library mods for Fabric. 13,252 mods support Minecraft 1.21.3.
More from Xun
Similar mods
What the author says
Armory API is a lightweight library that provides shared code for defining and managing tool sets and armor sets in Minecraft mods. The project was extracted from XunLib to support Forge independently and keep the API lightweight, modular, and loader-agnostic.
Official listing
- Modrinth page
- modrinth.com/mod/armory-api
- Owner
- Xun
- Published
- 2026-01-27
- Updated on Modrinth
- 2026-08-30
- Facts verified
- 2026-10-15
