LPCPlus Documentation

Overview

LPCPlus is a chat formatting plugin for PaperMC and Spigot servers that integrates with LuckPerms. It allows you to:

• Customize chat formats per group
• Use prefixes, suffixes, and other metadata
• Support modern formatting features like MiniMessage, hex colors, and PlaceholderAPI placeholders
  

Installation

1. Download the latest LPCPlus .jar file.
2. 
   
3. Place the .jar in your server’s plugins folder.
4. 
   
5. Start your server to generate the default configuration file.
   
   
6. Ensure you have LuckPerms installed and optionally PlaceholderAPI for advanced placeholders.
   

Commands
/lpcplus reload
Reloads the plugin configuration without restarting the server.

Permission:

• lpcplus.reload – Allows the user to reload the plugin
  

Configuration
The configuration file (config.yml) allows you to customize the chat format.

Chat Format Placeholders

• {message} – The player’s chat message
• {name} – Player’s username
• {displayname} – Player’s display name or nickname
• {world} – Current world of the player
• {prefix} – Highest priority prefix from LuckPerms
• {suffix} – Highest priority suffix from LuckPerms
• {prefixes} – All prefixes sorted by priority
• {suffixes} – All suffixes sorted by priority
• {username-color} – Username color from LuckPerms metadata
• {message-color} – Message color from LuckPerms metadata

Example Configuration
chat-format: "{prefix}{name}&r: {message}"

group-formats:
default: "[Default] {name}&r: {message}"
admin: "[Admin] {name}&r: {message}"

Features

• Group-based chat formatting via LuckPerms
  
  
• MiniMessage support for advanced formatting
  
  
• Hex and legacy color codes
  
  
• PlaceholderAPI integration for custom placeholders
  
  
• Lightweight and optimized for Java 21 and modern server performance