PerfGradients
Apply custom MiniMessage name gradients in chat, the tab list, above the player model, and display-name contexts — with a paginated GUI shop, unlock vouchers, and personal gradient creation.
Paper and Folia 1.21 - 26.x
Support
Report bugs and get support here: https://discord.gg/VvM6k2eBDa
Features
• Folia support – Runs on Folia and standard Paper 1.21.x
• Gradient name display – Active gradient on chat, tab, floating nametag, and display name (each toggle in config)
• Name priority – Force gradients everywhere or defer when another plugin already styled the name
• Gradient GUI shop – Browse, preview, purchase, and equip gradients with pagination and categories
• Shop economy – Vault, PlayerPoints, or ExcellentEconomy (configurable)
• Gradient catalog – Define presets in gradients.yml with MiniMessage templates, categories, icons, costs, and permissions
• Player gradients – Gradient Creator item plus /gradients create for owner-only custom gradients saved to custom-gradients.yml
• Unlock vouchers – Admin-givable items that permanently unlock a gradient on right-click
• Purchases & persistence – Unlocks, active gradient, and item tokens stored in SQLite or MySQL
• Permission gradients – Per-gradient access via perfgradients.gradient.(id) nodes
• Profanity filter – Optional blocked words and regex for custom gradient names
• Security actions – Configurable console command on duplicate voucher or creator abuse
• PerfChat integration – {player} in PerfChat formats picks up the active gradient automatically
• PerfTags tab integration – {name} in PerfTags tab-list format when tab-list is enabled
• PlaceholderAPI – Use gradient names in TAB, scoreboards, and third-party chat plugins
• Switch cooldown – Optional delay between gradient changes
• Configurable GUI – Full MiniMessage layout in gui/gradients-gui.yml
Placeholders
%perfgradients_name_mm% – Active gradient name (MiniMessage)
%perfgradients_gradient_mm% – Same as name_mm (MiniMessage)
%perfgradients_name_plain% – Gradient name without color codes
%perfgradients_gradient_plain% – Same as name_plain
%perfgradients_gradient_id% – Active gradient ID
Commands
/gradients – Open the gradient menu (perfgradients.use)
/gradients set (id) – Equip a gradient by ID (perfgradients.set)
/gradients clear – Remove your active gradient (perfgradients.clear)
/gradients create (hex) (hex) (name) – Create a personal gradient with Gradient Creator in main hand (perfgradients.createitem.use)
/gradient – Alias for /gradients (perfgradients.use)
/perfgradients reload – Reload configs and gradient cache (perfgradients.admin.reload)
/perfgradients givecreator (player) [amount] – Give Gradient Creator items (perfgradients.admin.givecreator)
/perfgradients voucher give (player) (gradientId) [amount] – Give gradient unlock vouchers (perfgradients.admin.voucher)
Database
• SQLite (default)
• MySQL (configurable)
