LPCF - Chat Formatter

<p align="center"> <img src="https://i.imgur.com/eqhavhz.png" alt="logo" width="700"/> </p>

<p align="center"> <img src="https://i.imgur.com/5QElRqJ.png" alt="Auction" width="400"/> </p>

<p align="center"> <a href="https://ko-fi.com/nightbeamstudio"> <img src="https://cdn.prod.website-files.com/5c14e387dab576fe667689cf/670f5a0171bfb928b21a7e00_support_me_on_kofi_beige.png" alt="logo" width="300"/> </a> </p>

<p align="center"> <a href="https://discord.gg/TJc3CxR4jK"> <img alt="Discord Server" src="https://img.shields.io/static/v1?label=&message=Discord&color=ECEBE6&labelColor=2F4858&style=for-the-badge&logo=discord&logoColor=white" /> </a> <a href="https://www.youtube.com/@nightbeamstudio"> <img alt="Nightbeam Studio YouTube" src="https://img.shields.io/static/v1?label=&message=YouTube&color=ECEBE6&labelColor=2F4858&style=for-the-badge&logo=youtube&logoColor=white" /> </a> <a href="https://github.com/MeherBenSalem"> <img alt="Nightbeam Studio GitHub" src="https://img.shields.io/static/v1?label=&message=GitHub&color=ECEBE6&labelColor=2F4858&style=for-the-badge&logo=github&logoColor=white" /> </a> <a href="https://www.curseforge.com/members/nightbeamstudio/projects"> <img alt="Nightbeam Studio CurseForge" src="https://img.shields.io/static/v1?label=&message=CurseForge&color=ECEBE6&labelColor=2F4858&style=for-the-badge&logo=curseforge&logoColor=white" /> </a> <a href="https://modrinth.com/organization/nightbeam"> <img alt="Nightbeam Studio Modrinth" src="https://img.shields.io/static/v1?label=&message=Modrinth&color=ECEBE6&labelColor=2F4858&style=for-the-badge&logo=modrinth&logoColor=white" /> </a> </p>

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.