Перейти к содержимому
Mineforgian

LuckPrefix

The luckperms addon for tab- and chat-prefixes on the market.

Загрузки
32K
Подписчики
55
Обновлён
13 марта 2026 г.
Лицензия
MIT

Опубликован 9 августа 2023 г.

Исходный кодСообщить об ошибке

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

  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

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.

Ченджлог

2.0.0-BETA+13Бета1.21.9, 1.21.10, 1.21.11 · 13 марта 2026 г.

LuckPrefix 2.0.0-BETA+13

What's changed?

Added

Removed

Changed

  • Updated Paper-API to 1.21.4 – should break nothing by (@ezTxmMC)

Fixes

  • Fixed no config issue by (@ezTxmMC)
  • Possible fixed locator bar issues and network protocol errors by (@ezTxmMC)

Known issues:

  • Database is currently unavailable
  • When disabling tab-formatting, the player-group must be changed or the server must be restarted

2.0.0@9cbd2a7

It's a beta version, please report any issues at GitHub.

2.0.0-BETA+12-paperБета1.21.8, 1.21.9, 1.21.10 · 30 сентября 2025 г.

What's changed?

Known issues:

Database support is currently not implemented.

It's an beta version, please report any issues at GitHub or in our ticket system

2.0.0-BETA+12-spigotБета1.21.8, 1.21.9, 1.21.10 · 30 сентября 2025 г.

What's changed?

Known issues:

Database support is currently not implemented.

It's an beta version, please report any issues at GitHub or in our ticket system

2.0.0-BETA+12Бета1.21.1, 1.21.2, 1.21.3 · 30 сентября 2025 г.

What's changed?

Known issues:

Database support is currently not implemented.

It's an beta version, please report any issues at GitHub or in our ticket system

2.0.0-BETA+11-paperБета1.21.6, 1.21.7, 1.21.8 · 24 сентября 2025 г.

What's changed?

Added

  • New charts at bStats by @ezTxmMC
    • Used groups
    • Auto reload
    • Console logging
    • Print warnings
    • Debug logging flag
    • Show nametags
  • Always-on debug log file:' A dedicated file in the Datafolder for troubleshooting by @SyntaxJason

Changed

  • Auto-reload reworked: More reliable, reloads after file save, no unintended autosaves by @SyntaxJason
  • Command rename: /luckprefix reloadconfigs renamed in /luckprefix reload by @SyntaxJason
  • Greedy setters: Commands now accept symbols by @SyntaxJason
  • Rewrote config system by @SyntaxJason

Fixes

  • Fixed lost prefixes/suffixes after reload by fully rebuilding teams by @SyntaxJason
  • Fixed truncation with group names containing : or multiple spaces by @SyntaxJason
  • Fixed config "reset" on reload by reading from disk only by @SyntaxJason

Known issues:

  • Database support is currently not implemented.

2.0.0@bbdff4d

It's an beta version, please report any issues at GitHub or in our ticket system

2.0.0-BETA+11-spigotБета1.21.6, 1.21.7, 1.21.8 · 24 сентября 2025 г.

What's changed?

Added

  • New charts at bStats by @ezTxmMC
    • Used groups
    • Auto reload
    • Console logging
    • Print warnings
    • Debug logging flag
    • Show nametags
  • Always-on debug log file:' A dedicated file in the Datafolder for troubleshooting by @SyntaxJason

Changed

  • Auto-reload reworked: More reliable, reloads after file save, no unintended autosaves by @SyntaxJason
  • Command rename: /luckprefix reloadconfigs renamed in /luckprefix reload by @SyntaxJason
  • Greedy setters: Commands now accept symbols by @SyntaxJason
  • Rewrote config system by @SyntaxJason

Fixes

  • Fixed lost prefixes/suffixes after reload by fully rebuilding teams by @SyntaxJason
  • Fixed truncation with group names containing : or multiple spaces by @SyntaxJason
  • Fixed config "reset" on reload by reading from disk only by @SyntaxJason

Known issues:

  • Database support is currently not implemented.

2.0.0@bbdff4d

It's an beta version, please report any issues at GitHub or in our ticket system

2.0.0-BETA+11Бета1.21.1, 1.21.2, 1.21.3 · 24 сентября 2025 г.

What's changed?

Added

  • New charts at bStats by @ezTxmMC
    • Used groups
    • Auto reload
    • Console logging
    • Print warnings
    • Debug logging flag
    • Show nametags
  • Always-on debug log file:' A dedicated file in the Datafolder for troubleshooting by @SyntaxJason

Changed

  • Auto-reload reworked: More reliable, reloads after file save, no unintended autosaves by @SyntaxJason
  • Command rename: /luckprefix reloadconfigs renamed in /luckprefix reload by @SyntaxJason
  • Greedy setters: Commands now accept symbols by @SyntaxJason
  • Rewrote config system by @SyntaxJason

Fixes

  • Fixed lost prefixes/suffixes after reload by fully rebuilding teams by @SyntaxJason
  • Fixed truncation with group names containing : or multiple spaces by @SyntaxJason
  • Fixed config "reset" on reload by reading from disk only by @SyntaxJason

Known issues:

  • Database support is currently not implemented.

2.0.0@bbdff4d

It's an beta version, please report any issues at GitHub or in our ticket system

2.0.0-BETA+10-paperБета1.21.6, 1.21.7, 1.21.8 · 16 сентября 2025 г.

What's changed?

Added

  • PlaceholderAPI integration by @ezTxmMC
    • Placeholders:
      • %luckprefix_prefix%
      • %luckprefix_suffix%
      • %luckprefix_chatformat%
      • %luckprefix_tabformat%
      • %luckprefix_sortid%
      • %luckprefix_namecolor%
  • Leaf support by @SyntaxJason
  • bStats integration by @ezTxmMC & @SyntaxJason

Removed

  • Complete database system has been removed, and we are targeting beta 11 for a rewrite.

Fixes

Known issues:

  • Database support is currently not implemented.

2.0.0@6b720d5

It's an beta version, please report any issues at GitHub.

Комментарии

Загружаем…