LuckPerms GUI & NameTags
Manage LuckPerms roles with an in-game GUI — and show animated prefixes over the head, in the Tab and in chat.
Forge • Minecraft 1.20.1 • Requires LuckPerms 5.4+ • Server (client optional for animations)
LuckPerms GUI & NameTags gives LuckPerms a visual, in-game admin interface and finally shows the player's role over the head, in the Tab list and in chat — with smooth animations (rainbow, moving gradient, pulse, glow). Create and edit groups, design prefixes/suffixes with a color palette and live preview, and assign players to roles — all without typing a single command.
Roles over the head, in the Tab & in chat
Key Features
- In-game admin GUI — manage LuckPerms visually: create / edit / delete groups, set prefix, suffix, weight and name color, and assign players. No commands needed.
- Roles everywhere — the role shows in chat, the Tab list and over the player's head.
- Animations — rainbow, moving gradient, pulse and glow wave, on the head and Tab.
- Live color editor + palette — a guided builder (text + animation + colors) with a clickable color palette and a real-time animated preview, or edit the raw tags directly.
- Member management — set, add or remove a group for any player, online or offline (by name).
- Works on vanilla clients — the server writes the role into vanilla scoreboard teams, so vanilla clients see it (static). Install the mod on the client to see the animations.
- Tab sorted by rank — the Tab list is ordered by the group's weight.
- Live sync — changing a role in LuckPerms updates the nametag instantly, no relog.
- Multilingual — English & Spanish, following the client's language.
- Safe — the GUI is OP-gated and every action is re-validated server-side.
The Admin GUI
Open the editor with /luckpermsgui gui (or /lpgui), a configurable key, or the ⚙ Roles button in the inventory and the Esc menu (OP only). Pick a group on the left and edit its prefix and suffix in two compact blocks: type the text, choose an animation, pick colors from the palette and toggle bold — the preview animates live as you type. Advanced users can edit the raw tag string directly.
Members
In the Members tab, click an online player (or type any username, even offline) and choose a group: Set as role (primary group), Add group or Remove group. Changes are written straight to LuckPerms.
Animations & Colors
Prefixes and suffixes support legacy codes, hex colors, gradients and animated tags. Animated effects move on clients that have the mod; vanilla clients see a static snapshot.
| Effect |
Tag / code |
Animated |
| Legacy / hex color |
&c &#ff8800 <#ff8800> |
— |
| Gradient (static) |
<gradient:#ff0000:#00ff00>...</gradient> |
— |
| Rainbow |
<rainbow>...</rainbow> |
yes |
| Moving gradient |
<flow:#00ffff:#ff00ff>...</flow> |
yes |
| Pulse |
<pulse:#2ecc71:#16a085>...</pulse> |
yes |
| Glow wave |
<wave:#f1c40f>...</wave> |
yes |
Join & leave messages
Join and leave messages also show the player's role with its colors.
How it works
- Server — reads LuckPerms meta and writes it to vanilla scoreboard teams (head + Tab, ordered by weight) and formats chat. This is what vanilla clients see.
- Client (with the mod) — redraws the head and Tab every frame so the animations move smoothly — no packet spam, no mixins.
- Chat shows full colors/gradients but does not animate (sent lines are static).
Requirements
- Minecraft 1.20.1
- Minecraft Forge 47+
- LuckPerms (Forge) 5.4+ — required on the server.
- Optional: install this mod on the client to see the animations (vanilla clients see static roles). The client does not need LuckPerms.
Note: if you run another chat-formatting mod, set chat.chatEnabled = false in the config to avoid double chat.
Dependency
LuckPerms (Forge) is required — install it on the server:
🔗 LuckPerms on CurseForge
