Custom Trims

Adds the ability to add a custom armor trim GUI system, with options to edit multiple armor types and toggle on and off. A great way to monetize your server.

223

Quick challenge

How far can you run before the mobs catch you?

Custom Trims

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