Trims Effect

💎Adds configurable potion effects based on worn armor trims🤩, with smart scaling per trim and zero performance impact🚀.

Загрузки: 527
Подписчики: 5
Обновлён: 22 июня 2026 г.
Лицензия: All-Rights-Reserved

Опубликован 27 января 2026 г.

Banner

✨ TrimEffects (By GoldwarGlory)

✨ TrimEffects is a lightweight Paper plugin.
✨ Highly configurable, lag-free, and future-safe.
✨ It gives potion effects based on worn armor trims.
✨ Effects scale with the number of trimmed armor pieces.
✨ Edit config.yml easily using in-game config editor. { /trimseffect edit }

⭐ Features of TrimsEffect

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

⚙ How to Install TrimsEffect

✅ 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

🚀 Performance & Safety for servers

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

💖 Need help? or report bugs

❤️Join my Discord server for updates, support, and suggestions
❤️My Modrinth Profile: https://modrinth.com/user/GoldwarGlory
❤️My Discord Server: https://discord.gg/qwXHuyJbvX

➕Extra info of TrimsEffect

✅ plugin.yml

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

commands:
  trimseffect:
    description: Main command
permissions:
  trimseffect.reload:
    default: op
    description: Reload the plugin's config
  trimseffect.gui:
    default: true
    description: Open the Trim Effects GUI
  trimseffect.edit:
    default: op

🌟 config.yml

# Basic Info:-
# Color codes use &: example "&6Gold", "&aGreen", "&cRed".
# Potion effect names use Bukkit names: SPEED, STRENGTH, RESISTANCE, etc.
# Effect levels are normal player-facing levels:
# 0 = disabled, 1 = level I, 2 = level II, 3 = level III

settings:
  prefix: "&6[TrimsEffect] &r" # plugin's prefix
  keep-effects-after-milk: true # If true, trim effects come back after a player drinks milk.
  check-for-updates: true # If true, admins with trimseffect.edit are notified when an update is available.
  disabled-worlds: [empty,emty,mty,mt] # Worlds where trim effects should not work.
  un-craftable-trims: [silence,sentry,"*"] # These armor trim templates cannot be crafted.

debug:
  missing-trims: true # should we send logs in console for missing trims in effects
  un-craftable-trims: true # should we send logs in console to get reminded which trims are un-craftable
  display-items: true # should we send logs in console for incorrect material names of display-items
  missing-display-items: true # should we send logs for missing trim-materials in config

gui: # Main /trimseffect gui menu.
  enabled: true # Toggle GUI
  title: "&aTrim Effects" # GUI Title
  size: 54 # Must be 27, 36, 45, or 54.
  show-missing-trims-in-gui: true # If true, GUI will also show the trims that are missing in config.

  display-items:
    default: NETHER_STAR # GUI item used when a trim has no item listed below.

    trims: # Items used by /trimseffect gui and the effects editor.
      silence: SILENCE_ARMOR_TRIM_SMITHING_TEMPLATE
      sentry: SENTRY_ARMOR_TRIM_SMITHING_TEMPLATE
      dune: DUNE_ARMOR_TRIM_SMITHING_TEMPLATE
      coast: COAST_ARMOR_TRIM_SMITHING_TEMPLATE
      wild: WILD_ARMOR_TRIM_SMITHING_TEMPLATE
      ward: WARD_ARMOR_TRIM_SMITHING_TEMPLATE
      eye: EYE_ARMOR_TRIM_SMITHING_TEMPLATE
      vex: VEX_ARMOR_TRIM_SMITHING_TEMPLATE
      tide: TIDE_ARMOR_TRIM_SMITHING_TEMPLATE
      snout: SNOUT_ARMOR_TRIM_SMITHING_TEMPLATE
      rib: RIB_ARMOR_TRIM_SMITHING_TEMPLATE
      spire: SPIRE_ARMOR_TRIM_SMITHING_TEMPLATE
      wayfinder: WAYFINDER_ARMOR_TRIM_SMITHING_TEMPLATE
      raiser: RAISER_ARMOR_TRIM_SMITHING_TEMPLATE
      shaper: SHAPER_ARMOR_TRIM_SMITHING_TEMPLATE
      host: HOST_ARMOR_TRIM_SMITHING_TEMPLATE
      flow: FLOW_ARMOR_TRIM_SMITHING_TEMPLATE
      bolt: BOLT_ARMOR_TRIM_SMITHING_TEMPLATE

effects:
  # Used when a trim does not define custom levels for a piece count.
  default-levels:
    1: 1
    2: 2
    3: 2
    4: 3

  # Trim names must be lowercase.
  # effects: potion effects this trim can give.
  # levels: optional per-piece override for that trim.
  # If levels is missing, default-levels above are used.
  trims:
    silence:
      effects:
        - STRENGTH
        - RESISTANCE
        - ABSORPTION
      levels:
        1:
          STRENGTH: 2
          RESISTANCE: 1
          ABSORPTION: 0
        2:
          STRENGTH: 3
          RESISTANCE: 2
          ABSORPTION: 1

    dune:
      effects:
        - SPEED

    coast:
      effects:
        - WATER_BREATHING

    wild:
      effects:
        - JUMP

    ward:
      effects:
        - RESISTANCE

    eye:
      effects:
        - NIGHT_VISION

    vex:
      effects:
        - HASTE

    tide:
      effects:
        - DOLPHINS_GRACE

    snout:
      effects:
        - FIRE_RESISTANCE

    rib:
      effects:
        - ABSORPTION

    spire:
      effects:
        - REGENERATION

    wayfinder:
      effects:
        - SATURATION

    raiser:
      effects:
        - STRENGTH

    shaper:
      effects:
        - HASTE

    host:
      effects:
        - HEALTH_BOOST

    flow:
      effects:
        - SPEED

    bolt:
      effects:
        - FAST_DIGGING

    # Empty effects means this trim appears in the GUI but gives no effects.
    sentry:
      effects: []

Ченджлог

1.0.13Релиз26.1.1, 26.1.2, 26.2 · 22 июня 2026 г.

🌟 New config settings:

debug:
  missing-trims: true # should we send logs in console for missing trims in effects
  un-craftable-trims: true # should we send logs in console to get reminded which trims are un-craftable
  display-items: true # should we send logs in console for incorrect material names of display-items
  missing-display-items: true # should we send logs for missing trim-materials in config
gui:
  show-missing-trims-in-gui: true # If true, GUI will also show the trims that are missing in config.

💛 Reimagined config.yml

💛 changed config setting's path
💛 cleaned and better config.yml

😍 Reimagined Config editor GUI

😍 Main GUI:

Main GUI

😍 Levels editor

Levels Editor

😍 Effects Editor

Effects editor

😍 Un-craftable Trims Editor

Uncraftable-Trims Editor

1.0.12Релиз26.1, 26.1.1, 26.1.2 · 8 июня 2026 г.

🚀 TrimsEffects Update Changelog

🛠️ Security Fix: Changed GUI title checks to InventoryHolder checks for better reliability.
📦 GUI Pagination: Added automatic page switching in TrimsEffect & Effects editor GUIs (Buttons auto-appear when the first page is full).
🔍 Missing Trims Detection: Both GUIs will now automatically display missing trims from your config.
⚙️ New Config Options: Added Prefix customization support.
📝 Developer Logs: Added advanced debug logs for easier troubleshooting.

Logs Example

Next Update Sneak Peek: Working on making the plugin 100% configurable with tons of new config settings! Stay tuned.

1.0.11Релиз26.1, 26.1.1, 26.1.2 · 17 апреля 2026 г.

Just bug fixes + Quality improved :)

1.0.10Релиз1.21.9, 1.21.10, 1.21.11 · 16 апреля 2026 г.

added:

In-game config editor
disabled-world setting
track-version setting

removed:

gui.show-scaling setting

1.0.9Релиз1.21.9, 1.21.10, 1.21.11 · 30 марта 2026 г.

New options to configure GUI:

# material of trim in /trimseffect gui
trim-materials:
  default: SENTRY_ARMOR_TRIM_SMITHING_TEMPLATE

  sentry: SENTRY_ARMOR_TRIM_SMITHING_TEMPLATE
  vex: VEX_ARMOR_TRIM_SMITHING_TEMPLATE
  wild: WILD_ARMOR_TRIM_SMITHING_TEMPLATE
  coast: COAST_ARMOR_TRIM_SMITHING_TEMPLATE
  dune: DUNE_ARMOR_TRIM_SMITHING_TEMPLATE
  ward: WARD_ARMOR_TRIM_SMITHING_TEMPLATE
  eye: EYE_ARMOR_TRIM_SMITHING_TEMPLATE
  spire: SPIRE_ARMOR_TRIM_SMITHING_TEMPLATE
  wayfinder: WAYFINDER_ARMOR_TRIM_SMITHING_TEMPLATE
  shaper: SHAPER_ARMOR_TRIM_SMITHING_TEMPLATE
  silence: SILENCE_ARMOR_TRIM_SMITHING_TEMPLATE
  snout: SNOUT_ARMOR_TRIM_SMITHING_TEMPLATE
  tide: TIDE_ARMOR_TRIM_SMITHING_TEMPLATE
  rib: RIB_ARMOR_TRIM_SMITHING_TEMPLATE

  # newer trims (1.20+ / 1.21+ depending on server version)
  raiser: RAISER_ARMOR_TRIM_SMITHING_TEMPLATE
  flow: FLOW_ARMOR_TRIM_SMITHING_TEMPLATE
  host: HOST_ARMOR_TRIM_SMITHING_TEMPLATE
  bolt: BOLT_ARMOR_TRIM_SMITHING_TEMPLATE

1.0.8Релиз1.21.9, 1.21.10, 1.21.11 · 27 марта 2026 г.

========🔥TrimsEffect-1.0.8 changelog ========

✅Fixed 2 bugs!
✅Enchanced GUI!
✅Enchanced Command rules!

-> 👀In next update: TrimsEffect Gui will be more configurable!
-> Join my discord to suggest ideas and report bugs about this plugin!

1.0.5Релиз1.21.9, 1.21.10, 1.21.11 · 7 марта 2026 г.

========TrimsEffect 1.0.5 — Changelog========

✨ Added:

Each trim can now optionally define its own effect levels depending on the number of armor pieces worn.
Allows different potion levels for 1, 2, 3, or 4 armor pieces.
Fully configurable inside trims-effect.<trim>.scaling.

🔧 Improvements

Cleaner internal trim effect system for better maintainability.
Improved compatibility with newer Paper/Purpur APIs.
More flexible configuration design for server owners.

🔄 Compatibility

⚠️ Config format changed in this update. If upgrading from older versions:

Delete the old config.yml
Restart the server to regenerate the new config.

New config.yml

# ------------------------------------------------------------
# Trims that CANNOT be crafted (optional feature)
# ------------------------------------------------------------

un-craftable-trims:
  - silence
  - vex


# ------------------------------------------------------------
# Default effect scaling (used if trim has no custom scaling)
# ------------------------------------------------------------

effect-scaling:
  1: 1
  2: 2
  3: 2
  4: 3


# ------------------------------------------------------------
# Trim → Effect mapping
# ------------------------------------------------------------
# effects = potion effects applied
# scaling = OPTIONAL per-trim scaling override
# ------------------------------------------------------------

trims-effect:

  silence:
    effects:
      - STRENGTH
      - RESISTANCE
      - ABSORPTION

    scaling:
      1:
        STRENGTH: 2
        RESISTANCE: 1
        ABSORPTION: 0
      2:
        STRENGTH: 3
        RESISTANCE: 2
        ABSORPTION: 1

  dune:
    effects:
      - SPEED

  coast:
    effects:
      - WATER_BREATHING

  wild:
    effects:
      - JUMP

  ward:
    effects:
      - RESISTANCE

  eye:
    effects:
      - NIGHT_VISION

  vex:
    effects:
      - HASTE

  tide:
    effects:
      - DOLPHINS_GRACE

  snout:
    effects:
      - FIRE_RESISTANCE

  rib:
    effects:
      - ABSORPTION

  spire:
    effects:
      - REGENERATION

  wayfinder:
    effects:
      - SATURATION

  raiser:
    effects:
      - STRENGTH

  shaper:
    effects:
      - HASTE

  host:
    effects:
      - HEALTH_BOOST

  flow:
    effects:
      - SPEED

  bolt:
    effects:
      - FAST_DIGGING

  sentry:
    effects: [] # empty = no effects

gui:
  enabled: true
  title: "&aTrim Effects"
  size: 27
  show-scaling: false

settings:
  milk-consume: true # if true, milk will not remove trim effects

1.0.4Релиз1.21.9, 1.21.10, 1.21.11 · 5 марта 2026 г.

============TrimEffects – v1.0.4============

✨ New Features

Multiple effects per trim are now supported.
You can assign two or more potion effects to a single armor trim in config.yml.
Updated configuration format to support effect lists:

🛠 Improvements

GUI now correctly displays all effects assigned to a trim.
Config loader updated to safely handle multiple effects per trim.
Improved internal effect application logic.

Old 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
gui:
  enabled: true
  title: "&aTrim Effects"
  size: 27
  show-scaling: false