LPC Minimessage - Chat Formatter

Minecraft 版本： 1.20 1.20.1 1.20.2 1.20.3 1.20.4 1.20.5 1.20.6 1.21 1.21.1 1.21.2 1.21.3 1.21.4 1.21.5 1.21.6 1.21.7 1.21.8 1.21.9 1.21.10 1.21.11 26.1 26.1.1 26.1.2

平台： bukkit folia paper purpur spigot

标签： decoration social

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 ✅