Sueta
PL

PlaceholderNametags

1.3.0

Display custom prefixes & suffixes above player heads using PlaceholderAPI and LuckPerms!

·Plugin

PlaceholderNametag
Lightweight, flexible, and powerful nametag plugin for modern servers.

✨ Features
✅ Customizable prefixes and suffixes for each player or group
✅ Supports PlaceholderAPI placeholders
✅ Integrates with LuckPerms for group detection
✅ Uses scoreboard teams to show nametags above player heads, not in chat
✅ /nt reload command for quick config reloads
✅ Efficient and optimized for performance

Example

An example using a placeholder from another of my plugins, Pronouns

Requirements

  • PlaceholderAPI ✅

  • LuckPerms ✅ (for group-based tags)

  • Minecraft 1.13 – 1.20+ (latest Paper/Spigot builds recommended)

⚙️ Configuration
users:
Steve:
prefix: '&b[VIP]'
suffix: '&7☆'
Alex:
prefix: '&a[Mod]'
suffix: '&6⚔'

groups:
default:
prefix: '&7[Player]'
suffix: ''
admin:
prefix: '&c[Admin]'
suffix: '&4★'

Commands

Command
Description Permission
/nt reload Reload the config + tags nt.reload (default: OP)
Placeholders
Supports any PlaceholderAPI placeholders like:

  • %luckperms_prefix%

  • %vault_prefix%

  • %player_name%

  • ...and all your custom expansions!

‍ Developer Notes

  • Nametags are applied using Scoreboard teams (limit: 16-char team names).

  • Plugin does not modify chat or tab-list, use a chat formatter such as LPC for that.

  • On join, players are automatically placed into their appropriate team.

❓ FAQ
Q: Will this conflict with other scoreboard-based plugins?
A: Possibly. Avoid using multiple plugins that modify player scoreboards unless you control how they interact.

Q: Does this work in versions before 1.13?
A: It may compile, but is only tested and supported on 1.13+.

✅ To-Do / Future Plans

  • Per-world nametag support

  • RGB hex color support (1.16+)

  • Placeholder formatting in team names

❤️ Support & Feedback
Have a bug, suggestion, or question?
Contact me on Spigot

Installation

  1. Download the plugin .jar and drop it into /plugins/

  2. Install PlaceholderAPI

  3. (Optional) Install LuckPerms for group-based prefixes

  4. Start your server

  5. Edit the config and run /nt reload

Similar projects

Plugin →