Folia-compatible chat formatting plugin for LuckPerms metadata, with modern MiniMessage rendering and classic Minecraft formatting support.
What This Plugin Does
- Formats player chat using a configurable global chat format.
- Supports LuckPerms metadata placeholders:
{prefix}{suffix}{prefixes}{suffixes}{username-color}{message-color}
- Supports additional placeholders:
{message}{name}{displayname}{world}
- Supports group-specific chat formats via
group-formats.
- Supports track-specific chat formats via
track-formats.
- Uses group format first, then track format, then default format fallback.
Formatting Support
- MiniMessage tags in formats and metadata values.
- Legacy Minecraft ampersand formatting:
- Color codes:
&0 to &9, &a to &f
- Style codes:
&k, &l, &m, &n, &o
- Reset:
&r
- RGB hex formats:
&#RRGGBB and &x&F&F&A&A&0&0
- Legacy section sign formatting (
§) is also recognized when present.
Chat Message Permissions
lpcf.colorcodes
- Allows players to use color/style formatting in their chat message text.
- Without this permission, formatting codes in message text are stripped.
lpcf.itemplaceholder
- Allows players to use
[ITEM] placeholder in chat messages.
lpcf.reload
- Allows reloading plugin configuration with
/lpcf reload.
[ITEM] Placeholder
- Optional
[ITEM] replacement in chat.
- Pulls the player's main-hand item.
- Uses custom item display name if available.
- Adds hover event with item details.
Platform and Integrations
- Built for Paper/Folia (
folia-supported: true).
- Integrates with LuckPerms (required dependency).
- Integrates with PlaceholderAPI (optional dependency).
- Uses Folia-safe scheduling for message rendering and delivery.
Command
/lpcf reload
- Reloads plugin configuration.
Typical Example
Input metadata/chat like:
- Prefix:
&lOWNER
- Player:
_NAIZO
- Separator:
»
- Message:
wow
Can render as expected in chat with bold styling from &l and all standard legacy formatting codes.
