Skip to content

Placeholders

AlonsoAliaga edited this page Feb 24, 2026 · 12 revisions

General placeholders πŸ‘€

Available placeholders for PlaceholdersAPI.

%alonsotags_developer%

Returns plugin developer.
Example: AlonsoAliaga

%alonsotags_version%

Returns plugin version.
Example: 0.1-BETA

Tags placeholders πŸ”–

%alonsotags_tag_of_IDENTIFIER% (πŸ”° PREMIUM ONLY - Added in 2.1-BETA-PRO)

Returns the tag from the specified tag IDENTIFIER.
Example: "%alonsotags_tag_of_rekt-tag%" => "[REKT]"

%alonsotags_recognition_title_of_IDENTIFIER% (πŸ”° PREMIUM ONLY - Added in 2.1-BETA-PRO)

Returns the recognition title from the specified tag IDENTIFIER.
Example: "%alonsotags_recognition_title_of_rekt-tag%" => "πŸ’€ Serial Killer πŸ’€"

%alonsotags_total_tags% (πŸ”° Added in 2.3-BETA[-PRO])

Returns the current amount of tags in the server.
Example: "250"

%alonsotags_unlocked_tags% (πŸ”° Added in 2.3-BETA[-PRO])

Returns the current amount of unlocked tags by the player.
Example: "130"

%alonsotags_total_tags% (πŸ”° Added in 2.3-BETA[-PRO])

Returns the current amount of locked tags the player has.
Example: "120"

%alonsotags_tag%

Returns current player tag. (Do not use)
Example: "[REKT]"

%alonsotags_tag_chat%

Returns current player tag with chat format specified in config.yml
Example: "[REKT] "

%alonsotags_tag_tab%

Returns current player tag with tab format specified in config.yml
Example: " [REKT]"

%alonsotags_tag_identifier%

Returns current player tag identifier with identifier format specified in config.yml
Example: rekt-tag

%alonsotags_tag_scoreboard%

Returns current player tag with scoreboard format specified in config.yml
Example: "[REKT]"

%alonsotags_tag_description% (πŸ”° Added in 2.1.3-BETA[-PRO])

Returns current player tag description from tags.yml in "Description" section.
Example: "Β§7This is a tag description!"

%alonsotags_recognition_title% (πŸ”° PREMIUM ONLY - Added in 2.1-BETA-PRO)

Returns current player recognition title with default format specified in config.yml
Example: "πŸ’€ Monster Hunter πŸ’€"

%alonsotags_recognition_title_chat% (πŸ”° PREMIUM ONLY - Added in 2.1-BETA-PRO)

Returns current player recognition title with chat format specified in config.yml
Example: "πŸ’€ Monster Hunter πŸ’€" or "No title"

%alonsotags_recognition_title_name_tag% (πŸ”° PREMIUM ONLY - Added in 2.1-BETA-PRO)

Returns current player recognition title with name tag format specified in config.yml
Example: "πŸ’€ Monster Hunter πŸ’€" or empty line (by default)

%alonsotags_recognition_title_scoreboard % (πŸ”° PREMIUM ONLY - Added in 2.1-BETA-PRO)

Returns current player recognition title with scoreboard format specified in config.yml
Example: "πŸ’€ Monster Hunter πŸ’€" or "No title"

%alonsotags_has_unlocked_tag-identifier% (πŸ”° Added in 2.2.1-BETA[-PRO])

Returns if player has a tag unlocked. (Permission or purchased)
Example: %alonsotags_has_unlocked_rekt-tag% can return true or false

%alonsotags_is_purchasable_tag-identifier% (πŸ”° Added in 2.4-BETA[-PRO])

Returns if a tag is a purchasable tag. (Requires money to be obtained)
Example: %alonsotags_is_purchasable_rekt-tag% can return true or false

%alonsotags_total_tags% (πŸ”° Added in 2.4-BETA[-PRO])

Returns the amount of available tags in the server.
Example: %alonsotags_total_tags% returns 27

%alonsotags_unlocked_tags% (πŸ”° Added in 2.4-BETA[-PRO])

Returns the amount of unlocked tags by the player.
Example: %alonsotags_unlocked_tags% returns 5

%alonsotags_locked_tags% (πŸ”° Added in 2.4-BETA[-PRO])

Returns the amount of locked tags for the player.
Example: %alonsotags_locked_tags% returns 22

%alonsotags_restoreall_PLACEHOLDER WITHOUT PERCENTAGE% (πŸ”° Added in 2.1-BETA)

  • Returns the original string before colors were parsed. HEX colors are included.
    Example: %alonsotags_restoreall_vault_prefix% returns Β§xΒ§aΒ§bΒ§cΒ§dΒ§eΒ§fΒ§lModerator then it will convert it to &#abcdef&lModerator
    ⚠️ This is extremely useful if a placeholder you have make weird things with colors.

%alonsotags_legacyrestoreall_PLACEHOLDER WITHOUT PERCENTAGE% (πŸ”° Added in 2.1-BETA)

  • Returns the original string before colors were parsed (Weird legacy format). HEX colors are included.
    Example: %alonsotags_legacyrestoreall_vault_prefix% returns &x&a&b&c&d&e&fModerator then it will convert it to &#abcdefModerator
    ⚠️ This is extremely useful if a placeholder you have make weird things with colors.

%alonsotags_addampersandhex_PLACEHOLDER WITHOUT PERCENTAGE% (πŸ”° Added in 2.1-BETA)

  • Fixes placeholders that return hex colors in #rrggbb format.
    Example: %alonsotags_addampersandhex_vault_prefix% returns #abcdefModerator then it will convert it to &#abcdefModerator
    ⚠️ This is extremely useful if a placeholder you have make weird things with colors.

%alonsotags_removeampersandhex_PLACEHOLDER WITHOUT PERCENTAGE% (πŸ”° Added in 2.1-BETA)

  • Modifies placeholders output that return hex colors in &#rrggbb format if you need it.
    Example: %alonsotags_removeampersandhex_vault_prefix% returns &#abcdefModerator then it will convert it to #abcdefModerator
    ⚠️ This is extremely useful if a placeholder you have make weird things with colors.

%alonsotags_colorize_PLACEHOLDER WITHOUT PERCENTAGE% (πŸ”° Added in 2.4-BETA)

  • Parses the placeholder and parses the colors.
    Example: %aalonsotags_colorize_vault_prefix% returns &#abcdef&lModerator then it will convert it to Β§xΒ§aΒ§bΒ§cΒ§dΒ§eΒ§fΒ§lModerator
    ⚠️ This is extremely useful if a placeholder you have doesn't parse colors.

Custom fields placeholders 🀯 (πŸ”° PREMIUM ONLY - Added in 2.4-BETA-PRO)

Introduced in 2.4-BETA-PRO, AlonsoTagsPro allows the server owners the possibility to add
additional fields to be displayed when a player selects specific tags.

These fields are selected by the owner at the moment of editing/creating tags.

Important

You must modify the custom fields available before using them.
πŸ–±οΈ Click here for more information about how to create them.

For this examples. We will use the field prefix.

%alonsotags_custom_field_chat_field-identifier%

Returns the custom field associated to the provided field identifier for the selected tag of the player with the chat format.
If none selected or empty, returns an empty string.
Example: %alonsotags_custom_field_chat_prefix% returns [H] or (empty)

%alonsotags_custom_field_tab_field-identifier%

Returns the custom field associated to the provided field identifier for the selected tag of the player with the tab format.
If none selected or empty, returns an empty string.
Example: %alonsotags_custom_field_tab_prefix% returns [Hero] or (empty)

%alonsotags_custom_field_score_field-identifier%

Returns the custom field associated to the provided field identifier for the selected tag of the player with the score format.
If none selected or empty, returns an empty string.
Example: %alonsotags_custom_field_score_prefix% returns [Hero] or (empty)

Clone this wiki locally