Wearable backpack API for Fabric mods.

Backpack Gear is a small shared dependency for modders. It gives other Fabric mods one common way to mark items as backpacks, detect them in code, and prepare them for a dedicated backpack slot.

Start integration View API

Fabric Loader based mod dependency

26.2 Minecraft target version

API Register backpack items in Java

Tags Register backpack items with data

What Backpack Gear does

Use this mod when your own mod has backpack items and you want them to be recognized by a shared backpack system instead of every mod inventing a separate slot rule.

Shared backpack detection

Other mods can call one API to check if an ItemStack should count as a backpack.

Developer friendly

Ready for gear slot support

The dependency creates the base for a backpack equipment slot while keeping armor slots free for armor.

Install in your mod

Add Backpack Gear as a dependency, then declare it in your mod metadata. If the jar is only local, use the file dependency until you publish it to a Maven repository.

Add the jar dependency

Use this when Backpack Gear jar is beside your mod project.

build.gradle

dependencies {
    modImplementation files("../backpack-gear-26.2/build/libs/backpack_gear-1.0.0-fabric-26.2.jar")
}

Require Backpack Gear

This makes Minecraft load Backpack Gear before your mod.

fabric.mod.json

{
  "depends": {
    "fabricloader": ">=0.19.3",
    "minecraft": "~26.2",
    "fabric-api": "*",
    "backpack_gear": ">=1.0.0"
  }
}

Register by API

Best option when your mod already registers items in Java. Call the API during your mod initializer after your backpack item exists.

Works with custom backpack classes.
Does not need an extra JSON tag file.
Good for mods that generate or control items in code.

ModInitializer example

import net.arthurorsi.backpackgear.api.BackpackGearApi;
import net.fabricmc.api.ModInitializer;

public final class YourMod implements ModInitializer {
    @Override
    public void onInitialize() {
        BackpackGearApi.registerBackpackItem(MyModItems.MY_BACKPACK);
    }
}

Check an ItemStack

if (BackpackGearApi.isBackpack(stack)) {
    // Your item is registered as a backpack.
}

Register by item tag

Best option when you want a simple data-driven integration. Put your backpack item id in the Backpack Gear tag.

Path

src/main/resources/data/backpack_gear/tags/item/backpacks.json

backpacks.json

{
  "replace": false,
  "values": [
    "your_mod:your_backpack"
  ]
}

Current integration status

Backpack Gear is built as a shared base dependency. Keep your own backpack storage, screen, tooltip, and recipes inside your mod, then use Backpack Gear to make the item recognizable as backpack gear.

Use Backpack Gear for

Backpack item registration, item tag support, and common backpack detection.

Keep in your mod

Inventory rows, screen layout, item model, textures, recipes, and storage logic.

Recommended setup

Depend on Backpack Gear, register each backpack item, then check isBackpack where your equip logic needs it.