Thunder-Relay/MC/ThunderNickname
0 forks
id: 25986
1,185 Lines
- Java 83.2%
- Yaml 6.8%
- Markdown 5.3%
- XML 4.7%
README.md
ThunderNickname
Prefix and suffix management for player display names on Paper 26.2+.
API / platform (honest)
| Item | Value |
|---|---|
| API used | Paper API (io.papermc.paper:paper-api) |
| Minecraft / Paper | 26.2 and newer (api-version: 26.2, dependency [26.2.build,)) |
| Java | 25 |
| Adventure | MiniMessage colors in prefixes/suffixes, Player#displayName(Component) |
Paper includes the Bukkit API, but the compile dependency and features used are Paper, not “Bukkit-only”.
Requirements
- Paper 26.2 or newer (also fine on 26.3+)
- Java 25
- IntelliJ IDEA (or any Maven IDE)
Building (IntelliJ)
File → Openthethundernicknamefolder (the one withpom.xml)- Set Project SDK to JDK 25
- Maven tool window → package (or
mvn clean package) - Jar:
target/ThunderNickname-1.0.0.jar - Put it in the server
plugins/folder and restart
Commands (ops only by default)
| Command | Description |
|---|---|
/prefix <player> <text> | Set prefix (MiniMessage allowed) |
/prefix <player> clear | Remove prefix |
/suffix <player> <text> | Set suffix |
/suffix <player> clear | Remove suffix |
/nickname <player> | Show current prefix + suffix |
/nickname <player> clear | Clear both |
/tnhelp | Help |
Permission: thundernickname.admin (default: op)
Examples
/prefix Steve <red>[Admin]</red>
/suffix Steve <gold>the Legend</gold>
Display becomes something like: [Admin] Steve the Legend (exact layout from config.yml → format).
Data
plugins/ThunderNickname/config.yml— format, messages, max lengthplugins/ThunderNickname/nicknames.yml— stored prefixes/suffixes by UUID
Notes
- Display name is applied on join and when an admin changes prefix/suffix.
- Chat plugins may still format chat their own way; this plugin sets Paper display name and player list name.
- Only staff with the permission can change names — not regular players.