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