Trims Effect by Goldwar

✨ TrimEffects

TrimEffects is a lightweight Paper plugin that grants potion effects to players based on the armor trim patterns they are wearing.
Each trim can give a different effect, scales with the number of armor pieces, and is fully configurable.

Designed to be lag-free, future-safe, and easy to customize.

---

⭐ Features

• 🔮 Potion effects based on armor trim patterns
• 📈 Smart effect scaling depending on how many armor pieces share the same trim
• 🧩 Multiple trims supported at the same time
• 💎 Fully configurable via config.yml
• 🚫 Ability to disable crafting of specific trim templates
• 🔄 Reload config without restarting (/trimeffectsreload)
• 🌟 Safe against invalid trims or effects
• 🚀 Optimized for large servers (500+ players)

---

⚙ Installation

1. ✅ Download the plugin jar
2. ✅ Place it in your server’s plugins/ folder
3. ✅ Start the server once to generate config.yml
4. ✅ Edit the config as you like
5. ✅ Run /trimeffects reload or restart the server

Requirements: Minecraft 1.20+ ,Paper / Purpur / Folia (Spigot not recommended)

---

🚀 Performance & Safety

• 🌟 Event-based (no repeating tasks, no ticking loops)
• 🌟 Checks only 4 armor items per update
• 🌟 No NMS, no packets
• 🌟 Safe config parsing (invalid trims/effects are ignored)
• 🌟 Reload-safe (effects reapply correctly)

This plugin is safe to run even on high-population servers.

---

💖 Support & Community

• ❤️Join my Discord server for updates, support, and suggestions
• ❤️Discord: https://discord.gg/qwXHuyJbvX
  

😎 Other Projects

• 😎SolutionPlus → https://modrinth.com/plugin/solutionplus
  
• 😎MailboxPlus → https://modrinth.com/plugin/mailboxplus
• 😎DamageIndicator -> https://modrinth.com/plugin/damageindicator

🎮My Minercraft server IP: in.shulker.in:25938

---

✅ plugin.yml

name: TrimsEffect
version: 1.0.0
main: me.goldwar.trimeffects.TrimsEffects
api-version: 1.20
author: GoldwarGlory
website: https://modrinth.com/plugin/trimseffect

commands:
  trimeffectsreload:
    permission: trimeffects.admin
permissions:
  trimeffects.admin:
    description: reload the plugin

🌟 config.yml

# ============================================================
# TrimEffects Configuration
# ============================================================
# Notes:
# - Trim names MUST be lowercase (registry keys)
# - Potion effects use Bukkit effect names
# - Use "null" to disable an effect for a trim
# - Unknown trims/effects are ignored safely
# ============================================================

# Trims that CANNOT be crafted (optional feature)
un-craftable-trims:
  - silence
  - vex

effect-scaling:
  one-piece-level: 1
  two-piece-level: 2
  three-piece-level: 2
  four-piece-level: 3

# ------------------------------------------------------------
# Trim → Effect mapping
# ------------------------------------------------------------
# Set value to "null" if the trim should do nothing
# ------------------------------------------------------------

trims-effect:

  # Paper/Folia/Purper 1.20+
  silence: STRENGTH
  dune: SPEED
  coast: WATER_BREATHING
  wild: JUMP
  ward: RESISTANCE
  eye: NIGHT_VISION
  vex: HASTE
  tide: DOLPHINS_GRACE
  snout: FIRE_RESISTANCE
  rib: ABSORPTION
  spire: REGENERATION
  wayfinder: SATURATION
  raiser: STRENGTH
  shaper: HASTE
  host: HEALTH_BOOST
  flow: SPEED
  bolt: FAST_DIGGING

  # Disabled / cosmetic-only trims (allowed)
  sentry: null