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.