Chat Customization

DISABLE CHAT FORMATTING IN LUCKPERMS AND USE JAVA 25

Customize your chat with prefixes, suffixes, colors, nicknames, pronouns, and more!

Documentation

Chat Editor

Features

Visual Editor - Full GUI for customizing your chat appearance with live preview
Preset System - Admin-defined presets (Style, Prefix, Pronoun, Message) with automatic application based on permissions and priority
Gradients Tab - Dedicated tab for gradient and rainbow configuration per element
Custom prefixes and suffixes with colors
Nicknames and pronouns display
Name and message color customization
Text styles: bold, italic, underline
Gradient text effects for all elements (prefix, name, pronouns, suffix, message)
Rainbow text effects for all elements
@mentions with sound notifications
Permission-Based - Fine-grained control over features and presets

Visual Editor

Open the visual editor with /chateditor to customize your chat without memorizing commands:

Editor Tab - Set prefix, suffix, nickname, pronouns with color pickers and style toggles
Gradients Tab - Configure gradient start/end colors and rainbow effects for each element
Commands Tab - Quick reference for all available commands
Live preview of your chat appearance
Color pickers for each element
Style toggles (bold, italic, underline)
Press X to reset gradients/rainbow for any element

Commands

Basic Customization

Command	Description	Example
`/prefix <text>`	Set your chat prefix	`/prefix VIP`
`/prefix "spaced text"`	Set prefix with spaces	`/prefix "VIP Member"`
`/suffix <text>`	Set your chat suffix	`/suffix MVP`
`/suffix "spaced text"`	Set suffix with spaces	`/suffix "2024 Edition"`
`/nickname <name>`	Set your display name	`/nickname CoolSteve`
`/nickname "spaced name"`	Set nickname with spaces	`/nickname "Cool Steve"`
`/pronouns <text>`	Set your pronouns	`/pronouns she/her`

Colors

Command	Description	Example
`/namecolor <color>`	Set your name color	`/namecolor GOLD`
`/msgcolor <color>`	Set your message color	`/msgcolor #FF69B4`
`/prefixcolor <color>`	Set your prefix color	`/prefixcolor RED`
`/suffixcolor <color>`	Set your suffix color	`/suffixcolor AQUA`
`/pronounscolor <color>`	Set your pronouns color	`/pronounscolor PINK`
`/colors`	Show all available colors	`/colors`

Clearing Settings

Use /hyssential clear <target> to clear any setting:

Command	Description
`/hyssential clear nickname`	Reset to username
`/hyssential clear prefix`	Remove your prefix
`/hyssential clear suffix`	Remove your suffix
`/hyssential clear pronouns`	Remove your pronouns
`/hyssential clear namecolor`	Reset name color
`/hyssential clear msgcolor`	Reset message color
`/hyssential clear prefixcolor`	Reset prefix color
`/hyssential clear suffixcolor`	Reset suffix color
`/hyssential clear pronounscolor`	Reset pronouns color
`/hyssential clear colors`	Reset all colors
`/hyssential clear style`	Clear all text styles
`/hyssential clear rainbow`	Clear all rainbow effects
`/hyssential clear gradient`	Clear all gradients
`/hyssential clear all`	Reset entire chat profile

Text Styles

Command	Description	Example
`/style <target> bold`	Toggle bold on element	`/style name bold`
`/style <target> italic`	Toggle italic on element	`/style prefix italic`
`/style <target> underline`	Toggle underline on element	`/style message underline`

Valid targets: prefix, name, pronouns, suffix, message

Advanced Effects

Command	Description	Example
`/gradient <target> <start> <end>`	Gradient effect on any element	`/gradient name RED GOLD`
`/gradient <target> clear`	Remove gradient from element	`/gradient prefix clear`
`/rainbow <target>`	Toggle rainbow on element	`/rainbow name`
`/rainbow <target> on`	Enable rainbow on element	`/rainbow suffix on`
`/rainbow <target> off`	Disable rainbow on element	`/rainbow message off`

Valid targets: prefix, name, pronouns, suffix, message

Profile Management

Command	Description	Example
`/chateditor`	Open the visual chat editor	`/chateditor`
`/chatprofile`	View your current chat profile	`/chatprofile`
`/resetformat`	Reset all customizations	`/resetformat`

Preset Commands

Command	Description	Permission
`/preset`	Open the preset selector GUI	-
`/chatcustom preset`	Open preset management UI (admin)	`chatcustom.admin.presets`
`/chatcustom reload`	Reload configuration and presets	`chatcustom.admin.reload`

Alias: /cc for /chatcustom

Presets are automatically applied based on player permissions and priority when chatting. Higher priority presets take precedence.

Admin Commands

Command	Description	Example
`/chatadmin view <player>`	View a player's profile	`/chatadmin view Steve`
`/chatadmin reset <player>`	Reset a player's profile	`/chatadmin reset Steve`
`/chatadmin setprefix <player> [value]`	Set/clear player prefix	`/chatadmin setprefix Steve Admin`
`/chatadmin setsuffix <player> [value]`	Set/clear player suffix	`/chatadmin setsuffix Steve Pro`
`/chatadmin setnickname <player> [value]`	Set/clear player nickname	`/chatadmin setnickname Steve Steven`
`/chatadmin setpronouns <player> [value]`	Set/clear player pronouns	`/chatadmin setpronouns Steve he/him`
`/chatadmin setnamecolor <player> [value]`	Set/clear player name color	`/chatadmin setnamecolor Steve RED`
`/chatadmin setmsgcolor <player> [value]`	Set/clear player message color	`/chatadmin setmsgcolor Steve AQUA`
`/chatadmin setprefixcolor <player> <color>`	Set player prefix color	`/chatadmin setprefixcolor Steve GOLD`
`/chatadmin setsuffixcolor <player> <color>`	Set player suffix color	`/chatadmin setsuffixcolor Steve BLUE`
`/chatadmin setpronounscolor <player> <color>`	Set player pronouns color	`/chatadmin setpronounscolor Steve PINK`
`/chatadmin clearnamecolor <player>`	Clear player name color	`/chatadmin clearnamecolor Steve`
`/chatadmin clearmsgcolor <player>`	Clear player message color	`/chatadmin clearmsgcolor Steve`
`/chatadmin clearprefixcolor <player>`	Clear player prefix color	`/chatadmin clearprefixcolor Steve`
`/chatadmin clearsuffixcolor <player>`	Clear player suffix color	`/chatadmin clearsuffixcolor Steve`
`/chatadmin clearpronounscolor <player>`	Clear player pronouns color	`/chatadmin clearpronounscolor Steve`
`/chatadmin setstyle <player> <target> <style>`	Set text style on element	`/chatadmin setstyle Steve name bold`
`/chatadmin setrainbow <player> <target> [on/off]`	Set rainbow on element	`/chatadmin setrainbow Steve prefix on`
`/chatadmin setgradient <player> <target> <start> <end>`	Set gradient on element	`/chatadmin setgradient Steve name RED BLUE`
`/chatadmin clearstyle <player> [target]`	Clear styles (all or specific)	`/chatadmin clearstyle Steve name`
`/chatadmin clearrainbow <player> [target]`	Clear rainbow (all or specific)	`/chatadmin clearrainbow Steve`
`/chatadmin cleargradient <player> [target]`	Clear gradient (all or specific)	`/chatadmin cleargradient Steve prefix`

Available Colors

Named Colors

RED — #FF5555
DARK_RED — #AA0000
GOLD — #FFAA00
YELLOW — #FFFF55
GREEN — #55FF55
DARK_GREEN — #00AA00
AQUA — #55FFFF
DARK_AQUA — #00AAAA
BLUE — #5555FF
DARK_BLUE — #0000AA
LIGHT_PURPLE — #FF55FF
DARK_PURPLE — #AA00AA
WHITE — #FFFFFF
GRAY — #AAAAAA
DARK_GRAY — #555555
BLACK — #000000
PINK — #FF69B4
ORANGE — #FFA500
LIME — #00FF00
CYAN — #00FFFF

Custom Hex Colors

You can also use any hex color in the format #RRGGBB:

#FF0000 — Pure Red
#00FF00 — Pure Green
#0000FF — Pure Blue
#FF69B4 — Hot Pink
#FFD700 — Gold
#8A2BE2 — Blue Violet

Configuration

Config file: config.json

{
  "DefaultNameColor": "WHITE",
  "DefaultMessageColor": "WHITE",
  "MaxPrefixLength": 16,
  "MaxSuffixLength": 16,
  "MaxNicknameLength": 24,
  "MaxPronounsLength": 16,
  "AllowBold": true,
  "AllowItalic": true,
  "AllowUnderline": true,
  "AllowGradients": true,
  "AllowRainbow": true,
  "EnableMentions": true,
  "MentionColor": "YELLOW",
  "MentionSound": true
}

Option	Description	Default
DefaultNameColor	Default color for player names	WHITE
DefaultMessageColor	Default color for messages	WHITE
MaxPrefixLength	Maximum prefix length	16
MaxSuffixLength	Maximum suffix length	16
MaxNicknameLength	Maximum nickname length	24
MaxPronounsLength	Maximum pronouns length	16
AllowBold	Allow bold text style	true
AllowItalic	Allow italic text style	true
AllowUnderline	Allow underline text style	true
AllowGradients	Allow gradient text effects	true
AllowRainbow	Allow rainbow text effects	true
EnableMentions	Enable @mention system	true
MentionColor	Color for highlighted mentions	YELLOW
MentionSound	Play sound when mentioned	true

Permissions

Configure permissions in config.json:

Permission	Description	Default
chatcustomization.prefix	Use /prefix command	chatcustomization.prefix
chatcustomization.suffix	Use /suffix command	chatcustomization.suffix
chatcustomization.nickname	Use /nickname command	chatcustomization.nickname
chatcustomization.pronouns	Use /pronouns command	chatcustomization.pronouns
chatcustomization.color	Use color commands	chatcustomization.color
chatcustomization.style	Use style commands	chatcustomization.style
chatcustomization.gradient	Use gradient effects	chatcustomization.gradient
chatcustomization.rainbow	Use rainbow effects	chatcustomization.rainbow
chatcustomization.admin	Use admin commands	chatcustomization.admin

Set RequirePermissionForPrefix, RequirePermissionForSuffix, etc. to true to enforce permissions.

Data Storage

Player profiles are stored in JSON format in the plugin data folder:

profiles.json - All player chat profiles

Chat Format Example

[VIP] Steve (he/him) [MVP]: Hello everyone!

Where:

[VIP] - Prefix
Steve - Nickname (or username)
(he/him) - Pronouns
[MVP] - Suffix
Hello everyone! - Message

Support on Discord

If you'd like to support me and the development of my mods, I recommend trying out BisectHosting. Use code "project8gbderam" to get 25% off your first month of a gaming server for new customers. They offer 24/7 support and lightning-fast response times, ensuring you're in great hands and providing exceptional assistance for all your gaming needs. https://www.bisecthosting.com/project8gbderam

Bisect