Welcome to the Hangar Open Beta. Please report any issue you encounter on GitHub!
Highly customizable nametags above players for all client versions
Text description
ModernTags 2.0
A modern plugin for displaying custom tags above player heads
β¨ Features
| π¨ Full Customization | Configure tag appearance: color, shadows, transparency, alignment, size and more |
| π¬ Animated Tags | Support for multiple frames with configurable animation speed |
| π₯οΈ Dual Renderer | Text Display entities for 1.19.4+ clients, Scoreboard Teams for older ones β picked automatically per viewer |
| π Condition System | owner-conditions and viewer-conditions let you select the right tag group with arbitrary logic |
| π Priority System | Tag groups and entries are sorted by priority; the highest-priority match wins |
| ποΈ Viewer-Aware Placeholders | {owner:key} and {viewer:key} let you show different content depending on who is looking |
| π PlaceholderAPI | Any PAPI placeholder works out of the box |
| π Vault Integration | Automatic insertion of prefixes and suffixes from permission systems |
| π«₯ Sneak Dimming | Tags fade for crouching players on 1.19.4+ clients, matching vanilla behavior |
| π TAB Compatibility | ModernTags manages Scoreboard Teams internally β no need to disable TAB's nametag display |
β‘ Technical Advantages
The plugin is built on PacketEvents β all rendering is done through packets, not Bukkit APIs.
Component building via GikyMessage reduces allocations and speeds up placeholder replacement.
Fully supports Folia and all Paper forks (Paper, Purpur, etc.).
π§ Configuration Example
# config.yml
tags:
- priority: 0
entries:
- priority: 0
modern: tags/default.yml:<root>
legacy: tags/default-legacy.yml:<root>
- priority: 1
owner-conditions: "hasPermission('moderntags.tag.vip')"
entries:
- priority: 0
modern: tags/vip.yml:modern
legacy: tags/vip.yml:legacy
# tags/default.yml (modern β Text Display, 1.19.4+)
frame-update-rate: -1
placeholders-update-rate: 10
frames:
- text: |-
{owner:prefix}&r{owner:name}{owner:suffix}
&cβ€&f{owner:health}
shadowed: true
y-offset: 0.15
background-color: "#00000000"
# tags/default-legacy.yml (legacy β Scoreboard Teams, below 1.19.4)
frame-update-rate: -1
placeholders-update-rate: 10
preserve-player-name-color: true
frames:
- prefix: "{owner:prefix}"
name-color: "white"
suffix: "{owner:suffix}"
π¬ Commands & Permissions
Commands
/moderntags reloadβ reload plugin configuration Permissionsmoderntags.see.ownβ visibility of own tagmoderntags.reloadβ access to reload command
π¦ Dependencies
Required:
- PacketEvents 2.0+ Optional:
- PlaceholderAPI
- Vault
Information
Category
Miscellaneous
Published
November 13, 2026
License
Apache 2.0
0Downloads
0Stars
Supports Folia
Pinned Versions
- R1.19.4β26.3
Pages
Members
1Owner