Content generated with AI — it may contain mistakes.

ExyliaChatCosmetics/ReferenceUpdated in v1.3.0

Placeholders

Put a player's tag, coloured name and rank in your chat format, tab list or scoreboard, and what each placeholder answers.

Page 20 of 301 min read

Use these to show what a player wears in a chat plugin, tab list, nametag or scoreboard. They work in every ExyliaLib text on their own, and in other plugins once PlaceholderAPI is installed. Click one to copy it.

Pick the notation#

Tags and coloured names come in three spellings. Pick the one your chat plugin reads:

  • No suffix: MiniMessage (<#ffd700>[MVP]). The default.
  • _legacy: & codes.
  • _section: § codes, for plugins that send the string as it is.

A chat format for a MiniMessage chat plugin:

%exyliachatcosmetics_tag%%exyliachatcosmetics_nick%<gray>: <white>%message%

For a plugin that reads legacy strings:

%exyliachatcosmetics_tag_section%%exyliachatcosmetics_nick_section%§7: §f%message%

The message itself is coloured by the plugin's chat hook, not by a placeholder. Keep your chat plugin's own message placeholder.

Tab list and nametags: use the _still forms

An animated tag changes every frame, and anything that is sent again each time it changes would flood your players with packets. Use %exyliachatcosmetics_tag_still%, nick_still, identity_still and so on in the tab list, nametags and scoreboards: the same drawing held on its first frame.

PlaceholderShowsExample
%exyliachatcosmetics_tag%The worn tag, as MiniMessage. A custom tag wins. Empty when none is worn.<#ffd700>[MVP]
%exyliachatcosmetics_tag_legacy%The worn tag with & codes.&#ffd700[MVP]
%exyliachatcosmetics_tag_section%The worn tag with § codes.§x§f§f§d§7§0§0[MVP]
%exyliachatcosmetics_nick%The player's name in the worn nick colour (MiniMessage).<#ffd700>Steve
%exyliachatcosmetics_nick_legacy%The coloured name with & codes.&#ffd700Steve
%exyliachatcosmetics_nick_section%The coloured name with § codes.§x§f§f§d§7§0§0Steve
%exyliachatcosmetics_identity%Tag and coloured name together (MiniMessage).<#ffd700>[MVP] Steve
%exyliachatcosmetics_identity_legacy%Tag and coloured name with & codes.&#ffd700[MVP] Steve
%exyliachatcosmetics_identity_section%Tag and coloured name with § codes.§x§f§f§d§7§0§0[MVP] Steve
%exyliachatcosmetics_rank_prefix%The rank's prefix, painted in the worn rank colour (MiniMessage).<#c0c0c0>[VIP]
%exyliachatcosmetics_rank_prefix_legacy%The rank prefix with & codes.&#c0c0c0[VIP]
%exyliachatcosmetics_rank_prefix_section%The rank prefix with § codes.§x§c§0§c§0§c§0[VIP]
%exyliachatcosmetics_rank_suffix%The rank's suffix, painted in the worn rank colour (MiniMessage).<#c0c0c0> *
%exyliachatcosmetics_rank_suffix_legacy%The rank suffix with & codes.&#c0c0c0 *
%exyliachatcosmetics_rank_suffix_section%The rank suffix with § codes.§x§c§0§c§0§c§0 *
%exyliachatcosmetics_tag_still%tag with every animation held on its first frame. Use it in the tab list, nametags and scoreboards. Also `_still_legacy` and `_still_section`.<#ffd700>[MVP]
%exyliachatcosmetics_nick_still%nick with every animation held on its first frame. Use it in the tab list, nametags and scoreboards. Also `_still_legacy` and `_still_section`.<#ffd700>[MVP]
%exyliachatcosmetics_identity_still%identity with every animation held on its first frame. Use it in the tab list, nametags and scoreboards. Also `_still_legacy` and `_still_section`.<#ffd700>[MVP]
%exyliachatcosmetics_rank_prefix_still%rank_prefix with every animation held on its first frame. Use it in the tab list, nametags and scoreboards. Also `_still_legacy` and `_still_section`.<#ffd700>[MVP]
%exyliachatcosmetics_rank_suffix_still%rank_suffix with every animation held on its first frame. Use it in the tab list, nametags and scoreboards. Also `_still_legacy` and `_still_section`.<#ffd700>[MVP]
%exyliachatcosmetics_tag_id%Id of the worn tag.mvp
%exyliachatcosmetics_tag_name%Display name of the worn tag.MVP
%exyliachatcosmetics_font_id%Id of the worn font.fraktur
%exyliachatcosmetics_font_name%Display name of the worn font.Fraktur
%exyliachatcosmetics_modifiers%Ids of the worn modifiers, comma-separated.bold,italic
%exyliachatcosmetics_modifiers_count%How many modifiers are worn.2
%exyliachatcosmetics_preset_id%The preset every piece of which is worn right now.exylia
%exyliachatcosmetics_preset_name%Display name of that preset.Exylia
%exyliachatcosmetics_loadout_id%The loadout applied last.12
%exyliachatcosmetics_favorites_count%How many cosmetics are starred.4
%exyliachatcosmetics_equipped_<type>%Ids worn of any type, for example %exyliachatcosmetics_equipped_shadow_color%.gold
%exyliachatcosmetics_nick_color%The name colour as #rrggbb, or #a:#b:#c for a gradient.#ffd700
%exyliachatcosmetics_nick_color_id%Id of the cosmetic that set the name colour.gold
%exyliachatcosmetics_nick_color_name%Display name of the cosmetic that set the name colour.Gold
%exyliachatcosmetics_rank_color%The rank colour as #rrggbb, or #a:#b:#c for a gradient.#ffd700
%exyliachatcosmetics_rank_color_id%Id of the cosmetic that set the rank colour.gold
%exyliachatcosmetics_rank_color_name%Display name of the cosmetic that set the rank colour.Gold
%exyliachatcosmetics_chat_color%The message colour as #rrggbb, or #a:#b:#c for a gradient.#ffd700
%exyliachatcosmetics_chat_color_id%Id of the cosmetic that set the message colour.gold
%exyliachatcosmetics_chat_color_name%Display name of the cosmetic that set the message colour.Gold
%exyliachatcosmetics_owns_<type:id>%true or false: whether the player owns that cosmetic, for example %exyliachatcosmetics_owns_tag:mvp%.true
%exyliachatcosmetics_expires_<type:id>%permanent, the time left, or nothing when not owned.13d 4h
%exyliachatcosmetics_tokens_<type>_<kind>%Tokens left, for example %exyliachatcosmetics_tokens_customcolor_create%.2

When there is nothing to show#

Every placeholder here always answers. A player wearing nothing gets an empty text by default, so a chat format does not print the raw placeholder. To show a word instead, set placeholders.none in config.yml. A name that points at something that no longer exists in your files answers placeholders.unknown (? by default).

A chat line is drawn once, so an animated tag keeps the frame it had when the message was sent. A scoreboard or a hologram asks again on every refresh and does animate.

Something missing on this page? Tell us on Discord