EndyDev Read the docs
Esc

Using the badges

A badge is a character. Wherever a plugin lets you write text, you can put a badge, in one of three forms:

FormExampleWhere
The charactercopied from /erank listLuckPerms prefixes, chat, signs, books, /tellraw
Its code\uE900YAML and JSON config files, inside double quotes
The placeholder%erank_owner%Anything that reads PlaceholderAPI: TAB, scoreboards, holograms, chat formats

The character itself looks like an empty box (or nothing) in your text editor and on Discord: that’s normal. It only turns into the badge in Minecraft, for players with the resource pack.

A LuckPerms prefix

  1. /erank list and click the badge: it’s copied.
  2. Paste it into the prefix, with a space after it:
Commands
/lp group owner meta setprefix 100 "<badge> "
/lp group vip meta setprefix 50 "%erank_vip% "

<badge> is where you paste the character (Ctrl + V in the chat box). The first form uses the character. The second needs PlaceholderAPI, and a chat or TAB plugin that parses placeholders inside prefixes. Both show the same badge.

The placeholder

%erank_<id>% gives the rank’s character. <id> is the rank ID from the editor (owner, mvp_plus). It works for every player: it isn’t “the player’s rank”, it’s always that badge.

To show each player’s own rank badge, put the badge in each group’s prefix (above) and use your chat or TAB plugin’s prefix placeholder, e.g. %luckperms_prefix%.

An id that doesn’t exist stays as typed (%erank_ownr%), so a typo is easy to spot.

Config files

Most plugins read \uE900 inside double quotes as the character:

TAB: groups.yml
owner:
  tabprefix: "\uE900 &c"

If a plugin shows the code as text, paste the character itself between the quotes, or use the placeholder.

Colours

A badge keeps its own colours only when the text colour is white. A coloured prefix tints it: &c before the badge turns it red. Put colour codes after the badge, not before:

Prefix
"<badge> &c"    the badge in its colours, the name in red
"&c<badge> "    the badge tinted red

Where they show

Chat, the TAB list, nametags above heads, the scoreboard sidebar, item names and lore, signs, books, boss bars, titles and holograms: anything drawn with Minecraft’s default font. Badges taller than 24 px overlap the lines above and below everywhere except nametags.