CurseForge · Minecraft mod
Armory API
A lightweight, cross-loader API for defining customizable tool and armor sets
Quick answer
Which Armory API release matches 1.21.3 Forge?
Armory API [Forge] v2.3.1-mc1.21.3 targets 1.21.3 with Forge. The project page does not say whether this file belongs on the client, dedicated server, or both. No extra mods listed for this file.
Where it goes
Is Armory API required on the client, server, or both?
The project page does not say whether this file belongs on the client, dedicated server, or both.
The source does not explicitly classify this release as client-only or server-only.
What else does Armory API [Forge] v2.3.1-mc1.21.3 need?
[Forge] v2.3.1-mc1.21.3 on 1.21.3 Forge. Every mod below is checked against that same setup.
This file does not list any required mods. Do not add a library just because a different file uses it.
This file does not list any required or optional mods.
Before you install it
Add Armory API without breaking your instance.
Built for Armory API [Forge] v2.3.1-mc1.21.3 on 1.21.3 Forge. Pick another file and the loader, install side or required mods may change.
- 01
Stick to this file
Use [Forge] v2.3.1-mc1.21.3. It targets 1.21.3 with Forge; another release may have different loader, side or dependency requirements.
- 02
Bring the mods it needs
This file does not list any required mods. Do not add a library just because a different file uses it.
- 03
Put it on the correct side
The project page does not say whether this file belongs on the client, dedicated server, or both.
- 04
Pick the file you checked
Use the “Get this file” button beside [Forge] v2.3.1-mc1.21.3. It opens that exact file at the source.
About this project
What does Armory API add?
Armory API
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.
Supported loaders:
- Forge
- NeoForge
- Fabric
Features
- APIs for defining ToolSet and ArmorSet
- Reduced duplication when registering tools and armor
- Loader-independent implementation
- Small scope and minimal dependencies
- Compatibility with modded tool types
FAQs
Can I use only ToolSet or only ArmorSet?
Yes. The systems are independent and can be used separately.
Does this handle item registration automatically?
No. Registration is handled by the consuming mod or loader-specific implementation.
Can I create custom tool or armor behaviors with this?
Yes. Armory API includes helper APIs for implementing custom tool and armor behavior, allowing mods to extend or customize functionality beyond vanilla behavior.
Can I add custom or modded tool types? Yes. ToolPieceType is specifically designed to allow custom tool categories with their own item factories, statistics, properties, and attributes.
Can a ToolSet contain only some tool types? Yes. A ToolSet is no longer limited to the standard vanilla tool collection. Any combination of supported ToolPieceType instances can be included.
Can other libraries or frameworks integrate with Armory API?
Yes. The API is designed to stay lightweight and modular so it can be integrated into larger modding frameworks if needed.
Dependency
Armory API is a library mod and is only required by mods that explicitly depend on it.
Armory API does not replace the loader's item registration system and does not require consuming mods to use a particular registration framework.
Note: The mod ID is armories to avoid conflicts with other mods using similar names.
Project description from CurseForge.
Pick your setup
Armory API by Minecraft version and loader
Choose the version and loader you play, then open the matching release.
1.21.1
3 loader buildsCheck the dependencies, then try the file in a copied instance before changing a world you care about.
Recent files
Armory API versions and loaders
[Forge] v2.3.1-mc1.21.3
Armory API-forge-1.21.3-2.3.1.jar
25 May 2026
[Forge] Armory API v2.3.0
Armory API-forge-1.21.3-2.3.0.jar
24 May 2026
Looking for an older file? The official CurseForge project page is in Resources.