Hologramas

Exemplo completo de configuração

Aqui está um exemplo de como configurar tops em hologramas:

hologram:
  money:
    top-type: 'VAULT'
    hologram:
      lines: 
        - '&a&lTOP MONEY'
        - ''
        - '&f1º: &7{player_1} &f-> &2$&a{value_1_formatted}'
        - '&f2º: &7{player_2} &f-> &2$&a{value_2_formatted}'
        - '&f3º: &7{player_3} &f-> &2$&a{value_3_formatted}'
        - '&f4º: &7{player_4} &f-> &2$&a{value_4_formatted}'
        - '&f5º: &7{player_5} &f-> &2$&a{value_5_formatted}'

TOP-TYPE DISPONÍVEIS: Veja a lista completa na seção de Placeholders.

PLACEHOLDERS DISPONÍVEIS: {index}, {player_<index>}, {value_<index>}, {value_formatted_<index>}, {value_time_<index>}, {value_kdr_<index>}

Opções disponíveis na configuração

Estrutura principal

Cada configuração de holograma deve ter um identificador único (ex: money, kills, etc.).

Exemplo:

hologram:
  money:
    top-type: 'VAULT'

top-type

Define o tipo de ranking que será exibido no holograma.

Exemplo:

top-type: 'VAULT'

Consulte a lista completa de TOP-TYPE disponíveis na página de Placeholders.

hologram

Configuração do holograma.

lines

Define as linhas do holograma. Suporta placeholders e códigos de cor. Diferente dos NPCs e ArmorStands, hologramas podem exibir múltiplos jogadores em um único holograma.

Exemplo:

hologram:
  lines: 
    - '&a&lTOP MONEY'
    - ''
    - '&f1º: &7{player_1} &f-> &2$&a{value_1_formatted}'
    - '&f2º: &7{player_2} &f-> &2$&a{value_2_formatted}'
    - '&f3º: &7{player_3} &f-> &2$&a{value_3_formatted}'
    - '&f4º: &7{player_4} &f-> &2$&a{value_4_formatted}'
    - '&f5º: &7{player_5} &f-> &2$&a{value_5_formatted}'

Placeholders disponíveis:

{player_<index>} - Nome do jogador na posição especificada
{value_<index>} - Valor bruto da posição
{value_<index>_formatted} ou {value_formatted_<index>} - Valor formatado da posição
{value_<index>_time} ou {value_time_<index>} - Tempo formatado da posição
{value_<index>_kdr} ou {value_kdr_<index>} - KDR da posição (se aplicável)

Criando seu primeiro Holograma de Top

Instale um plugin de hologramas

Certifique-se de ter HolographicDisplays ou DecentHolograms instalado.

Configure no arquivo

Adicione a configuração do holograma no arquivo holograms.yml:

hologram:
  meu_top:
    top-type: 'VAULT'
    hologram:
      lines: 
        - '&e&lTOP 5 - MONEY'
        - ''
        - '&71º &f{player_1} &7- &a${value_1_formatted}'
        - '&72º &f{player_2} &7- &a${value_2_formatted}'
        - '&73º &f{player_3} &7- &a${value_3_formatted}'
        - '&74º &f{player_4} &7- &a${value_4_formatted}'
        - '&75º &f{player_5} &7- &a${value_5_formatted}'

Defina a localização

Vá até o local onde deseja criar o holograma e use:

/tophologram set <tipo> <index>

Por exemplo, para o top de money:

/tophologram set money 1

Note que para hologramas, o <index> geralmente é usado para diferenciar múltiplos hologramas do mesmo tipo, não para posições individuais do ranking.

Reinicie ou recarregue

Use /ytops reload ou reinicie o servidor para aplicar as configurações.

Exemplos de configurações

Top de Kills

hologram:
  kills:
    top-type: 'YKILLSYSTEM_KILLS'
    hologram:
      lines: 
        - '&c&l⚔ TOP 10 KILLS ⚔'
        - ''
        - '&f1º &c{player_1} &7- &f{value_1_formatted} kills'
        - '&f2º &c{player_2} &7- &f{value_2_formatted} kills'
        - '&f3º &c{player_3} &7- &f{value_3_formatted} kills'
        - '&f4º &c{player_4} &7- &f{value_4_formatted} kills'
        - '&f5º &c{player_5} &7- &f{value_5_formatted} kills'
        - '&f6º &c{player_6} &7- &f{value_6_formatted} kills'
        - '&f7º &c{player_7} &7- &f{value_7_formatted} kills'
        - '&f8º &c{player_8} &7- &f{value_8_formatted} kills'
        - '&f9º &c{player_9} &7- &f{value_9_formatted} kills'
        - '&f10º &c{player_10} &7- &f{value_10_formatted} kills'

Top de Tempo Online

hologram:
  tempo_online:
    top-type: 'YTEMPOONLINE_TEMPO'
    hologram:
      lines: 
        - '&b&l⏰ TOP TEMPO ONLINE ⏰'
        - ''
        - '&b1º &f{player_1} &7- &b{value_time_1}'
        - '&b2º &f{player_2} &7- &b{value_time_2}'
        - '&b3º &f{player_3} &7- &b{value_time_3}'
        - '&b4º &f{player_4} &7- &b{value_time_4}'
        - '&b5º &f{player_5} &7- &b{value_time_5}'

Top de McMMO

hologram:
  mcmmo:
    top-type: 'MCMMO_TODOS'
    hologram:
      lines: 
        - '&6&l⛏ TOP MCMMO ⛏'
        - ''
        - '&61º &f{player_1} &7- &6{value_1_formatted}'
        - '&62º &f{player_2} &7- &6{value_2_formatted}'
        - '&63º &f{player_3} &7- &6{value_3_formatted}'
        - '&64º &f{player_4} &7- &6{value_4_formatted}'
        - '&65º &f{player_5} &7- &6{value_5_formatted}'

Top Compacto (3 posições)

hologram:
  money_compacto:
    top-type: 'VAULT'
    hologram:
      lines: 
        - '&a&l$ TOP 3 MONEY $'
        - ''
        - '&e1º &7{player_1} &a${value_1_formatted}'
        - '&e2º &7{player_2} &a${value_2_formatted}'
        - '&e3º &7{player_3} &a${value_3_formatted}'

Dicas e truques

Hologramas múltiplos: Você pode exibir até 10 jogadores em um único holograma, ideal para spawn ou áreas centrais.

Atualização automática: Os hologramas são atualizados automaticamente conforme configurado em top-list-tick no arquivo config.yml.

Formatação: Use linhas vazias ('') para criar espaçamento visual entre seções do holograma.

Gerenciando Hologramas de Top

Listar hologramas definidos

Use o comando:

/tophologram list

Deletar um holograma de Top

Vá até o holograma e use:

/tophologram delete <tipo> <index>

Atualizar configuração

Após alterar o arquivo holograms.yml, use:

/ytops reload

Certifique-se de que o plugin de hologramas (HolographicDisplays ou DecentHolograms) está instalado e funcionando corretamente antes de criar tops em hologramas.

Diferenças entre HolographicDisplays e DecentHolograms

O plugin yTops é compatível com ambos os plugins de hologramas. A configuração é a mesma, independentemente de qual você escolher usar.

HolographicDisplays: Plugin mais antigo e estabelecido, amplamente usado.

DecentHolograms: Plugin mais moderno com melhor performance e recursos adicionais.

Escolha o que melhor se adequa às necessidades do seu servidor.

Nesta página