HyArmorVariants

[0.0.1] - Initial release

Added

• Randomized armour variants — Each armour piece (helmet, chestplate, leggings, boots) can roll 0–3 random stat variants on first acquisition. Variants are stored in item metadata (BSON) and persist through trading, storage, and server restarts.
• Armour-appropriate stat pool — Effect Duration, Mana, Signature Energy, Stamina, Thorns, Life Steal, Movement Speed, Durability. No weapon-only stats (e.g. damage, crit) on armour.
• Variant application — Variants are applied on inventory change, pickup, container open, or via poller. Configurable globs and heuristics for armour detection.
• 5-star variant rating — When DynamicTooltipsLib is present, tooltips show a star rating and overall percent (e.g. 0–150%). Damage multiplier excluded from armour rating.
• Armour-on-attacker effects (thorns-style) — When you are hit by a player, mob, or NPC, your armour’s variant stats (e.g. Thorns) can apply an effect to the attacker. Configurable rules, base chance, duration, and per-defender cooldown.
• Defender armour special attacks — Armour can roll special effects (Blazing Ring, Frost Nova, Poison Cloud, Thunder Strike, Thorns Aura). When you are hit, your equipped armour’s special can proc onto the attacker with configurable chance and cooldown.
• Optional armour set bonuses — Configurable set definitions (e.g. wearing 2+ pieces from the same set) for extra stat bonuses.
• Configuration — JSON5 config at mods/HyArmourVariants/config/HyArmourVariants.json5: variant count, stat pool, distribution, armour-on-attacker rules, defender armour special toggles, cooldowns, tooltip options, and more.
• Commands — /hav (alias: /hyarmorvariants, /hyarmourvariants): help, version, reload, menu, dump, apply, reroll.
• Permissions — hyarmorvariants.command.help, .reload, .menu, .dump, .apply, .reroll, .edit. Op required for privileged commands when no permission plugin is present.
• Localization — Language files in mods/HyArmourVariants/Languages/ (en, de, cs, uk, fr, es, pl, ru, pt, it). Configurable via language in config.
• Compatibility — Romnas Quality Crafting (quality item ID resolution), Salvager/Processing Bench (variant data preserved), DynamicTooltipsLib (optional tooltips). Works alongside HyWeaponVariants for weapons.

Technical

• Built for Hytale server-side modding API; Java 25+, Gradle 9.x, Kotlin DSL.
• Variants stored by stat id for update resilience. Armour stats aggregated additively across equipped pieces.