TrimResonance

TrimResonance turns Minecraft's armor trim system from a cosmetic
feature into a progression system. Every trim material and pattern you
craft and wear grants unique, stackable abilities find the right
combinations and you'll feel it.

Built on the idea from BetterTrims
by Bawnorton. TrimResonance takes that concept and adds its own
dual-system on top, with unique material and pattern combinations.

---

⚙️ How It Works

Two independent systems run at the same time:

System	What It Does	Activation
Material Effects	Core passive ability from the trim material	1 piece minimum
Pattern Effects	Secondary ability from the trim pattern	2 pieces minimum

Both systems run at the same time. A full Gold set with Sentry pattern
gives you the Solar Bonus and the armor buff together.

---

Material Abilities (System 1)

Applies to every piece worn with that material, regardless of pattern.
Scales with number of pieces (1–4).

Gold — Solar Bonus (Overworld daytime only)

• +1 Attack Damage per piece
• +7% Movement Speed per piece
• +1 Armor per piece
• +0.5 Attack Speed per piece
• Piglins treat you as friendly

Redstone — Swift Current

• +12% Movement Speed per piece (up to +48% total)

Netherite — Nether Ward

• Permanent Fire Resistance
• +2 Armor and +1 Toughness per piece
• 7.5% chance per piece to completely negate incoming damage (capped at 30%)

Iron — Mining Mastery

• Mining Efficiency bonus scales with pieces worn
• Haste II at a full set of 4 pieces

Diamond — Resilience

• -5% incoming damage per piece (max -20% reduced damage)

Copper — Conductor

• Projectiles you fire summon lightning bolts on hit
• Requires thundering weather and sky visibility to activate

Amethyst — Resonant Shield

• Chance per piece to negate incoming damage completely
• Chance per piece to amplify outgoing damage
• Outgoing damage multiplier scales with number of pieces

Emerald — Merchant's Favor

• -6.25% villager trade discount per piece (capped at 25%)

Quartz — Scholar

• +25% XP gain per piece (up to +100% from all sources)

Lapis — XP Magnet

• Requires full set (4 pieces)
• Pulls XP orbs within 8 blocks toward you

Resin — Ambush

• While sneaking, melee attacks deal +6.25% damage per piece
• Scales up to +25% at 4 pieces

---

Pattern Abilities (System 2)

Requires at least 2 matching pattern pieces. Scales up at 3 and 4 pieces.

Pattern	Name	Effect
Bolt	Conduit Power	Conduit Power in rain or water (II at 4 pieces)
Coast	Dolphin's Grace	Dolphin's Grace while submerged; scales from amplifier I at 2 pieces to amplifier III at 4 pieces
Dune	Desert Endurance	Fire Resistance in hot biomes at 2+ pieces; Slow Falling at 4 pieces; Husks & Strays ignore you at 4
Eye	Vigilance	Night Vision in low light; Hero of the Village at 4 pieces (daytime, sky access); Evokers & Pillagers ignore you at 4
Flow	Evasion	+5% Movement Speed per piece; Step Height increase at 3+ pieces
Host	Phantom Ward	Slow Falling while sneaking; Phantoms ignore you at 4 pieces
Raiser	Strength	+1 Attack Damage per piece
Rib	Fortitude	+2 Max Health per piece; +0.5 Knockback Resistance at 4 pieces
Sentry	Guardian	+2 Armor per piece
Shaper	Mining Mastery	Haste + Mining Efficiency bonus; Haste II at 4 pieces
Silence	Stealth	Invisibility while sneaking; Speed at 4 pieces while sneaking
Snout	Nether Affinity	Fire Resistance in the Nether; Strength at 4 pieces; Hoglins & Piglin Brutes ignore you at 4
Spire	Ascension	Slow Falling; Jump Boost at 3 pieces; Jump Boost II at 4 pieces
Tide	Aqua Affinity	Water Breathing always; Haste while submerged at 4 pieces
Vex	Phasing	Speed; Resistance at 4 pieces; Vexes ignore you at 4 pieces
Wayfinder	Explorer	Luck; Luck II at 4 pieces; Saturation at 4 pieces
Ward	Protection	Resistance; Absorption at 4 pieces
Wild	Nature's Blessing	Regeneration while hurt; Regeneration II at 4 pieces

---

Tooltips

Hover over any trimmed armor piece to see its active effects.
Hold [SHIFT] for detailed descriptions of each effect.

---

⚙️ Configuration

A config file is generated automatically at .minecraft/config/trimresonance.json.

• Every material and pattern can be toggled independently
• Numeric values can be rebalanced without code changes
• Cloth Config support included for in-game editing

Server owners: every value and threshold is documented inside the config.

---

Credits

BetterTrims
by Bawnorton — the original idea of giving armor trims gameplay functionality.

---

🔧 Roadmap & Future Updates

TrimResonance is actively maintained. Planned for upcoming updates:

• Balance passes on material and pattern effects based on community feedback
• New trim material abilities as Minecraft adds more materials
• Multiplayer compatibility improvements
• More pattern combinations and effects
• Visual and UI improvements