ModsFinder

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.

FabricForgeNeoForgeServer-side onlyMIT LicenseOpen source1.21.1 – 1.21.3

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

  1. Customizable tool sets

    ToolSet and ArmorSet group tools and armor into sets that a mod can define and manage.

  2. Custom tool categories

    ToolPieceType lets a mod add tool categories, each with its own item factory, statistics and attributes.

  3. Automatic item registration

    Items in a set are registered without each mod writing its own registration code.

  4. Helper APIs for custom behavior

    Helper APIs implement custom tool and armor behavior, so mods can change how these items work.

  5. 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.

1.21.32.3.1-mc1.21.32.3.1-mc1.21.32.3.1-mc1.21.3
1.21.13.0.0-mc1.21.13.0.0-mc1.21.13.0.0-mc1.21.1
ReleaseBetaAlphaNot available

Only full game releases are shown. This mod publishes no snapshot builds.

Questions

Does Armory API need to be installed on the client?

No. Server owners install it, and players connect with no copy of their own.

Which loaders does Armory API support?

Fabric, Forge and NeoForge. Each has a file for 1.21.1, with the latest published on 2026-08-30.

Do other mods need Armory API?

Only mods that explicitly depend on it require the library. It does not replace the loader's registration system for mods that do not use it.

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

All projects

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.
Xun, on the Modrinth page

Official listing

Owner
Xun
Published
2026-01-27
Updated on Modrinth
2026-08-30
Facts verified
2026-10-15

Tags