LuckPrefix

# 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 (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: '<gradient:#ff4444:#ff7700></gradient>' suffix: '' namecolor: 'RED' sortID: 1 tabformat: '<prefix><player><suffix>' chatformat: '<prefix><player><suffix> <gray>»</gray> <message>' moderator: prefix: '<aqua></aqua>' suffix: '' namecolor: 'AQUA' sortID: 2 tabformat: '<prefix><player><suffix>' chatformat: '<prefix><player><suffix> <gray>»</gray> <message>' vip: prefix: '<gradient:#ffd700:#fff700></gradient>' suffix: '' namecolor: 'GRAY' sortID: 3 tabformat: '<prefix><player><suffix>' chatformat: '<prefix><player><suffix> <gray>»</gray> <message>' customhex: prefix: '<#33ccff></#33ccff>' suffix: '' namecolor: 'GRAY' sortID: 10 tabformat: '<prefix><player><suffix>' chatformat: '<prefix><player><suffix> <gray>»</gray> <message>' default: prefix: '<white></white>' suffix: '' namecolor: 'WHITE' sortID: 100 tabformat: '<prefix><player><suffix>' chatformat: '<prefix><player><suffix> <gray>»</gray> <message>' ``` #### Placeholders - `<prefix>`: Replaced with the group prefix. - `<suffix>`: Replaced with the group suffix. - `<player>`: The player's name. - `<message>`: 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 (https://github.com/ezTxmMC/LuckPrefix). --- ## License LuckPrefix is licensed under the MIT License.