Описание
# LuckPrefix
LuckPrefix is a modern, minimalistic Minecraft plugin for managing and displaying player prefixes and groups. Designed for clarity and flexibility, it allows you to set custom prefixes, suffixes, name colors, and display formats through a simple YAML configuration.
---
## Features
- **Group-based Prefixes** – Easily assign and manage group prefixes for players.
- **Customizable Formatting** – Define your own prefix, suffix, name color, and display formats for each group.
- **Gradient & Hex Support** – Use MiniMessage gradients and custom hex codes for prefix styles.
- **Sort Order System** – Control group order via `sortID` (lower number = higher priority).
- **MiniMessage Format** – Use [MiniMessage](https://docs.adventure.kyori.net/minimessage/format.html) for advanced color, gradients, and style customization.
- **Lightweight** – Minimal performance impact and easy to maintain.
- **Straightforward Configuration** – All group settings in one clear file.
- **PlaceholderAPI integration**
- Use placeholders from other plugins in groups.yml
- Our placeholders
- %luckprefix_prefix%
- %luckprefix_suffix%
- %luckprefix_tabformat%
- %luckprefix_chatformat%
- %luckprefix_sortid%
- %luckprefix_namecolor%
---
## Installation
1. Download LuckPrefix.
2. Place the `LuckPrefix.jar` file into your server’s `plugins` directory.
3. **Restart** your server, **DON'T RELOAD**.
---
## Configuration
LuckPrefix uses a `groups.yml` file in its data folder for group definitions.
### Example `groups.yml`
```yaml
groups:
admin:
prefix: '[Admin]'
suffix: ''
namecolor: 'RED'
sortID: 1
tabformat: ''
chatformat: ' » '
moderator:
prefix: '[Mod]'
suffix: ''
namecolor: 'AQUA'
sortID: 2
tabformat: ''
chatformat: ' » '
vip:
prefix: '[VIP]'
suffix: ''
namecolor: 'GRAY'
sortID: 3
tabformat: ''
chatformat: ' » '
customhex:
prefix: '[HexTag]'
suffix: ''
namecolor: 'GRAY'
sortID: 10
tabformat: ''
chatformat: ' » '
default:
prefix: '[Player]'
suffix: ''
namecolor: 'WHITE'
sortID: 100
tabformat: ''
chatformat: ' » '
```
#### Placeholders
- ``: Replaced with the group prefix.
- ``: Replaced with the group suffix.
- ``: The player's name.
- ``: The player's chat message (for `chatformat` only).
#### Other keys
- **namecolor:** color of the player's name (RED, GRAY, BLUE).
- **sortID:** Lower numbers mean higher priority. A group with `sortID: 1` is chosen over one with `sortID: 100` if a player is in both.
---
## Contributing
Contributions are welcome. Please open issues or pull requests on [GitHub](https://github.com/ezTxmMC/LuckPrefix).
---
## License
LuckPrefix is licensed under the MIT License.