Описание
# 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](https://modrinth.com/mod/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](https://modrinth.com/mod/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