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 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

Download LuckPrefix.
Place the LuckPrefix.jar file into your server’s plugins directory.
Restart your server, DON'T RELOAD.

Configuration

LuckPrefix uses a groups.yml file in its data folder for group definitions.

Example `groups.yml`

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

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.

License

LuckPrefix is licensed under the MIT License.

No gallery available for this project.

Version	Minecraft	Loader	Download
2.0.0-BETA+13	1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11	paper, purpur	Download
2.0.0-BETA+12 [Paper 1.21.4+] 2.0.0-BETA+12-paper	1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10	paper, purpur	Download
2.0.0-BETA+12 [Spigot 1.21.4+] 2.0.0-BETA+12-spigot	1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10	bukkit, spigot	Download
2.0.0-BETA+12 [1.20.5-1.21.3] 2.0.0-BETA+12	1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3	bukkit, paper, purpur, spigot	Download
2.0.0-BETA+11 [Paper 1.21.4+] 2.0.0-BETA+11-paper	1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8	paper, purpur	Download
2.0.0-BETA+11 [Spigot 1.21.4+] 2.0.0-BETA+11-spigot	1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8	spigot	Download
2.0.0-BETA+11 [1.20.5-1.21.3] 2.0.0-BETA+11	1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3	bukkit, paper, purpur, spigot	Download
2.0.0-BETA+10 [Paper 1.21.4+] 2.0.0-BETA+10-paper	1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8	paper, purpur	Download
2.0.0-BETA+10 [Spigot 1.21.4+] 2.0.0-BETA+10-spigot	1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8	bukkit, spigot	Download
2.0.0-BETA+10 [1.20.5 - 1.21.3] 2.0.0-BETA+10	1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3	bukkit, paper, purpur, spigot	Download
2.0.0-BETA+9 [Paper 1.21.4+] 2.0.0-BETA+9-paper	1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8	paper, purpur	Download
2.0.0-BETA+9 [Spigot 1.21.4+] 2.0.0-BETA+9-spigot	1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8	bukkit, spigot	Download
2.0.0-BETA+9 [1.20.5-1.21.3] 2.0.0-BETA+9	1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3	bukkit, paper, purpur, spigot	Download
2.0.0-BETA+8 [Paper 1.21.4+] 2.0.0-BETA+8-paper	1.21.4, 1.21.5, 1.21.6	paper, purpur	Download
2.0.0-BETA+8 [Spigot 1.21.4+] 2.0.0-BETA+8-spigot	1.21.4, 1.21.5, 1.21.6	bukkit, spigot	Download
2.0.0-BETA+8 [1.20.5-1.21.3] 2.0.0-BETA+8	1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3	bukkit, paper, purpur, spigot	Download
2.0.0-BETA+7	1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3	bukkit, paper, purpur, spigot	Download
2.0.0-BETA+6	1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3	bukkit, paper, purpur, spigot	Download
2.0.0-SNAPSHOT+5	1.20.5, 1.20.6	bukkit, paper, purpur, spigot	Download
2.0.0-SNAPSHOT+4	1.20.5, 1.20.6	bukkit, paper, purpur, spigot	Download
2.0.0-SNAPSHOT+3	1.20.5, 1.20.6	bukkit, paper, purpur, spigot	Download
2.0.0-SNAPSHOT+2	1.20.5, 1.20.6	bukkit, paper, purpur, spigot	Download
2.0.0-SNAPSHOT+1	1.20.5, 1.20.6	bukkit, paper, purpur, spigot	Download
1.2.3 (Modern) 1.2.3	1.16, 1.16.1, 1.16.2, 1.16.3, 1.16.4, 1.16.5, 1.17, 1.17.1, 1.18, 1.18.1, 1.18.2, 1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6	bukkit, paper, purpur, spigot	Download
1.2.1 (Legacy) legacy-1.2.1	1.8, 1.8.1, 1.8.2, 1.8.3, 1.8.4, 1.8.5, 1.8.6, 1.8.7, 1.8.8, 1.8.9, 1.9, 1.9.1, 1.9.2, 1.9.3, 1.9.4, 1.10, 1.10.1, 1.10.2, 1.11, 1.11.1, 1.11.2, 1.12, 1.12.1, 1.12.2, 1.13, 1.13.1, 1.13.2, 1.14, 1.14.1, 1.14.2, 1.14.3, 1.14.4, 1.15, 1.15.1, 1.15.2	bukkit, paper, purpur, spigot	Download