yStorePlaceholders
Lista de placeholders do PlaceholderAPI e dos arquivos de configuração do yDragon.
PlaceholderAPI
O yDragon registra a expansão ydragon quando o PlaceholderAPI está instalado. Use os placeholders com % em plugins compatíveis, como scoreboards, hologramas e menus externos.
Estatísticas pessoais
Estes placeholders utilizam os dados do jogador informado ao PlaceholderAPI.
| Placeholder | Valor retornado | Descrição |
|---|---|---|
%ydragon_kills% | Número | Vitórias por primeiro lugar no dano. |
%ydragon_damage% | Número abreviado | Dano acumulado registrado para o jogador. |
%ydragon_best_damage% | Número | Maior dano registrado em uma única batalha. |
%ydragon_top1% | Número | Quantidade de vezes em primeiro lugar no ranking da batalha. |
%ydragon_top2% | Número | Quantidade de vezes em segundo lugar no ranking da batalha. |
%ydragon_top3% | Número | Quantidade de vezes em terceiro lugar no ranking da batalha. |
%ydragon_rewards% | Número | Quantidade total de unidades de recompensa guardadas no armazém. |
As estatísticas de dano e colocações são atualizadas no encerramento da batalha com distribuição de recompensas. O dano da luta em andamento aparece em {damage} da actionbar. Quando os dados pessoais ainda não estão carregados, esses placeholders retornam 0.
Informações do evento
| Placeholder | Valor retornado | Descrição |
|---|---|---|
%ydragon_alive% | Texto | Informa se existe evento ativo usando status.yes e status.no. |
%ydragon_health% | Número | Vida atual do dragão ativo, ou 0 quando não há evento. |
%ydragon_max_health% | Número | Vida máxima do dragão ativo, ou 0 quando não há evento. |
%ydragon_name% | Texto | Nome de exibição do dragão ativo, ou - quando não há evento. |
%ydragon_next_spawn% | Texto | Tempo previsto até o próximo dragão agendado, ou o texto de spawn manual. |
%ydragon_next_name% | Texto | Nome do próximo dragão previsto, ou - quando não há previsão. |
Placeholders internos
Os placeholders entre chaves são substituídos pelo próprio yDragon. Cada mensagem, item ou título aceita os placeholders tratados especificamente naquele local. Os valores de dano, vida e quantidades exibidos normalmente usam a formatação abreviada do yPlugins.
Comandos e informações — messages.yml
| Placeholder | Onde usar | Descrição |
|---|---|---|
{cmd} | chat.help, chat.admin-help, chat.arena-not-set, chat.spawn-not-set | Nome ou alias do comando utilizado. |
{command} | chat.syntax | Nome do comando na mensagem de sintaxe. |
{syntax} | chat.syntax | Argumentos esperados para o subcomando. |
{dragon} | chat.dragon-not-found, chat.dragon-disabled, chat.arena-not-set, chat.spawn-not-set, chat.arena-set, chat.spawn-set | ID informado ou nome do dragão, conforme a operação. |
{location} | chat.arena-set, chat.spawn-set | Mundo e coordenadas da localização definida. |
{radius} | chat.arena-set | Raio definido para a arena. |
{list} | chat.dragon-list | Lista dos dragões carregados. |
{name} | chat.dragon-info | Nome de exibição do dragão consultado. |
{key} | chat.dragon-info | ID do dragão consultado. |
{health} | chat.dragon-info | Vida máxima configurada para o tipo de dragão. |
{damage} | chat.dragon-info | Dano de ataque configurado para o tipo de dragão. |
{defense} | chat.dragon-info | Redução de dano configurada como percentual de defesa. |
{rare} | chat.dragon-info | Indicação de raridade usando os textos de sim/não da configuração. |
{mode} | chat.dragon-info | Nome configurado do modo de spawn. |
{next} | chat.dragon-info | Tempo previsto até o próximo spawn ou texto de spawn manual. |
{status} | chat.dragon-info | Indica se o dragão está em combate ou aguardando. |
O modelo chat.target contém {player} para identificar o jogador procurado. Atualmente, esse modelo não é enviado pelos comandos do yDragon.
Eventos, ranking e recompensas — messages.yml
As chaves messages.spawn, messages.death, messages.spawn-title e messages.death-title ficam no arquivo de cada dragão (dragons/<id>.yml), e não na messages.yml.
| Placeholder | Onde usar | Descrição |
|---|---|---|
{name} | messages.spawn, chat.countdown, messages.death, chat.reward-received, chat.participation-reward, chat.ability-announce | Nome de exibição do dragão relacionado à mensagem. |
{health} | messages.spawn | Vida máxima do dragão que apareceu. |
{location} | messages.spawn | Mundo e coordenadas do spawn. |
{seconds} | chat.countdown | Segundos restantes da contagem regressiva. |
{duration} | messages.death | Duração da batalha em segundos, incluindo o sufixo s. |
{ranking} | messages.death | Top 5 de dano da batalha, formatado com chat.ranking-line. |
{position} | chat.ranking-line, chat.reward-received | Posição do jogador no ranking de dano da batalha. |
{player} | chat.ranking-line | Nome do jogador daquela posição. |
{damage} | chat.ranking-line, chat.reward-received, chat.participation-reward | Dano causado pelo jogador naquela batalha. |
{ability} | chat.ability-announce | Anúncio definido em abilities.<id>.announce no YAML do dragão. |
Bossbar — dragons/<id>.yml
Use estes placeholders em bossbar.title no arquivo do dragão:
| Placeholder | Descrição |
|---|---|
{name} | Nome de exibição do dragão da batalha. |
{health} | Vida atual restante do dragão. |
{max} | Vida máxima do dragão da batalha. |
# Exemplo de título com os placeholders da bossbar.
bossbar:
enabled: true
title: '&5{name} &8| &c{health}&7/&c{max}'
color: PURPLE
style: SOLIDActionbar — messages.yml
Use estes placeholders em actionbar.fight:
| Placeholder | Descrição |
|---|---|
{name} | Nome de exibição do dragão ativo. |
{title} | Título da bossbar com seus placeholders já substituídos. |
{bar} | Barra visual de vida configurada em general.progress-bar. |
{health} | Vida atual restante do dragão. |
{max} | Vida máxima do dragão ativo. |
{damage} | Dano pessoal de quem recebe a actionbar na batalha atual. |
# Exemplo de actionbar com o título da bossbar e o dano pessoal.
actionbar:
fight: '{title} &8| {bar} &8| &7Seu dano: &c{damage}'O envio de actionbar.fight é atualizado a cada cinco ticks e também ao contabilizar dano.
O modelo actionbar.next-spawn contém {name}, para o nome do próximo dragão, e {time}, para o tempo restante. Atualmente, esse modelo não é enviado automaticamente pela tarefa do plugin.
Títulos — messages.yml
| Placeholder | Onde usar | Descrição |
|---|---|---|
{name} | messages.spawn-title, title.countdown | Nome do dragão que apareceu ou está prestes a aparecer. |
{player} | messages.death-title | Nome do jogador que terminou em primeiro lugar no dano. |
{seconds} | title.countdown | Segundos restantes até o spawn. |
<nl> | Valores da seção title | Separa o título do subtítulo no mesmo texto. |
Lista de dragões — menus.yml
Use estes placeholders no nome e na lore de dragon-list.dragon-item:
| Placeholder | Descrição |
|---|---|
{name} | Nome de exibição do dragão listado. |
{key} | ID utilizado nos comandos desse dragão. |
{health} | Vida máxima configurada. |
{damage} | Dano de ataque configurado. |
{rare} | Indicação de raridade usando os textos de sim/não. |
{mode} | Nome configurado do modo de spawn. |
{next} | Previsão de próximo spawn ou texto de spawn manual. |
Use estes placeholders no nome e na lore de dragon-list.info-button:
| Placeholder | Descrição |
|---|---|
{status} | Indica se o evento está em andamento ou aguardando. |
{dragon} | Nome do dragão ativo ou - quando não há evento ativo. |
{next} | Próximo dragão e seu tempo, usando status.next-format, ou texto de spawn manual. |
Ranking — menus.yml
Use estes placeholders no nome e na lore de ranking.player-item:
| Placeholder | Descrição |
|---|---|
{player} | Nome do jogador representado pelo item. Também é utilizado em material no arquivo padrão. |
{position} | Posição no ranking por dano acumulado. |
{damage} | Dano acumulado registrado para o jogador. |
{kills} | Vitórias do jogador, incrementadas quando ele fica em primeiro lugar no dano. |
{top1} | Quantidade de vezes em primeiro lugar no dano. |
{top2} | Quantidade de vezes em segundo lugar no dano. |
{top3} | Quantidade de vezes em terceiro lugar no dano. |
Recompensas e armazém — rewards.yml
| Placeholder | Onde usar | Descrição |
|---|---|---|
{chance} | Nome e lore de rewards.<id>.preview | Chance numérica configurada para a recompensa no grupo do dragão, sem acrescentar %. |
{rank} | Nome e lore de rewards.<id>.preview | Nome do grupo de recompensa definido em status.rank-*. |
{amount} | Nome e lore de rewards.<id>.collect | Quantidade de unidades da recompensa guardadas no armazém. |
{placeholder-amount} | Nome e lore de rewards.<id>.collect | Quantidade armazenada multiplicada por command.placeholder-amount. |
{player} | rewards.<id>.item.lore, rewards.<id>.command.list | Nome do jogador que recebe a recompensa. |
{amount} | rewards.<id>.command.list | Quantidade calculada para os comandos de recompensa. |
Para substituir {amount} nos comandos ao recolher pelo armazém, use command.multiply-placeholder: true. O valor será command.placeholder-amount × quantidade coletada.
O {amount} do armazém conta unidades de recompensa. Cada unidade pode entregar a quantidade de itens definida em item.amount.
# Preview de uma recompensa com chance e grupo na lore.
preview:
material: 'DIAMOND:0'
name: '&bDiamante'
amount: 16
lore:
- ' &7Recompensa do Ender Dragon.'
- ' &7Chance: &f{chance}%'
- ' &7Quem ganha? &f{rank}'Formatos adicionais
| Placeholder | Onde usar | Descrição |
|---|---|---|
{name} | menus.yml → rewards-preview.name | Nome do dragão no título do menu de preview. |
<page> | Nome dos itens arrows.previous e arrows.next em menus.yml | Número da página de destino da seta. |
{name} | config.yml → status.next-format | Nome do próximo dragão previsto. |
{time} | config.yml → status.next-format | Tempo previsto até o próximo spawn. |