ChatFormatter Pro icon

ChatFormatter Pro 1.0

Polished and Branded MC Server Chats

ChatFormatter Pro

Professional Chat Formatting For Modern Minecraft Servers

Transform your server chat into a clean, branded, professional experience. ChatFormatter Pro provides gradient text, badges, hover text, per-rank formats, per-world formats, PlaceholderAPI integration, and a priority-based formatting engine. Designed to be fast, reliable, and easy to maintain.

All features can be tested fully on a single-player server.

 


What ChatFormatter Pro Does

ChatFormatter Pro replaces the default Minecraft chat with a fully customizable system. You can:

• Define custom chat formats per rank, world, or permission
• Add gradients, badges, prefixes, suffixes, and hover text
• Integrate PlaceholderAPI placeholders anywhere
• Preview formats live before sending a message
• Solo test every formatting feature without needing other players

After reading this description, users should understand:

  1. What the plugin does

  2. How to set up chat formats

  3. How to test the plugin

  4. What commands and permissions exist

  5. What dependencies are needed

 


Key Features

Gradient Text

8_gradients.png

Create smooth multicolor gradients such as rainbow, fire, or fully custom palettes.
Use gradients in formats or directly in chat.

 

Badges

8_badges.png

Assign decorative icons or indicators next to player names.
Fully configurable, including symbol, color, and placement.

 

Hover Text

6_url_tooltip.png

Add interactive hover tooltips showing rank info, stats, or fully custom messages.

 

Custom Prefixes and Suffixes

Define unique prefix/suffix combinations per rank, world, or permission.

 

Per-Rank Formatting

2_cfp.png

Assign different chat styles to VIPs, moderators, admins, and owners.

 

Per-World Formatting

3_cfp.png

Create separate chat styles for survival, creative, nether, etc.

 

Priority System

If a player has multiple format permissions, the highest-priority format applies automatically.

 

PlaceholderAPI Integration

7_papi.png

Use any PlaceholderAPI placeholder inside formats or hover lines.

 

Low Maintenance

Designed to minimize support burden with intuitive formatting syntax and clean configuration.

QuickAdmin Pro Integration

Synchronize ranks seamlessly when both plugins are installed.

 


Requirements

• Minecraft 1.13+ (Spigot, Paper, and forks)
• Java 8+
• Optional: PlaceholderAPI and Vault (for rank detection)

 


Installation

  1. Place ChatFormatterPro.jar in your plugins/ folder

  2. Restart the server

  3. Edit plugins/ChatFormatterPro/config.yml

  4. Use /chatformatter reload to apply changes

  5. (Optional) Install PlaceholderAPI or Vault for extended functionality

 


Commands

/chatformatter help Help menu chatformatter.admin
/chatformatter reload Reload configuration chatformatter.reload
/chatformatter info Plugin info chatformatter.admin
/chatformatter formats List formats chatformatter.admin
/chatformatter gradients List gradients chatformatter.admin
/chatformatter badges List badges chatformatter.admin
/chatformatter test Test your format chatformatter.admin
/preview <message> Preview formatted message chatformatter.preview

Short aliases:
/cfp/chatformatter
/pv/preview


Permissions

chatformatter.admin All commands OP
chatformatter.reload Reload configuration OP
chatformatter.preview Preview chat Everyone
chatformatter.gradient Use gradient text False
chatformatter.badge Use badges False
chatformatter.hover Use hover text False
chatformatter.colors Use color codes False
chatformatter.format Use formatting codes False

Format-specific permissions:
• chatformatter.format.vip
• chatformatter.format.moderator
• chatformatter.format.admin
• chatformatter.format.owner

 


Configuration Examples

Basic Format

formats:
  vip:
    priority: 10
    prefix: "&6[VIP]"
    suffix: " &6✦"
    format: "{prefix} &6{displayname}{suffix}&r: {message}"
    hover:
        - "&6VIP Player"
        - "&7Name: &f{player}"
        - "&7World: &f{world}"
    permission: "chatformatter.format.vip"

 

Gradients

gradients:
    rainbow:
        colors: ["#FF0000", "#FF7F00", "#FFFF00", "#00FF00", "#0000FF", "#4B0082", "#9400D3"]
    fire:
        colors: ["#FF0000", "#FF7F00", "#FFFF00"]

 

Use in chat:
<gradient:rainbow>Hello World</gradient>

Badges

badges:
    star:
        text: "★"
        color: "&e"
    crown:
        text: "♕"
        color: "&6"
 

Use in format:
{badge:star} {displayname}

Per-World Formats

world-formats:
    world_nether: "default"
    creative_world: "creative_format"
 

Example Usage

VIP Format Setup

Add to config, then give permission:
/lp user <player> permission set chatformatter.format.vip

Gradient Chat

<gradient:fire>Amazing!</gradient>

Solo Testing

Enable:

solo-testing:
    enabled: true
    show-format-info: true

Then use /preview to test messages.

 


Localization

All messages are stored in messages_en.yml.
Fully editable without rebuilding the plugin.

 


QuickAdmin Pro Integration

Optional integration to sync ranks for consistent chat formatting and admin permissions.

quickadmin-integration:
    enabled: true
    sync-ranks: true
 

Building from Source

git clone https://github.com/anthonybone/chat-formatter-pro.git cd chat-formatter-pro mvn clean package
 

Support

https://discord.gg/nJkNdp5B

badges

chat

badge

color

format

gradients

hover

text

prefix

You might also like...