LuckPermsPrefixes
A Minecraft plugin for LuckPerms that formats chat messages and the TAB list with prefixes, colors, and animated gradients. [ Support for 26.1 soon! ]
Quick challenge
How far can you run before the mobs catch you?
Minecraft check
Confirm your run
Complete the quick check to get your code.
LuckPermsPrefixes
``` ██╗ ██████╗ ██████╗██╗ ██╗██╗██████╗ ██████╗ ███████╗███████╗██╗██╗ ██╗███████╗███████╗ ██║ ██╔═══██╗██╔════╝██║ ██╔╝██║██╔══██╗██╔══██╗██╔════╝██╔════╝██║╚██╗██╔╝██╔════╝██╔════╝ ██║ ██║ ██║██║ █████╔╝ ██║██████╔╝██████╔╝█████╗ █████╗ ██║ ╚███╔╝ █████╗ ███████╗ ██║ ██║ ██║██║ ██╔═██╗ ██║██╔═══╝ ██╔══██╗██╔══╝ ██╔══╝ ██║ ██╔██╗ ██╔══╝ ╚════██║ ███████╗╚██████╔╝╚██████╗██║ ██╗██║██║ ██║ ██║███████╗██║ ██║██╔╝ ██╗███████╗███████║ ╚══════╝ ╚═════╝ ╚═════╝╚═╝ ╚═╝╚═╝╚═╝ ╚═╝ ╚═╝╚══════╝╚═╝ ╚═╝╚═╝ ╚═╝╚══════╝╚══════╝
```
Rank-based chat & tablist formatting for Paper servers. Set up everything in-game no YAML editing required.
---
What it does
- In-game Required: create ranks, pick a style, done - Chat format and tablist name Required: from a single template - Required: when you create a rank - Works with the Required: plugin out of the box - Hot-reload no server restart needed- Supports Required: > Required: Set `enforce-secure-profile=false` in `server.properties` for chat formatting to work.
---
Setup
1. Requirements
| | Min. Version | |---|---| | Java | 8 (1.8–1.16) / 16 (1.17–1.19) / 21 (1.20+) | | Paper / Spigot | 1.8 | | LuckPerms | latest | | PlaceholderAPI | latest *(only needed for TAB integration)* |
2. Pick the right JAR
| JAR | Minecraft version | |---|---| | `lockiprefixes-legacy-x.x.x.jar` | 1.8 – 1.12 | | `lockiprefixes-mid-x.x.x.jar` | 1.13 – 1.18 | | `lockiprefixes-modern-x.x.x.jar` | 1.19 – 1.19.4 | | `lockiprefixes-latest-x.x.x.jar` | 1.20 – 1.21 |
Drop the matching JAR into `plugins/` and restart. A `config.yml` is generated automatically.
3. In-game
``` /lpx menu ```
---
Commands
| Command | What it does | |---|---| | `/lpx menu` | Open the rank manager | | `/lpx reload` | Reload config |
Permission: `lockiprefixes.menu` / `lockiprefixes.reload`
---
Config
`plugins/LockiPrefixes/config.yml` normally you don't touch this, the GUI writes it for you.
```yaml groups: owner: chat-format: "&4&lOwner &8| &f{name} &7{message}" tablist-format: "&4&lOwner &8| &f{name}" priority: 100 ```
---
TAB Plugin
LockiPrefixes auto-detects TAB and disables its own tablist module.
Edit `plugins/TAB/groups.yml`:
```yaml DEFAULT: tabprefix: "" tabsuffix: "" customtabname: "%lockiprefixes_tablist%" tagprefix: "%luckperms-prefix%" ```
Then run `/tab reload`.
---
Placeholders
| Placeholder | Returns | |---|---| | `%lockiprefixes_prefix%` | Rank prefix only (e.g. `&4&lOwner `) | | `%lockiprefixes_tablist%` | Prefix + separator + name use in TAB | | `%lockiprefixes_name%` | Prefix directly followed by player name |
---
Build from source
```bash git clone https://github.com/leifiyoo/lockiprefixes.git cd lockiprefixes
Build a specific version
./gradlew :legacy:shadowJar -x test # 1.8–1.12 ./gradlew :mid:shadowJar -x test # 1.13–1.18 ./gradlew :modern:shadowJar -x test # 1.19–1.19.4 ./gradlew :latest:shadowJar -x test # 1.20–1.21
Or build all at once
./gradlew shadowJar -x test ```
Output JARs land in `<module>/build/libs/`.
---