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

- PlaceholderAPI integration – Easily assign and manage group prefixes for players. - PlaceholderAPI integration – Define your own prefix, suffix, name color, and display formats for each group. - PlaceholderAPI integration – Use MiniMessage gradients and custom hex codes for prefix styles. - PlaceholderAPI integration – Control group order via `sortID` (lower number = higher priority). - PlaceholderAPI integration – Use PlaceholderAPI integration for advanced color, gradients, and style customization. - PlaceholderAPI integration – Minimal performance impact and easy to maintain. - PlaceholderAPI integration – 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. DON'T RELOAD 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>[Admin]</gradient>' suffix: '' namecolor: 'RED' sortID: 1 tabformat: '<prefix><player><suffix>' chatformat: '<prefix><player><suffix> <gray>»</gray> <message>'

moderator: prefix: '<aqua>[Mod]</aqua>' suffix: '' namecolor: 'AQUA' sortID: 2 tabformat: '<prefix><player><suffix>' chatformat: '<prefix><player><suffix> <gray>»</gray> <message>'

vip: prefix: '<gradient:#ffd700:#fff700>[VIP]</gradient>' suffix: '' namecolor: 'GRAY' sortID: 3 tabformat: '<prefix><player><suffix>' chatformat: '<prefix><player><suffix> <gray>»</gray> <message>'

customhex: prefix: '<#33ccff>[HexTag]</#33ccff>' suffix: '' namecolor: 'GRAY' sortID: 10 tabformat: '<prefix><player><suffix>' chatformat: '<prefix><player><suffix> <gray>»</gray> <message>'

default: prefix: '<white>[Player]</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

- sortID: 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.

---

License

LuckPrefix is licensed under the MIT License.