yStorePlaceholders
Lista de placeholders do plugin.
Todo o texto entre os sinais de menor e maior (<>) é um espaço reservado/variável, substitua-o pelo valor solicitado sem os sinais de menor e maior (<>).
PlaceholderAPI Placeholders
Identificador da expansão: yleagues.
Use no formato %yleagues_<placeholder>%.
| Placeholder | Descrição |
|---|---|
%yleagues_points% | Mostra os pontos formatados do clan do jogador. |
%yleagues_points_raw% | Mostra os pontos brutos do clan do jogador. |
%yleagues_rank% | Mostra o display do rank atual do jogador/clan. |
%yleagues_medal_enemy-of-life% | Mostra a medalha de maior número de mortes quando o jogador possui essa medalha. |
%yleagues_medal_hard-to-kill% | Mostra a medalha de maior número de kills quando o jogador possui essa medalha. |
%yleagues_<liga>_start_time% | Mostra o tempo restante para o início da liga informada. |
%yleagues_<liga>_start_date% | Mostra a data de início da liga informada. |
%yleagues_<liga>_start_hour% | Mostra o horário de início da liga informada. |
%yleagues_<liga>_end_time% | Mostra o tempo restante para o fim da liga informada. |
%yleagues_<liga>_end_date% | Mostra a data de fim da liga informada. |
%yleagues_<liga>_end_hour% | Mostra o horário de fim da liga informada. |
%yleagues_<liga>_clan_colortag_<pos>% | Mostra a tag colorida do clan na posição do top da liga, de 1 a 10. |
%yleagues_<liga>_amount_<pos>% | Mostra a pontuação do clan na posição do top da liga, de 1 a 10. |
%yleagues_<liga>_player_nametag_<pos>% | Mostra a nametag/tag do jogador na posição do top de jogadores da liga. |
%yleagues_<liga>_player_amount_<pos>% | Mostra a pontuação do jogador na posição do top de jogadores da liga. |
Exemplos usando a liga iron
| Placeholder | Descrição |
|---|---|
%yleagues_iron_start_time% | Mostra quanto falta para a liga iron iniciar. |
%yleagues_iron_end_date% | Mostra a data de encerramento da liga iron. |
%yleagues_iron_clan_colortag_1% | Mostra a tag colorida do primeiro clan do top da liga iron. |
%yleagues_iron_amount_1% | Mostra a pontuação do primeiro clan do top da liga iron. |
%yleagues_iron_player_nametag_1% | Mostra a nametag do primeiro jogador do top da liga iron. |
%yleagues_iron_player_amount_1% | Mostra a pontuação do primeiro jogador do top da liga iron. |
Placeholders internos - mensagens
Usados principalmente em messages.yml e nas mensagens enviadas pelo código.
| Placeholder | Descrição |
|---|---|
{command} | Mostra o comando principal usado na mensagem de sintaxe. |
{syntax} | Mostra a sintaxe esperada de um subcomando. |
{player} | Mostra o nome de um jogador ou líder relacionado à ação. |
{provider_display} | Mostra o nome exibido da economia configurada. |
{provider_balance} | Mostra o saldo disponível do jogador na economia. |
{need_points} | Mostra a quantidade de pontos necessária para uma ação. |
{points} | Mostra a quantidade de pontos atual, alterada ou cobrada. |
{league} | Mostra o nome/display de uma liga. |
{amount} | Mostra uma quantidade numérica, limite ou variação de pontos. |
{name} | Mostra o nome/tag informado ao buscar jogador ou clan. |
{clan} | Mostra a tag ou identificador do clan. |
Placeholders internos - Discord e webhook
Usados em discord.yml, config.yml e envios via yDiscordHook/webhook.
| Placeholder | Descrição |
|---|---|
{action} | Mostra a ação que gerou a alteração de pontos. |
{player} | Mostra o jogador envolvido na alteração de pontos. |
{clan_tag} | Mostra a tag do clan envolvido. |
{clan_name} | Mostra o nome do clan envolvido. |
{points} | Mostra a quantidade de pontos ganha ou perdida, com sinal quando aplicável. |
Placeholders internos - menu principal
Usados em menus.yml na seção main.
| Placeholder | Descrição |
|---|---|
{player} | Define skull/nome do jogador em itens de perfil quando usado pelo SetupItem/NBT. |
{leagues} | Mostra quantas ligas o jogador participou. |
{total_points} | Mostra o total de pontos ganhos pelo jogador. |
{wins} | Mostra a quantidade de ligas vencidas pelo jogador ou clan. |
{deaths} | Mostra as mortes do jogador na liga atual. |
{kills} | Mostra as kills do jogador na liga atual. |
{medals} | Mostra as medalhas atuais do jogador. |
{medal_amount} | Mostra a quantidade de medalhas do jogador. |
{points} | Mostra os pontos atuais do clan. |
{rank} | Mostra o rank atual do clan/jogador. |
{league} | Mostra a liga atual do clan ou Nenhuma. |
{participated} | Mostra quantas ligas o clan participou. |
{highest_clan} | Mostra a melhor colocação geral do clan. |
{highest_clan_league} | Mostra a melhor colocação do clan na liga atual. |
{rewards} | Mostra a quantidade de recompensas pendentes para coleta. |
Placeholders internos - ícones de ligas
Usados em leagues/*.yml nas seções icons e nas mensagens de início/fim.
| Placeholder | Descrição |
|---|---|
{start_time} | Mostra o tempo restante para a liga iniciar. |
{start_date} | Mostra a data de início da liga. |
{start_hour} | Mostra o horário de início da liga. |
{end_time} | Mostra o tempo restante para a liga terminar. |
{end_date} | Mostra a data de término da liga. |
{end_hour} | Mostra o horário de término da liga. |
{points} | Mostra os pontos iniciais necessários para participar ou pontos relacionados ao contexto. |
{clan_1} a {clan_10} | Mostra a tag do clan na posição correspondente do top. |
{clan_colortag_1} a {clan_colortag_10} | Mostra a tag colorida do clan na posição correspondente do top. |
{amount_1} a {amount_10} | Mostra a pontuação do clan na posição correspondente do top. |
{<provider>} | Mostra o valor de participação de uma economia, usando a chave provider de participate.prices. |
{money} | Exemplo de placeholder dinâmico para o provider money quando esse provider está em participate.prices. |
{player} | Mostra o jogador que participou ou o líder que recebeu recompensas, dependendo da mensagem. |
{clan} | Mostra o clan vencedor ao finalizar a liga. |
{amount} | Mostra a pontuação do clan vencedor ao finalizar a liga. |
Placeholders internos - recompensas
Usados em rewards.yml e nos comandos/itens de recompensa.
| Placeholder | Descrição |
|---|---|
{player} | Mostra o jogador que está recebendo a recompensa. |
{amount} | Mostra a quantidade da recompensa ou a quantidade calculada para comandos. |
{chance} | Aparece no YAML de preview da recompensa, mas não há substituição runtime confirmada no código atual. |
Placeholders internos - mercado
Usados nos itens do mercado em leagues/*.yml e nas mensagens de compra.
| Placeholder | Descrição |
|---|---|
{player} | Mostra o jogador que comprou ou recebeu o item/comando do mercado. |
{need_points} | Mostra a quantidade de pontos necessária para comprar um item. |
{points} | Mostra os pontos atuais do clan ou o preço pago no mercado. |
Placeholders internos - permissões do mercado
Usados em menus.yml na seção market-permissions.
| Placeholder | Descrição |
|---|---|
{player} | Mostra o membro do clan exibido na lista de permissões do mercado. |
Placeholders internos - clans participantes
Usados em menus.yml na seção league-clans.
| Placeholder | Descrição |
|---|---|
{banner} | Define o item como banner gerado pela primeira letra da tag do clan quando suportado pelo SetupItem/NBT. |
{league} | Mostra o display da liga. |
{clan_tag} | Mostra a tag colorida do clan. |
{clan_name} | Mostra o nome do clan. |
{points} | Mostra a pontuação total do clan na liga. |
{pos} | Mostra a posição do clan no ranking. |
{highest_actual_player} | Mostra o jogador com maior pontuação na liga atual dentro do clan. |
{highest_actual_player_points} | Mostra os pontos do jogador com maior pontuação na liga atual dentro do clan. |
{highest_player} | Mostra o jogador com maior pontuação total dentro do clan. |
{highest_player_points} | Mostra os pontos totais do jogador com maior pontuação dentro do clan. |
Placeholders internos - jogadores do clan
Usados em menus.yml na seção league-clan-players.
| Placeholder | Descrição |
|---|---|
{player} | Mostra o jogador listado no clan. |
{league} | Mostra o display da liga. |
{clan_tag} | Mostra a tag colorida do clan. |
{clan_name} | Mostra o nome do clan. |
{points} | Mostra o total de pontos do jogador na liga. |
{kills} | Mostra os pontos por abates de jogadores. |
{deaths} | Mostra os pontos negativos por mortes. |
{yrankup} | Mostra os pontos por evoluir de rank. |
{yeventos} | Mostra os pontos por eventos ganhos. |
{mobs} | Mostra os pontos por mobs mortos. |
{bosses} | Mostra os pontos por bosses mortos. |
{blocks_broken} | Mostra os pontos por blocos quebrados. |
{farm_broken} | Mostra os pontos por plantações quebradas. |
{fished} | Mostra os pontos por peixes pescados. |
{yvips} | Mostra os pontos por VIPs ativados. |
{yguerra} | Mostra os pontos por vitórias no yGuerra. |
{titansbattle} | Mostra os pontos por batalhas vencidas no TitansBattle. |
{yeventos_lose} | Mostra os pontos negativos por eventos perdidos. |
{punish_ban} | Mostra os pontos negativos por banimentos. |
{punish_mute} | Mostra os pontos negativos por mutes. |
Placeholders internos - histórico
Usados em menus.yml na seção league-history.
| Placeholder | Descrição |
|---|---|
{clan} | Mostra o clan do registro de histórico. |
{date} | Mostra a data e hora do registro. |
{player} | Mostra o jogador relacionado ao registro ou N/D. |
{source} | Mostra a origem do registro, como SYSTEM ou COMMAND. |
{amount} | Mostra a variação de pontos com sinal. |
{before} | Mostra o saldo antes da alteração. |
{after} | Mostra o saldo depois da alteração. |
{reason} | Mostra o motivo registrado na alteração. |
Observações
| Item | Descrição |
|---|---|
| Placeholders PAPI por liga | O trecho <liga> deve ser a key do arquivo em leagues, por exemplo iron para leagues/iron.yml. |
| Posições de top | Os placeholders de top usam posições de 1 a 10. |
| Placeholders de economia | O placeholder dinâmico usa a chave provider carregada em participate.prices, convertida para lowercase no carregamento das economias. |
| Comandos de recompensa e mercado | Os comandos são executados pelo console e substituem {player} e, em recompensas, também {amount} quando aplicável. |