Placeholders

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

O plugin fornece Placeholders do PlaceholderAPI que você pode usar em qualquer plugin que suporte PlaceholderAPI.

Placeholders do Jogador

Placeholder	Valor Retornado	Descrição
%yclans_has%	Texto	Retorna se o jogador possui clan.
%yclans_kills_civilian%	Número	Retorna as kills civis do jogador.
%yclans_kills_neutral%	Número	Retorna as kills neutras do jogador.
%yclans_kills_rival%	Número	Retorna as kills rivais do jogador.
%yclans_kills_total%	Número	Retorna as kills totais do jogador.
%yclans_deaths%	Número	Retorna as mortes do jogador.
%yclans_kdr%	Número	Retorna o kdr do jogador.
%yclans_role%	Texto	Retorna o cargo do jogador.
%yclans_role_symbol%	Texto	Retorna o símbolo do cargo do jogador.
%yclans_own_tag%	Texto	Retorna a tag customizada do jogador.
%yclans_tag%	Texto	Retorna a tag do clan.

Placeholders do Clan

Placeholder	Valor Retornado	Descrição
%yclans_clan_leader%	Texto	Retorna o líder do clan.
%yclans_clan_captains%	Texto	Retorna os capitães do clan.
%yclans_clan_trusted%	Texto	Retorna os membros confiáveis do clan.
%yclans_clan_info_allies%	Texto	Retorna os aliados do clan.
%yclans_clan_info_rivals%	Texto	Retorna os rivais do clan.
%yclans_clan_enter_date%	Texto	Retorna a data que o jogador entrou no clan.
%yclans_clan_enter_hour%	Texto	Retorna a hora que o jogador entrou no clan.
%yclans_clan_tag%	Texto	Retorna a tag do clan.
%yclans_clan_colortag%	Texto	Retorna a tag colorida do clan.
%yclans_clan_name%	Texto	Retorna o nome do clan.
%yclans_clan_description%	Texto	Retorna a descrição do clan.
%yclans_clan_kills_civilian%	Número	Retorna as kills civis do clan.
%yclans_clan_kills_neutral%	Número	Retorna as kills neutras do clan.
%yclans_clan_kills_rival%	Número	Retorna as kills rivais do clan.
%yclans_clan_kills%	Número	Retorna as kills totais do clan.
%yclans_clan_deaths%	Número	Retorna as mortes do clan.
%yclans_clan_kdr%	Número	Retorna o kdr do clan.
%yclans_clan_money%	Número	Retorna o money do clan sem formatação.
%yclans_clan_money_formatted%	Texto	Retorna o money do clan formatado.
%yclans_clan_allies%	Número	Retorna a quantia de aliados do clan.
%yclans_clan_rivals%	Número	Retorna a quantia de rivais do clan.
%yclans_clan_members%	Texto	Retorna a lista de membros do clan.
%yclans_clan_members_total%	Número	Retorna a quantia de membros do clan.
%yclans_clan_members_online%	Número	Retorna a quantia de membros online do clan.

Placeholders Internos

Placeholders internos que você pode usar dentro dos menus e mensagens.

Placeholder	Valor Retornado	Descrição
`{player}`	Texto	Retorna o nome do jogador.
`{clan_tag}`	Texto	Retorna a tag do clan.
`{clan_colortag}`	Texto	Retorna a tag colorida do clan.
`{clan_name}`	Texto	Retorna o nome do clan.
`{role}`	Texto	Retorna o cargo do jogador.
`{role_symbol}`	Texto	Retorna o símbolo do cargo do jogador.
`{own_tag}`	Texto	Retorna a tag customizada do jogador.
`{custom_tag}`	Texto	Retorna a tag customizada do jogador.
`{money}`	Número	Retorna o money do clan.
`{date}`	Texto	Retorna a data formatada.
`{hour}`	Texto	Retorna a hora formatada.
`{enter_date}`	Texto	Retorna a data que o jogador entrou no clan.
`{enter_hour}`	Texto	Retorna a hora que o jogador entrou no clan.
`{kills_civilian}`	Número	Retorna as kills civis.
`{kills_neutral}`	Número	Retorna as kills neutras.
`{kills_rival}`	Número	Retorna as kills rivais.
`{deaths}`	Número	Retorna as mortes.
`{kdr}`	Número	Retorna o kdr.
`{clan_description}`	Texto	Retorna a descrição do clan.
`{verified}`	Texto	Retorna se o clan está verificado.
`{members_online}`	Número	Retorna a quantia de membros online.
`{members_total}`	Número	Retorna a quantia total de membros.
`{max_slots}`	Número	Retorna a quantia máxima de slots de membros.
`{clan_type}`	Texto	Retorna o tipo do clan.
`{leader}`	Texto	Retorna o líder do clan.
`{home_location}`	Texto	Retorna o local da base.
`{home_public}`	Texto	Retorna se a base é pública.
`{allies}`	Número	Retorna a quantia de aliados.
`{allies_slot}`	Número	Retorna a quantia de slots de aliados.
`{rivals}`	Número	Retorna a quantia de rivais.
`{rivals_slot}`	Número	Retorna a quantia de slots de rivais.
`{newsletters_size}`	Número	Retorna a quantia de boletins.
`{entry_type}`	Texto	Retorna o tipo de entrada do clan.
`{solicitations}`	Número	Retorna a quantia de solicitações.
`{banner}`	Item	Retorna o banner do clan.
`{map}`	Item	Retorna o mapa.
`{newsletter}`	Texto	Retorna o boletim.
`{player_to}`	Texto	Retorna o jogador alvo.
`{message}`	Texto	Retorna a mensagem.
`{kicker}`	Texto	Retorna quem kickou.
`{spy}`	Texto	Retorna o estado do modo espião.
`{state}`	Texto	Retorna o estado.
`{time}`	Texto	Retorna o tempo formatado.

Legendchat / nChat Placeholders

O plugin yClans oferece integração completa com o Legendchat e nChat, permitindo exibir informações do clan no chat do servidor.

Placeholders disponíveis

Você pode usar os seguintes placeholders nas suas configurações do Legendchat ou nChat:

Placeholder	Valor Retornado	Descrição
`{clan_tag}`	Texto	Retorna a tag do clan.
`{clan_colortag}`	Texto	Retorna a tag colorida do clan.
`{clan_name}`	Texto	Retorna o nome do clan.
`{clan_role}`	Texto	Retorna o cargo do jogador.
`{clan_role_symbol}`	Texto	Retorna o símbolo do cargo do jogador.

Exemplo de uso no Legendchat

Para usar os placeholders do yClans no Legendchat, adicione-os na sua configuração de formato de chat:

{
  "format": "&7[{clan_colortag}&7] {clan_role_symbol} &f{nick}&7: {message}"
}

Este formato exibirá a tag colorida do clan, o símbolo do cargo e o nome do jogador antes da mensagem.

Os placeholders só serão exibidos se o jogador pertencer a um clan. Caso contrário, eles retornarão valores vazios ou padrão configurados no plugin.

Configuração avançada

Você pode personalizar como os placeholders são exibidos quando o jogador não possui clan através das configurações do yClans no arquivo config.yml:

chat-placeholders:
  tag: '&7[{tag}]'
  colortag: '&7[{tag}&7]'
  name: '&7[{name}&7]'
  role: ' {role} '
  symbol: ' {role_symbol} '

Essas configurações definem o formato padrão dos placeholders quando utilizados no chat.

Nesta página