Savaru Affixes v2.0.2 — Update Notes

The Potential patch. Every affixed item now has an inborn quality grade that shapes how strong its rolls can get and how far it can be enhanced. Plus a new cross-mod hookup with Growthology.

✨ New: Potential System

Every eligible weapon, armor piece, and accessory now rolls a hidden Potential rank the moment its affixes are first generated (drops, identification, and legacy items on first load).

A new tooltip line displays the rank in its grade color:

Potential: A (Enhancement cap: 15)

Rank Table

How it interacts

• Roll range — non-binary affix values are now multiplied by a random factor inside the rank's range, so a B-rank item never reaches the numbers an S-rank can.
• Enhancement cap — the effective cap becomes min(config cap, potential cap). Low-potential gear hits its ceiling faster; SSS items can be enhanced without limit.
• Binary affixes (1/1 flag-type traits) and special-cap affixes (Fire Resist, Adaptive Damage/Durability) ignore Potential entirely — they still roll exactly as before for items without a Potential, and stay capped consistently when one is present.
• SSS rolls perfect every time — the rarest grade, but the payoff is a guaranteed max-value roll on every affix.

🔗 New: Growthology Compat

Players with Savaru Growthology (SG) installed now benefit from its High-Quality Drop talent line through Affixes.

• When a mob drops a weapon, the responsible player's GrowthologyApi.getAffixHighQualityWeightMultiplier() is queried via reflection.
• If their multiplier exceeds 1.0×, there's a corresponding chance the drop's rarity is bumped up one tier: Common → Uncommon → Rare → Epic → Legendary → Mythic → Beyond → Unrivaled
• Strange and Unrivaled items are never promoted (top tier / special tier protected).
• Falls back gracefully when Growthology is absent — no hard dependency.

🛠 Internal Changes

• New classes: PotentialRank, PotentialHelper, GrowthologyCompat.
• AffixHelper: roll pipeline now threads a PotentialRank through rollValueByRarity; back-fills missing potential on load for legacy saves.
• EnhancementHelper: cap calculation respects potential; auto-rolls potential on first enhancement if absent.
• UnidentifiedHandler: identifying an item assigns its potential.
• WeaponDropHooks: integrates Growthology rarity promotion before marking the pending roll.
• TooltipHooks: renders the new potential line.
• Language: en_us / zh_tw updated with two new keys (tooltip.savaru_affixes.potential.line, tooltip.savaru_affixes.potential.unlimited).

📦 Compatibility

• Save-safe. Existing worlds and items are upgraded in place — affixed gear without a potential tag is assigned one on its next load.
• Standalone-safe. All Growthology integration is reflective; the mod runs unchanged without it.
• Minecraft 1.21.1, Fabric.