CustomTrims Plugin

An easy-to-use armor trim customization plugin for modern Paper/Spigot servers. Players get clean GUIs to pick patterns and materials, while admins control defaults, storage, and safety rules.

Features

• GUI-driven trim selection for diamond and netherite armor
• Pattern and material selector menus with pagination
• Per-player trim profiles with persistence (YAML or MySQL/MariaDB)
• Auto-apply trims on equip and on a configurable timer
• Optional Curse of Vanishing applied with trims
• Toggle trims on/off per player, with instant strip on disable
• Default trims configurable per armor piece (flow + amethyst by default)
• Clean tooltips (hidden attributes/components) and customizable background filler
• Configurable sounds for GUI actions
• Commands with tab-complete: /armortrims (GUI), /customtrimsplugin reload|version

Quick Use

• Grant permission customtrims.use to let players open /trims or /armortrims.
• Use /customtrimsplugin reload to apply config changes, /customtrimsplugin version to check the build.

Configuration Highlights

• general.apply_on_equip and general.auto_apply_seconds control auto application
• general.trim_vanishing toggles adding Curse of Vanishing with trims
• general.strip_on_disable toggles stripping when trims are turned off
• default_trims sets per-piece defaults for diamond and netherite
• storage block selects YAML (none) or MySQL/MariaDB
• gui_background_item changes the filler item for all menus
• sounds block customizes GUI click sounds
• permissions block lets you rename permission nodes

Storage Options

• YAML (default): simple file-based storage
• MySQL/MariaDB: set storage.type to mysql or mariadb and fill in host, port, database, user, password

Commands

• /armortrims (alias /trims): open the main trim menu
• /armortrims disable or /armortrims apply: quick toggle/apply
• /armortrims <Diamond_Helmet|Diamond_Chestplate|Diamond_Leggings|Diamond_Boots|Netherite_Helmet|Netherite_Chestplate|Netherite_Leggings|Netherite_Boots>: jump to a specific armor editor
• /customtrimsplugin reload: reload configuration and storage
• /customtrimsplugin version: show plugin version and author

Permissions

• customtrims.use – open GUI and auto-trim handling
• customtrims.reload – reload config/storage and check version