LPCF - Chat Formatter

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.