Chat Customization

Chat Customization

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

Documentation

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