LPC – LuckPerms Chat Formatter ✨

A flexible chat formatting plugin with MiniMessage support for LuckPerms

Modern chat formatting powered by MiniMessage, full LuckPerms metadata support, group/track formats, and PlaceholderAPI.

🧩 Compatibility

| | |
|---|---|
| Minecraft | 26.1.2 |
| Server | Paper (recommended) or Spigot |
| Java | 25+ |

🔧 Requirements

• LuckPerms (Required) – Permissions plugin
• PlaceholderAPI (Optional) – Additional placeholders

✅ Features

Formatting

• Full MiniMessage support, with group- and track-specific formats
• Optional PlaceholderAPI integration and [item] placeholder (hover tooltip on Paper)
• Per-rank message styling and per-rank gradient names ({gradient-name})
• Per-world toggle via disabled-worlds

Social (on by default)

• @Mention pings – highlight online names + sound/action-bar ping (Paper)
• Emoji shortcuts – e.g. :heart: → ❤ (fully configurable)
• Clickable links – URLs become openUrl links on Paper, coloured on Spigot

Moderation (off by default)

• Anti-spam cooldown, repeated-message blocker, caps filter, profanity mask, anti-advertising
• Per-player mute (/lpc mute) + LuckPerms mute node for punishment plugins

Server messages (off by default)

• MiniMessage join / quit / first-join / death messages

Quality of life

• /lpc reload · version · help · mute · unmute with tab completion
• Built-in Modrinth update checker
• Safe by design – player messages can never inject click/hover/command components
• Works on both Paper (Adventure rendering) and Spigot (legacy fallback)

⌨️ Commands

| Command | Permission | Description |
|---------|------------|-------------|
| /lpc reload | lpc.reload | Reload the configuration |
| /lpc version | – | Show the installed version |
| /lpc help | – | List available commands |
| /lpc mute <player> [duration] | lpc.mute | Mute a player (e.g. 10m, 2h; omit for permanent) |
| /lpc unmute <player> | lpc.mute | Unmute a player |

🧑‍💼 Permissions

| Permission | Default | Description |
|------------|---------|-------------|
| lpc.reload | op | Reload the configuration |
| lpc.chatcolor | false | Use colour codes & cosmetic MiniMessage tags in chat |
| lpc.itemplaceholder | false | Use the [item] placeholder in chat |
| lpc.update | op | Receive an update notification on join |
| lpc.emoji | true | Use emoji shortcuts (only enforced if emoji.require-permission) |
| lpc.chatlinks | true | Have URLs turned into clickable links |
| lpc.mention.exempt | false | Opt out of receiving mention pings |
| lpc.mute | op | Use /lpc mute and /lpc unmute |
| lpc.muted | false | Marks a player as muted (usually set by a punishment plugin) |
| lpc.bypass.spam / .repeat / .caps / .profanity / .advert | op | Bypass the matching moderation filter |

ℹ️ Even with lpc.chatcolor, only cosmetic tags (colours, decorations, and optionally gradients/rainbow) are honoured in player messages. Interactive tags (click, hover, insertion, …) are always stripped.

⚙️ Configuration (config.yml)

# Main chat format (MiniMessage!)
chat-format: "{prefix}{name}<dark_gray> »<reset> {message}"

# Per-group formats (optional)
group-formats:
#  default: "<gray>[User]</gray> {name}<dark_gray> »<reset> {message}"
#  admin: "<red>[Admin]</red> {name}<dark_gray> »<reset> {message}"

# Per-track formats (optional) – groups take priority over tracks
track-formats:
#  staff_track: "<gold>[Staff]</gold> {name}<dark_gray> »<reset> {message}"

# Enable the [item] placeholder
use-item-placeholder: true

# Allow <gradient> / <rainbow> for players with lpc.chatcolor
allow-gradient-tags: true

# Worlds where LPC does NOT format chat
disabled-worlds: []

# Check Modrinth for updates on startup
update-checker: true

# Reload message
reload-message: "<green>Reloaded LPC configuration!"

🪄 Available Placeholders

| Placeholder | Description |
|-------------|-------------|
| {message} | The chat message (inserted safely, never re-parsed) |
| {name} | Player's name |
| {displayname} | Display name / nickname |
| {world} | Player's current world |
| {prefix} / {suffix} | Highest priority prefix / suffix |
| {prefixes} / {suffixes} | All prefixes / suffixes, highest priority first |
| {username-color} / {message-color} | Colour values from LuckPerms meta |

ℹ️ All colour values (prefix, suffix, etc.) must be in MiniMessage format – no legacy codes (&a, §b).

🚀 Installation

1. Stop your server
2. Drop LPC-<version>.jar into your /plugins folder
3. Start the server to generate config.yml
4. Edit the config to your liking
5. Run /lpc reload to apply changes ✅

🛠️ Building

./gradlew shadowJar
# output: build/libs/LPC-<version>.jar

Requires JDK 25.

📌 Notes

• Not affiliated with LuckPerms – please do not contact the LuckPerms author for support.
• Legacy version available at: GitHub Legacy LPC

📸 Previews

Chat Format Example

[ITEM] Placeholder Example

🚀 Installation

1. Stop your server
2. Place the LPC.jar into your /plugins folder
3. Start the server to generate configuration files
4. Edit the config.yml to your liking
5. Use /lpc reload to apply your changes ✅