
# LPC – LuckPerms Chat Formatter ✨
**A flexible chat formatting plugin with MiniMessage support for LuckPerms**
> Modern chat formatting powered by [MiniMessage](https://docs.advntr.dev/minimessage/format.html), full LuckPerms metadata support, group/track formats, and PlaceholderAPI!
---
## 🔧 Requirements
- [LuckPerms](https://www.spigotmc.org/resources/luckperms.28140/) *(Required)* – 权限插件
- [PlaceholderAPI](https://www.spigotmc.org/resources/placeholderapi.6245/) *(Optional)* – 额外的占位符
---
## ✅ Features
- Full [MiniMessage](https://docs.advntr.dev/minimessage/format.html) 格式化支持
- Group and track-specific chat formats
- Optional support for PlaceholderAPI
- Supports `[ITEM]` placeholder in chat
- Customizable reload message
- No legacy color codes – modern MiniMessage only
---
## 🧑💼 Permissions
| Command / Feature | Permission Node | Description |
|--------------------------|------------------------|--------------|
| `/lpc reload` | `lpc.reload` | 重新加载配置 |
| MiniMessage colors | `lpc.colorcodes` | 允许使用MiniMessage颜色代码 |
| `[ITEM]` Placeholder | `lpc.itemplaceholder` | 启用聊天中的`[ITEM]`占位符 |
---
## ⚙️ Configuration (`config.yml`)
```yaml
# LPC Configuration
# Main chat format (MiniMessage!)
chat-format: "{prefix}{name} » {message}"
# Format per group (optional)
group-formats:
# default: "[User] {name} » {message}"
# admin: "[Admin] {name} » {message}"
# Format per track (optional)
track-formats:
# staff_track: "[Staff] {name} » {message}"
# donator_track: "[Donator] {name} » {message}"
# Enable the [ITEM] placeholder
use-item-placeholder: true
# Reload message
reload-message: "LPC configuration reloaded successfully!"
```
---
## 🪄 Available Placeholders
| Placeholder | Description |
|-------------------------|-------------|
| `{message}` | The chat message |
| `{name}` | Player's name |
| `{displayname}` | Display name / nickname |
| `{world}` | Player's current world |
| `{prefix}` | Highest priority prefix |
| `{suffix}` | Highest priority suffix |
| `{prefixes}` | Sorted list of all prefixes |
| `{suffixes}` | Sorted list of all suffixes |
| `{username-color}` | Username color from meta |
| `{message-color}` | Message color from meta |
> ℹ️ **Important:** All color values (prefix, suffix, etc.) must be in **MiniMessage format** – no legacy codes (`&a`, `§b`, etc.)
---
## 📸 Previews
**Chat Format Example**

**[ITEM] Placeholder Example**

---
## 🚀 Installation
1. Stop your server
2. Place the `LPC.jar` into your `/plugins` folder
3. Start the server to generate configuration files
4. Edit the `config.yml` to your liking
5. Use `/lpc reload` to apply your changes ✅
---
## 📌 Notes
- **Not affiliated with LuckPerms** – Please do not contact the LuckPerms author for support!
- Legacy version available at: [GitHub Legacy LPC](https://github.com/wikmor/LPC)
## 🛟 Need Help?
Join our Discord for support, updates, or to report bugs: