- Tag customization — full control over tag appearance (color, shadows, transparency, alignment, scale, etc.)
- Animated tags — multiple frames with configurable transition speed
- Dual renderer — Text Display entities for 1.19.4+ clients; Scoreboard Teams for older clients, picked automatically per viewer
- Condition system —
owner-conditionsandviewer-conditionslet you select the right tag group with arbitrary logic (e.g.hasPermission('moderntags.tag.vip')) - Priority system — tag groups and entries are sorted by priority; the highest-priority match wins
- PlaceholderAPI integration — any PAPI placeholder works out of the box
- Vault integration — automatic prefix/suffix insertion with optional MiniMessage parsing
- Sneak dimming — tags fade for crouching players on 1.19.4+ clients, matching vanilla behavior
- TAB compatibility — ModernTags 2.0 now manages Scoreboard Teams internally, so you do not need to disable TAB's own nametag display; this also fixes conflicts with glow plugins and other Scoreboard Teams consumers
- Lock-free task queue — events (player death, join, etc.) are enqueued and processed on the next tick, eliminating all concurrency issues
- 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 (since 1.1) and all Paper forks (Paper, Purpur, etc.)
| Command | Description |
|---|---|
/moderntags |
Reload plugin configuration |
/moderntags reload |
Reload plugin configuration |
/moderntags update |
Check for an update and download it for installation on restart |
| Permission | Description |
|---|---|
moderntags.see.own |
See your own tag |
moderntags.admin |
Reload configuration and download updates (operators by default) |
updates.check enables update checks at startup. When both updates.check and updates.auto-download are enabled,
an available update is downloaded to the server's update folder and installed on the next server restart.
/moderntags update checks again and downloads an available update, even when startup checks or automatic downloads
are disabled. When updates.auto-download is true, update is hidden from tab completion but remains available
by typing the command. Configuration reloads apply these settings without starting another automatic check.
ModernTags uses bStats for standard server and plugin statistics. To disable collection,
set enabled: false in the shared plugins/bStats/config.yml file.
Placeholders support two contexts: {owner:key} resolves against the tag's target player, {viewer:key} resolves
against the observing player. This lets you show different tag content depending on who is looking.
| Placeholder | Description |
|---|---|
{owner:name} |
Tag owner's name |
{owner:display_name} |
Tag owner's display name |
{owner:health} |
Tag owner's health |
{owner:prefix} |
Tag owner's prefix from Vault |
{owner:suffix} |
Tag owner's suffix from Vault |
{viewer:name} |
Viewer's name |
{viewer:display_name} |
Viewer's display name |
{viewer:health} |
Viewer's health |
{viewer:prefix} |
Viewer's prefix from Vault |
{viewer:suffix} |
Viewer's suffix from Vault |
Any PAPI expansion is supported via {owner:EXPANSION_PLACEHOLDER} or {viewer:EXPANSION_PLACEHOLDER}, for example:
{owner:player_level}— tag owner's level{viewer:player_ping}— viewer's ping{owner:vault_rank}— tag owner's rank
# Check for updates at startup and optionally download them for installation on restart.
updates:
check: true
auto-download: false
# Whether to parse Vault prefix/suffix placeholders using MiniMessage.
# If false, they are treated as legacy (&-formatted) strings.
vault-mm-formatting: false
# Hide the tag when the player has passengers (e.g., another player riding them).
hide-tag-when-has-passenger: true
# How often (in milliseconds) ModernTags should tick.
tick-rate: 50
# Settings for the legacy below-name objective (shown to all clients).
legacy-general:
below-name-value: "owner:health" # do not use {} here
below-name-text: "&c❤"
# Tag groups — sorted by priority (highest wins).
# owner-conditions — evaluated once per tag owner
# viewer-conditions — evaluated per viewer
#
# Client version selection (TextDisplay vs Scoreboard Teams) is automatic:
# each tag file contains both "modern" and "legacy" sections.
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:legacyUsed for clients 1.19.4 and above (Text Display entities).
# Frame transition rate (in ticks), -1 to disable animation
frame-update-rate: -1
# Placeholder update rate (in ticks)
placeholders-update-rate: 10
frames:
- text: |-
{owner:prefix}&r{owner:name}{owner:suffix}
&c❤&f{owner:health}
# Position offsets (float)
x-offset: 0.0
y-offset: 0.15
z-offset: 0.0
# Scale (float)
scale: 1.0
# Opacity when the owner is sneaking (-128 to 127)
sneak-text-opacity: 60
# Brightness: "block-<0-15>" or "sky-<0-15>"
brightness: "block-15"
# View range in blocks (float)
view-range: 1.0
# Shadow
shadowed: true
shadow-radius: 0.0
shadow-strength: 1.0
# Background color: #RRGGBB or #AARRGGBB
background-color: "#00000000"
# Text opacity (-128 to 127, -1 = fully opaque)
text-opacity: -1
# Other
line-width: 200
vertical-billboard: false
see-through: false
default-background: false
alignment: "CENTER" # LEFT | CENTER | RIGHTUsed for clients below 1.19.4 (Scoreboard Teams).
frame-update-rate: -1
placeholders-update-rate: 10
# Keep the player's existing name color set by other plugins (e.g. glow plugins).
preserve-player-name-color: true
# Colors treated as "no color set" — the frame's name-color is used instead.
ignored-colors: [ "white" ]
frames:
- prefix: "{owner:prefix}"
name-color: "white"
suffix: "{owner:suffix}"modern:
frame-update-rate: 10
placeholders-update-rate: 10
frames:
- text: |-
&6★ {owner:prefix}&r&e{owner:name}{owner:suffix} &r&6★
&c❤&f{owner:health}
- text: |-
&e✦ {owner:prefix}&r&e{owner:name}{owner:suffix} &r&e✦
&c❤&f{owner:health}
legacy:
frame-update-rate: 10
placeholders-update-rate: 10
preserve-player-name-color: true
ignored-colors: [ "white" ]
frames:
- prefix: "&e✦ {owner:prefix}"
name-color: "yellow"
suffix: "{owner:suffix} &e✦"
- prefix: "&6★ {owner:prefix}"
name-color: "yellow"
suffix: "{owner:suffix} &6★"| Parameter | Type | Default | Description |
|---|---|---|---|
text |
string | — | Tag text; supports legacy & formatting and {owner:*} placeholders |
x-offset |
float | 0.0 |
X-axis offset |
y-offset |
float | 0.15 |
Y-axis offset |
z-offset |
float | 0.0 |
Z-axis offset |
scale |
float | 1.0 |
Tag scale |
sneak-text-opacity |
int | 60 |
Opacity when owner is sneaking (-128–127) |
text-opacity |
int | -1 |
Text opacity (-128–127; -1 = fully opaque) |
brightness |
string | "block-15" |
"block-<0-15>" or "sky-<0-15>" |
view-range |
float | 1.0 |
View range in blocks |
shadowed |
bool | true |
Render text shadow |
shadow-radius |
float | 0.0 |
Shadow radius |
shadow-strength |
float | 1.0 |
Shadow intensity |
background-color |
string | "#00000000" |
Background in #RRGGBB or #AARRGGBB |
default-background |
bool | false |
Use the standard Minecraft background |
line-width |
int | 200 |
Maximum line width |
vertical-billboard |
bool | false |
Vertical billboard mode |
see-through |
bool | false |
Visible through blocks |
alignment |
string | "CENTER" |
LEFT, CENTER, or RIGHT |
| Parameter | Type | Description |
|---|---|---|
prefix |
string | Text shown before the player name (legacy formatting) |
name-color |
string | Player name color (e.g. "yellow", "white") |
suffix |
string | Text shown after the player name (legacy formatting) |
- PacketEvents — packet-level rendering
- PlaceholderAPI — placeholders from other plugins
- Vault — prefix and suffix support