Text, placeholders and icons
On this page5 sections
Every line is MiniMessage (opens in a new tab) text. This page lists everything you can put inside it.
Colours and formatting
- "<gold>{player}" # named colour
- "<#C86BFA>{player}" # hex colour
- "<gradient:#F5A8FF:#C86BFA>{player}</gradient>" # static gradient
- "<b>BOLD</b> <i>italic</i> <u>underlined</u>"
- "<white>{player}<newline><gray>second row" # two rows in one lineLegacy codes returned by placeholders (&a, §l, &#RRGGBB, e.g. LuckPerms prefixes) are
converted automatically (placeholders.legacy-colors in config.yml). The conversion runs on the
whole line, so & codes in your own lines work too, but MiniMessage is clearer and can do more.
For animated colours (<wave>, <pulse>, <shine>, <anim:rainbow>) see
animations.
Placeholders
| Built-in | |
|---|---|
{player} | name |
{displayname} | display name (nicknames, with colours) |
{ping} | ping in ms |
{health}, {max_health} | health points (20 = 10 hearts) |
{level} | experience level |
{food} | hunger points |
{world} | world name |
{animated}…{/animated} | same as <anim>…</anim> |
Health values are rounded up. Every placeholder the plugin understands or provides is listed in placeholders and tags.
Any PlaceholderAPI (opens in a new tab) placeholder works too:
%luckperms_prefix%, %vault_eco_balance_formatted%, %essentials_afk%...
MiniPlaceholders (opens in a new tab) tags also work.
Placeholders are refreshed every updates.refresh-ticks (20 = once a second). A line or template
can set its own refresh-ticks (e.g. 10 for health, 100 for a balance). Lines without
placeholders are never refreshed.
Values players can type. Some placeholders return text that players choose themselves
(nicknames, clan or faction names). Their colours and styles are kept, but any other tag in them
(<badge:owner>, <head:…>, <sprite:…>, <newline>…) is shown as plain text, so nobody can
fake a rank badge with a clan called <badge:owner>. Placeholders whose text only you write can
be trusted with every tag; by default the rank prefixes and suffixes are:
placeholders:
trusted: ['%luckperms_prefix%', '%luckperms_suffix%', '%vault_prefix%', '%vault_suffix%']So a LuckPerms prefix like <badge:vip> draws the badge, while a nickname cannot.
Replacing values. Show something else instead of what a placeholder returns, in config.yml:
placeholders:
replacements:
'%essentials_afk%':
'yes': ' <gray>[AFK]'
'no': ''Images inside text (no resource pack)
Since Minecraft 1.21.9 text can contain small images. AdvancedNametags uses them for badges, icons and faces. Players on older versions (ViaVersion) and Bedrock players see a text version instead, so nobody gets a broken line.
Live icons
| Tag | Shows | Older clients see |
|---|---|---|
<icon:ping> | ping bars, exactly like the tab list (5 levels) | a ● coloured green → red |
<icon:heart> | one heart: full, half or empty with the health | ❤ |
<icon:hearts> | the health bar (up to 10 hearts; poisoned, withered, frozen and hardcore variants) | a row of ❤ in the same colours |
<icon:armor> | armour bar: one icon per 2 armour points | a row of ⛨ |
<icon:food> | hunger bar | a row of ◆ |
Icons update with the line's refresh-ticks.
Faces
| Tag | |
|---|---|
<face> | the player's own face with its hat layer (works with skin plugins) |
<head:Notch> | any player's face, by name |
<head_texture:hash> | any skin by the hash at the end of its textures.minecraft.net URL (e.g. from minecraft-heads.com) |
Any vanilla texture: <sprite>
<sprite:atlas:path> draws any texture the game already has. The three useful atlases:
| Atlas | Contains | Examples |
|---|---|---|
items | every item | <sprite:items:item/diamond>, item/nether_star, item/totem_of_undying, item/golden_apple, item/emerald |
blocks (default) | every block face | <sprite:block/diamond_block>, block/tnt_side, block/beacon |
gui | HUD and menu sprites, potion effects | see below |
Useful gui sprites:
| Path | |
|---|---|
hud/heart/full, hud/heart/half, hud/heart/container, hud/heart/absorbing_full (golden), poisoned_full, withered_full, frozen_full, hardcore_full | hearts |
hud/food_full, hud/food_half, hud/food_empty | hunger |
hud/armor_full, hud/armor_half, hud/armor_empty | armour |
hud/air, hud/air_bursting | bubbles |
icon/ping_1 … icon/ping_5, icon/ping_unknown | ping bars |
icon/checkmark, icon/info, icon/link, icon/music_notes, icon/news, icon/search, icon/language | small icons |
container/beacon/confirm, container/beacon/cancel | green tick, red cross |
notification/1 … notification/5, notification/more | numbered bubbles |
mob_effect/speed, mob_effect/strength, mob_effect/regeneration, mob_effect/fire_resistance, mob_effect/invisibility, mob_effect/luck... | potion effect icons |
- "<sprite:gui:mob_effect/strength> <red>Strength II"
- "<sprite:items:item/nether_star> <white>Season 1 winner"
- "<sprite:gui:container/beacon/confirm> <green>Verified"Badges
<badge:id> draws a badge from badges.yml; <badge> draws the badge the player shows (the one
they picked, or the first they own) followed by a space, or nothing. An unknown id is shown as
the literal text <badge:id>. See badges.
- "<badge:owner> <red>{player}"
- "<badge>{player}" # nothing if the player owns no badgeResource-pack glyphs
If your server has a resource pack (Nexo, ItemsAdder, Oraxen), their glyphs work in any line as
usual, e.g. :crown: placeholders or <glyph:crown> tags.
Item and block rows
A line can be a floating item or block instead of text:
lines:
- type: item
item: golden_helmet # any item id
# item: "model:nexo:crown" # a custom item model (Nexo, Oraxen, ItemsAdder)
display: fixed # how it is held: fixed, ground, head, gui, none, thirdperson_righthand...
glow: "#FFD24A" # outline colour; or a text effect name for an animated glow: rainbow
motion: "spin speed=0.6"
scale: 0.42
height: 0.4 # space it takes in the stack (default: its scale)
- type: block
block: "oak_stairs[facing=east]" # block states in brackets
scale: 0.3Hiding a line: show-if
A line is only shown when all its conditions hold:
- text: "<gray><i>AFK"
show-if: "%essentials_afk% == yes"
- text: "<red>Combat!"
show-if: ["%combatlogx_in_combat% == true", "!permission:myserver.hidecombat"]
- text: "<gold>Lv {level}"
show-if: "{level} >= 30"| Condition | True when |
|---|---|
permission:node / !permission:node | the player has / lacks the permission |
%placeholder% / !%placeholder% | the value is yes, true, on or 1 (or not) |
<left> <op> <right> | compares; op is == != > >= < <= contains !contains (numbers as numbers, 1,5 = 1.5; text ignoring case; quotes around a value are removed) |
Lines that render to nothing (e.g. an empty placeholder) collapse automatically;
hide-if-empty: false keeps their space.