✨ 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

✅ Download the plugin jar
✅ Place it in your server’s plugins/ folder
✅ Start the server once to generate config.yml
✅ Edit the config as you like
✅ 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

Trims Effect by Goldwar

📖About Trims Effect by Goldwar