Random Attributes: Awakening

NeoForge mod for Minecraft 1.21.1 that turns equipment into living gear. Armor, tools and weapons roll a small set of random attributes when crafted, then grow through use — no crafting stations, no catalysts, no gambling.

How it works

• Slots come from the material: sturdier tiers and tougher armor hold more attributes. Every item starts with one or two attributes and awakens the rest by being used.
• Deeds — each item silently tracks how it is used: fighting, shooting, mining or taking hits. The dominant deed is shown in the tooltip and biases everything below.
• Awakening — on level-up the item awakens a new attribute, drawn from a pool weighted by its deeds. The same recipe becomes a battle blade or a miner's companion depending on play.
• Redemption — a rare negative roll heals toward zero as the item levels and eventually flips positive.
• Attunement — at maximum level the item becomes attuned: a permanent bonus to all of its attributes and an enchantment glow.
• Reforging — in the detail screen, click an attribute to reforge that slot into a different deed-biased one. Costs experience levels; every reforge raises the price up to a configurable cap.

Attributes are strictly separated by equipment class: weapons (swords, maces, tridents), ranged weapons, tools, multitools (axes), shields and armor each draw from their own pool, so mining stats never roll on a sword and combat stats never roll on a pickaxe.

Controls

Both keys are rebindable under Options → Controls → Random Attributes.

• Show item attributes (default Left Shift) — hold to expand the attribute list in the tooltip.
• Open attribute details (default V) — open the detail screen for the hovered or held item: a spinning model, the attribute list, descriptions on hover and click-to-reforge.

Configuration

config/Ocle_42/RandomAttributesAwakening/main.toml

• Crafted roll chance and the grant-on-acquire toggle for loot and traded gear.
• Item XP rate, maximum item level.
• Reforge pricing: base cost, per-reforge step and the hard cap.
• Blacklist and extra weapon/armor/axe/tool lists for modded items, plus the randomattributes:rollable/* and randomattributes:blacklist item tags.

Building

Requires Java 21.

./gradlew build

The jar is written to build/libs.

License

All Rights Reserved. See LICENSE.