Home

Adventure Item Stats

Every found sword feels a little different.

Adventure Item Stats adds Gaussian variation to the base stats of items rolled by Minecraft's loot tables. Two "Iron Swords" pulled from two different dungeon chests no longer feel identical — each rolls a slightly different attack damage, attack speed, armor value, or toughness. Most rolls land near vanilla; a rare few roll noticeably above or below.

It's the sister mod to Adventure Item Names, made for Dungeon Train.

Minecraft	1.21.1
Loaders	Fabric · Forge · NeoForge
Java	21
Latest	v0.2.0 (pre-release)
License	PolyForm Shield 1.0.0 (source-available)
Repo	bh679/adventureitemstats-mc

---

Quick links

• Installation — download the right jar and drop it in mods/.
• How It Works — the Gaussian model, the two-axis quality/tradeoff system, and exactly what gets varied.
• FAQ — does it touch crafted items? does it stack with Adventure Item Names? is there a config?
• Developer API — call StatsModifier.applyStats from your own loot system.
• Building from Source — Gradle, the four loader subprojects, dev clients, tests.
• Roadmap — what's shipped and what's next.
• Contributing — branch, PR, and release conventions.

---

What it does in one paragraph

Every time a vanilla loot table rolls a weapon or a piece of armor, the mod nudges its stats by a Gaussian random multiplier. The multiplier is applied to the effective value the player actually feels in combat (player base + item modifier), with a standard deviation of 20% and a hard clamp at ±50%. Weapons vary on two correlated axes — overall quality (better swords are both harder-hitting and faster) and a damage/speed tradeoff — and armor varies the same way across armor value and toughness. Items obtained any other way — crafted, spawned via /give, traded with villagers — stay perfectly vanilla. Because the mod hooks the same loot codepath as Adventure Item Names, a single rolled sword can carry both a generated name and rolled stats.

Heads up: Items only roll varied stats when they come out of a loot table. See How It Works for the full list of what is and isn't affected.