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

🔧 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

🧑‍💼 Permissions

ℹ️ 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

ℹ️ 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 ✅