NPCs

Exemplo completo de configuração

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

npc:
  money:
    top-type: 'VAULT'
    click-command: ''
    # CLICK-COMMAND: comando ao clicar com o botão direito no NPC
    # Placeholders: {player}, {index}, {top_player}, {value}, {value_formatted}
    # Use [console] no início para executar como console
    hologram:
      offset: 3.1
      lines: [ '&a&lTOP {index}', '&fJogador: &7{player}', '&fDinheiro: &a{value_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 NPC deve ter um identificador único (ex: money, kills, etc.).

Exemplo:

npc:
  money:
    top-type: 'VAULT'

top-type

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

Exemplo:

top-type: 'VAULT'

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

hologram

Configuração do holograma que aparece acima do NPC.

offset

Define a altura do holograma em relação ao NPC.

Exemplo:

hologram:
  offset: 3.1

O valor padrão recomendado é 3.1, mas você pode ajustar conforme necessário para diferentes modelos de NPC.

lines

Define as linhas do holograma. Suporta placeholders e códigos de cor.

Exemplo:

hologram:
  lines: 
    - '&a&lTOP {index}'
    - '&fJogador: &7{player}'
    - '&fDinheiro: &a{value_formatted}'

Placeholders disponíveis:

{index} - Posição do top
{player} - Nome do jogador naquela posição
{value} - Valor bruto
{value_formatted} - Valor formatado
{value_time} - Tempo formatado
{value_kdr} - KDR (se aplicável)

Criando seu primeiro NPC de Top

Instale o Citizens

Certifique-se de ter o plugin Citizens instalado no servidor.

Crie um NPC

Use o comando do Citizens para criar um NPC:

/npc create <nome>

Configure no arquivo

Adicione a configuração do NPC no arquivo npcs.yml:

npc:
  meu_top:
    top-type: 'VAULT'
    hologram:
      offset: 3.1
      lines: 
        - '&e&lTOP {index} - MONEY'
        - '&7{player}'
        - '&a$ {value_formatted}'

Defina a localização

Posicione-se onde está o NPC e use o comando:

/topentity set <tipo> NPC <index>

Por exemplo, para definir o 1º lugar do top de money:

/topentity set money NPC 1

Reinicie ou recarregue

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

Exemplos de configurações

Top de Kills

npc:
  kills:
    top-type: 'YKILLSYSTEM_KILLS'
    hologram:
      offset: 3.1
      lines: 
        - '&c&lTOP {index} - KILLS'
        - '&f{player}'
        - '&c{value_formatted} abates'

Top de Tempo Online

npc:
  tempo_online:
    top-type: 'YTEMPOONLINE_TEMPO'
    hologram:
      offset: 3.1
      lines: 
        - '&b&lTOP {index} - TEMPO ONLINE'
        - '&f{player}'
        - '&b{value_time}'

Top de McMMO

npc:
  mcmmo:
    top-type: 'MCMMO_TODOS'
    hologram:
      offset: 3.1
      lines: 
        - '&6&lTOP {index} - MCMMO'
        - '&f{player}'
        - '&6Level {value_formatted}'

Dicas e truques

Skin do NPC: Use o comando /npc skin <nome> do Citizens para mudar a skin do NPC e representar o jogador no top.

Look Close: A configuração look-close no arquivo config.yml faz com que o NPC olhe para o jogador mais próximo.

Certifique-se de que o Citizens está carregado antes do yTops. Se houver problemas, ajuste a ordem de carregamento no arquivo bukkit.yml.

Gerenciando NPCs de Top

Listar NPCs definidos

Use o comando:

/topentity list

Deletar um NPC de Top

Posicione-se no NPC e use:

/topentity delete <tipo> NPC <index>

Atualizar configuração

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

/ytops reload

Os NPCs são atualizados automaticamente conforme configurado em top-entity-tick no arquivo config.yml.

Nesta página