Skip to content

LuckPrefix

By ezTxmMCOwner

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

39k downloads Updated

No ratings yet

Be the first to rate it.

Rate it

Community listing page

Community listing page, reviews may not be monitored by the author.

About

Description

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.