Skip to content

Installation

Brennan Hatton edited this page Jun 10, 2026 · 1 revision

Installation

Adventure Item Stats ships one jar per mod loader. Pick the jar that matches the loader your instance is running — they are not interchangeable.

Requirements

Loader Minecraft Also required Jar
Fabric 1.21.1 Fabric Loader 0.16+ and Fabric API 0.103.0+ adventureitemstats-fabric-<version>.jar
Forge 1.21.1 Forge 1.21.1-52.1.x adventureitemstats-forge-<version>.jar
NeoForge 1.21.1 NeoForge 21.1.228+ adventureitemstats-neoforge-<version>.jar

Java 21 is required (it ships with the official 1.21.1 launcher).

Fabric users: Fabric API is a hard dependency. The game will refuse to launch without it. Forge and NeoForge have no extra mod dependency.

Where to download

The current build is v0.2.0, published as a pre-release / beta (all pre-1.0 versions are marked beta). See the Roadmap for what that means.

Steps

  1. Install your loader (Fabric / Forge / NeoForge) for Minecraft 1.21.1.
  2. (Fabric only) Download Fabric API and put it in mods/.
  3. Download the Adventure Item Stats jar for your loader.
  4. Drop the jar into your mods/ folder.
  5. Launch the game. There is no config to set up — it works immediately.

Server installs

Install the matching jar on both the server and every client. Rolled stats are written to the item stack on the server when loot generates, but clients need the mod to display the varied attribute tooltips consistently.

Verifying it works

  1. Start a new world (or any world) and find some loot — open a dungeon/village chest, or kill a mob that drops equipment.
  2. Hover a rolled sword, axe, or armor piece and read its attribute tooltip (the green/gray stat lines).
  3. Compare two of the same item from different loot rolls — their Attack Damage, Attack Speed, Armor, or Armor Toughness numbers should differ slightly.

A freshly crafted item of the same type is your control: it will always show the exact vanilla numbers. If the crafted one and a looted one read identically every time, something isn't loading — check that the jar matches your loader and that Fabric API is present (Fabric).

See the FAQ for troubleshooting and compatibility notes.

Clone this wiki locally