Back to mods
Armory API project artwork

CurseForge · Minecraft mod

Armory API

A lightweight, cross-loader API for defining customizable tool and armor sets

Choose a version Pick your version below, then grab the matching file.

Quick answer

Which Armory API release should I use?

Updated last month
Latest stable file [Fabric] v3.0.0-mc1.21.1
Game version 1.21.1
Loader Fabric

Armory API [Fabric] v3.0.0-mc1.21.1 targets 1.21.1 with Fabric. 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.

Client Source doesn’t say
Dedicated server Source doesn’t say
Loader for this release Fabric
Required install it here Optional supported, not mandatory Not supported do not install here Source doesn’t say do not assume

The source does not explicitly classify this release as client-only or server-only.

What else does Armory API [Fabric] v3.0.0-mc1.21.1 need?

[Fabric] v3.0.0-mc1.21.1. Change the file and its required mods may change too.

No extra mods listed for this file

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 [Fabric] v3.0.0-mc1.21.1. Pick another file and the loader, install side or required mods may change.

  1. 01

    Stick to this file

    Use [Fabric] v3.0.0-mc1.21.1. It targets 1.21.1 with Fabric; another release may have different loader, side or dependency requirements.

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

  3. 03

    Put it on the correct side

    The project page does not say whether this file belongs on the client, dedicated server, or both.

  4. 04

    Pick the file you checked

    Use the “Get this file” button beside [Fabric] v3.0.0-mc1.21.1. 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.

6 available setups

Check the dependencies, then try the file in a copied instance before changing a world you care about.

Recent files

Armory API versions and loaders

18 of 18 releases match

Looking for an older file? The official CurseForge project page is in Resources.