Placeholders - AlonsoAliaga/AlonsoPlus GitHub Wiki

Placeholders

Available placeholders for PlaceholdersAPI.

%alonsoplus_developer%

Returns plugin developer.
Example: AlonsoAliaga

%alonsoplus_version%

Returns plugin version.
Example: 0.1-BETA

%alonsoplus_rank_prefix%

Returns player's rank based on ranked permission and color selected.
Example: §bMVP§c+

%alonsoplus_rank_prefix_raw% (🔰 Added in 0.8-BETA)

Returns player's rank based on ranked permission and color selected. Returns raw color.
Example: &bMVP&c+

%alonsoplus_color%

Returns player's selected color. If player is not ranked, it returns empty string.
Example: §c or empty string

%alonsoplus_lastcolor% (🔰 Added in 0.8-BETA)

Returns player's selected color, last color if gradient. If player is not ranked, it returns empty string.
Example: §c or empty string

%alonsoplus_lastcolor_raw% (🔰 Added in 0.8.1-BETA)

Returns player's selected color, last color if gradient. If player is not ranked, it returns empty string. Returns raw color.
Example: &c or empty string

%alonsoplus_color_raw% (🔰 Added in 0.8-BETA)

Returns player's selected color. If player is not ranked, it returns empty string. Returns raw color.
Example: &c or empty string

%alonsoplus_color_identifier%

Returns player's selected color identifier. If player is not ranked, it returns default color.
Example: red or default

%alonsoplus_color_TEXT% (🔰 Added in 0.6-BETA)

Returns player's selected color. If player is not ranked or not loaded, it returns TEXT specified.
Remember to use only color codes, NOT WORDS. Output text is NOT color parsed.
Example: %alonsoplus_color_&8%
Output: &a (if player is ranked and has a color selected) or &8 (because you specified &8)

%alonsoplus_color_parse_TEXT% (🔰 Added in 0.6-BETA)

Returns player's selected color. If player is not ranked or not loaded, it returns TEXT specified.
Remember to use only color codes, NOT WORDS. Output text is color parsed.
Example: %alonsoplus_color_parse_&8%
Output: §a (if player is ranked and has a color selected) or §8 (because you specified &8)

%alonsoplus_lastcolor_TEXT% (🔰 Added in 0.8-BETA)

Returns player's selected color. If color selected is gradient, returns last color, otherwise it
returns unique color. If player is not ranked or not loaded, it returns TEXT specified.
Remember to use only color codes, NOT WORDS. Output text is NOT color parsed.
INCLUDES ADDITIONAL FORMAT
Example: %alonsoplus_lastcolor_&8%
Output: &a (if player is ranked and has a color selected) or &8 (because you specified &8)

%alonsoplus_lastcolor_parse_TEXT% (🔰 Added in 0.8-BETA)

Returns player's selected color. If color selected is gradient, returns last color, otherwise it
returns unique color. If player is not ranked or not loaded, it returns TEXT specified.
Remember to use only color codes, NOT WORDS. Output text is color parsed.
INCLUDES ADDITIONAL FORMAT
Example: %alonsoplus_lastcolor_parse_&8%
Output: §a (if player is ranked and has a color selected) or §8 (because you specified &8)

💠 When or how to use custom placeholders?

Read this page for more information.

%alonsoplus_custom_IDENTIFIER% (🔰 Added in 0.6-BETA)

Similar to %alonsoplus_rank_prefix%, however, this allows you to create/add more placeholders to parse.
Remember to use this option you MUST enable it in "Placeholders.Custom.Enabled" in config.yml file.
This is an extra option in case you want to replace the color in more than one variable.
Example: %alonsoplus_custom_another_prefix% (This is a default identifier)
Output: §bMVP§c+ (or however it's configured)

%alonsoplus_custom_raw_IDENTIFIER% (🔰 Added in 0.8-BETA)

Similar to %alonsoplus_rank_prefix_raw%, however, this allows you to create/add more placeholders to parse.
Remember to use this option you MUST enable it in "Placeholders.Custom.Enabled" in config.yml file.
This is an extra option in case you want to replace the color in more than one variable. Returns raw color.
Example: %alonsoplus_custom_raw_another_prefix% (This is a default identifier)
Output: &bMVP§c+ (or however it's configured)

💠 How to use colorize placeholders?

Colorized placeholders require three input: Ranked value, No ranked value and placeholder to replace.\

• RANKEDVALUE Value that will be parsed if player has ranked permission from config.yml
• NORANKEDVALUE Value that will be parsed if player doesn't have ranked permission from config.yml
• REPLACEMENT String that will be replaced/removed from value.

%alonsoplus_colorize_RANKEDVALUE_NORANKEDVALUE_REPLACEMENT% (🔰 Added in 0.8-BETA)

This placeholders allows you to create custom colored prefixes/messages based on player selected color.
Example: %alonsoplus_colorize_{COLOR}{player_name}_&7{player_name}_{COLOR}%
Output: §aAlonsoAliaga (if ranked and lime color selected) or §7AlonsoAliaga (if no ranked)

%alonsoplus_colorize_raw_RANKEDVALUE_NORANKEDVALUE_REPLACEMENT% (🔰 Added in 0.8-BETA)

This placeholders allows you to create custom colored prefixes/messages based on player selected color.
Returns raw color.
Example: %alonsoplus_colorize_{COLOR}{player_name}_&7{player_name}_{COLOR}%
Output: &aAlonsoAliaga (if ranked and lime color selected) or &7AlonsoAliaga (if no ranked)