Chat Customization

Chat Customization

DISABLE CHAT FORMATTING IN LUCKPERMS AND USE JAVA 25

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