BK-Gradients

Advanced Visual Identity & Cosmetics System for Paper 1.21+ servers.

BK-Gradients lets players build a fully custom visual identity — in chat, tab list, scoreboard, and beyond — through four independent modules driven entirely by YAML. No recompilation. Every menu, sound, and behavior editable live.

Modules at a glance

Prefix

Custom text before the player name, rendered as a two-color HEX gradient with text styles.

Nick

Gradient color applied to the player’s display name — the real username never changes.

Suffix

Custom text after the player name, same options as Prefix.

Key features

Feature	Details
100% YAML GUIs	Menus, items, lore, actions, layouts — fully editable without recompiling
MiniMessage	HEX colors, gradients, bold, italic, hover/click events everywhere
Per-player history	Every cosmetic is saved; players can restore previous looks
PlaceholderAPI	Legacy `%..%` and MiniMessage `<bkgradients:...>` placeholders
SQLite & MySQL	Single-server or multi-server shared database
Cooldown & validation	Length limits, character blacklist, cooldown per module
Permission-locked tags	Specific tags require a permission node — perfect for rank perks
Live reload	`/bkg reload` applies all changes instantly — no restart needed