LogoyStore
yTops

Configuração

Conheça as várias opções de configuração.

O plugin deve funcionar sem necessidade de configuração adicional, mas se você precisar alterar o comportamento do plugin, você está no lugar certo.

Após alterar a configuração, é necessário reiniciar o servidor.

Estrutura de arquivos

Abaixo está um exemplo de como é a estrutura de arquivos do plugin. Clique em uma pasta para expandi-la.

armorstands.yml
commands.yml
config.yml
holograms.yml
menus.yml
messages.yml
npcs.yml
rewards.yml
top_rewards.yml

Configuração do plugin (config.yml)

O arquivo config.yml é o coração do plugin, onde você controla todos os aspectos do funcionamento dos rankings. Abaixo estão todas as opções disponíveis com explicações detalhadas.

debug-mode

Ativa ou desativa o modo de depuração. Quando ativado, o plugin registrará informações detalhadas no console para ajudar a identificar problemas.

# Determina o funcionamento da depuração. Valores válidos: [false, true]
debug-mode: false

Mantenha desativado em produção, pois pode gerar muitos logs e afetar a performance.

database

Define como e onde os dados dos tops serão armazenados. O plugin suporta três tipos de armazenamento:

  • SQLITE: Armazena dados em um arquivo local. Ideal para servidores pequenos.
  • MYSQL: Conecta a um servidor MySQL externo. Recomendado para servidores médios.
  • HIKARI: Usa pool de conexões para MySQL. Recomendado para servidores grandes por melhor performance.
database:
  # Determina o tipo de banco de dados. Valores válidos: [SQLITE, MYSQL, HIKARI (recomendado)]
  storage-type: SQLITE

  # Dados para conexão ao banco de dados MYSQL.
  data:
    # Endereço de conexão do banco de dados. [EX: 127.0.0.1]
    host: localhost
    # Porta de conexão do banco de dados. [EX: 3306]
    port: 3306
    # Nome do banco de dados a ser conectado. [EX: minecraft]
    database: ''
    # Usuário de conexão. [EX: root]
    username: ''
    # Senha do usuário de conexão: [EX: 123]
    password: ''

Se usar SQLITE, não precisa preencher os dados de conexão. O arquivo será criado automaticamente em plugins/yTops/data.db.

login-delay

Define o atraso (em ticks) para carregar os dados do jogador após o login. Útil em redes BungeeCord/Velocity onde os jogadores são enviados para servidores de mina separados.

# Delay para carregar os dados depois do login
# Necessário para usar em servidor de mina separado
# Recomendado: 20 ticks (1 segundo)
login-delay: 20

Quando ajustar:

  • Servidores standalone: 0-10 ticks
  • Redes BungeeCord/Velocity: 20-40 ticks
  • Se players não recebem recompensas ao logar: aumente este valor

limit

Sistema de limitação para coleta de recompensas em massa. Previne lag e crashes ao recolher muitas recompensas de uma vez.

limit:
  enabled: true
  # Máximo que irá recolher por vez
  max: 1000

Desativar ou aumentar muito este limite pode causar lag severo ou até crashar o servidor quando jogadores tiverem muitas recompensas acumuladas.

Valores recomendados:

  • Servidores pequenos (até 50 players): 500-1000
  • Servidores médios (50-200 players): 1000
  • Servidores grandes (200+ players): 500-800

right-delete-reward

Permite que jogadores deletem recompensas clicando com o botão direito no menu.

# Deletar a recompensa ao clicar com botão direito
right-delete-reward: true
  • true - Jogadores podem deletar recompensas (útil para limpar itens indesejados)
  • false - Jogadores só podem coletar (recomendado se recompensas forem valiosas)

top-list-tick

Intervalo de atualização (em segundos) dos rankings. Define com que frequência o plugin recalcula as posições dos jogadores.

# Tempo para atualizar a lista de tops
# em segundos
top-list-tick: 1800

Como funciona:

  • O plugin recalcula os tops a cada 1800 segundos (30 minutos)
  • Valores menores = rankings mais atualizados, mas maior uso de CPU
  • Valores maiores = menos uso de CPU, mas rankings menos precisos

Valores recomendados:

  • Servidores competitivos: 600-1200 segundos (10-20 minutos)
  • Servidores casuais: 1800-3600 segundos (30-60 minutos)
  • Servidores grandes: 3600+ segundos (1+ hora)

Se seu servidor tem muitos jogadores e você nota lag nos horários de pico, aumente este valor.

top-entity-tick

Intervalo de atualização (em segundos) das entidades (NPCs e ArmorStands). Define com que frequência as entidades são atualizadas com novos dados.

# Tempo para atualizar as entidades
# em segundos
top-entity-tick: 1810

Este valor deve ser ligeiramente maior que top-list-tick para garantir que os dados já foram atualizados antes de aplicar nas entidades.

Relação recomendada:

top-list-tick: 1800
top-entity-tick: 1810  # 10 segundos depois

look-close

Faz com que NPCs girem a cabeça para olhar para o jogador mais próximo.

# Ativar o NPC ficar olhando pro player
look-close: true

Este recurso funciona apenas com NPCs do Citizens, não afeta ArmorStands ou Hologramas.

top-menu

Configurações do menu de visualização dos tops acessado via /tops.

top-menu:
  # Intervalo de atualização do menu em segundos
  time: 600
  # Formato de exibição do nome do jogador
  player-format: '%ytopspapiaddon_luckperms_prefix% {player}'

player-format explicado:

Este formato define como os nomes dos jogadores aparecem no menu. Suporta placeholders do PlaceholderAPI.

Exemplos de uso:

# Com prefixo do LuckPerms
player-format: '%ytopspapiaddon_luckperms_prefix% {player}'

# Simples (apenas nome)
player-format: '{player}'

# Com prefixo e sufixo
player-format: '%ytopspapiaddon_luckperms_prefix% {player} %ytopspapiaddon_luckperms_suffix%'

# Com tag da faction
player-format: '[%simpleclans_tag_label%] {player}'

Para usar placeholders do PlaceholderAPI, você precisa ter o PlaceholderAPI e o yTopsPAPIAddon instalados.

top-message

Sistema de mensagens automáticas anunciando os jogadores do top. As mensagens são enviadas periodicamente no chat.

top-message:
  enable: true
  # Intervalo entre anúncios em segundos
  time: 600
  # Formato de exibição do nome do jogador nas mensagens
  player-format: '%ytopspapiaddon_luckperms_prefix% {player}'
  # Mensagem que será enviada
  message: |

    &aVeja os jogadores que se destacam no servidor!
    &7(Clique na mensagem para acessar o TOP escolhido)

    <click:run_command:/money top><hover:show_text:"<green>Clique para acessar o TOP</green>"><dark_gray>-></dark_gray> <green>{player_VAULT}</green> <dark_gray>-</dark_gray> <dark_green>$</dark_green><white>{value_VAULT_formatted}</white></hover></click>

Componentes da configuração:

  • enable: Ativa/desativa o sistema de mensagens automáticas
  • time: Intervalo em segundos entre cada anúncio (600 = 10 minutos)
  • player-format: Como os nomes dos jogadores são exibidos
  • message: Conteúdo da mensagem (suporta múltiplas linhas)

Placeholders especiais disponíveis:

PlaceholderDescriçãoExemplo
{player_<TYPE>}Nome do 1º colocado do tipo especificado{player_VAULT}
{value_<TYPE>_formatted}Valor formatado do 1º colocado{value_VAULT_formatted}
{value_<TYPE>_time}Tempo formatado (para tops de tempo){value_YTEMPOONLINE_TEMPO_time}
{value_<TYPE>_kdr}KDR formatado (para tops de KDR){value_YKILLSYSTEM_KDR_kdr}

Componentes interativos:

A mensagem suporta componentes interativos modernos do Minecraft:

# Clique para executar comando
<click:run_command:/comando><texto clicável></click>

# Hover para mostrar texto
<hover:show_text:"<green>Texto ao passar o mouse</green>"><texto></hover>

# Combinado
<click:run_command:/tops><hover:show_text:"<green>Ver todos os tops</green>">Clique aqui!</hover></click>

Exemplo de mensagem personalizada:

message: |

  &6&l⚡ TOP JOGADORES DO SERVIDOR ⚡
  
  &e💰 TOP Money: <click:run_command:/tops><hover:show_text:"<gold>Clique para ver</gold>"><green>{player_VAULT}</green> <gray>-</gray> <yellow>${value_VAULT_formatted}</yellow></hover></click>
  &c⚔ TOP Kills: <click:run_command:/tops><hover:show_text:"<gold>Clique para ver</gold>"><red>{player_YKILLSYSTEM_KILLS}</red> <gray>-</gray> <white>{value_YKILLSYSTEM_KILLS_formatted} kills</white></hover></click>
  &b⏰ TOP Tempo: <click:run_command:/tops><hover:show_text:"<gold>Clique para ver</gold>"><aqua>{player_YTEMPOONLINE_TEMPO}</aqua> <gray>-</gray> <white>{value_YTEMPOONLINE_TEMPO_time}</white></hover></click>
  
  &7Clique em qualquer linha para abrir o menu de tops!

Você pode incluir quantos tipos de top quiser na mensagem. Veja todos os tipos disponíveis na página de Placeholders.

Desativando mensagens automáticas:

Se não quiser anúncios automáticos, apenas desative:

top-message:
  enable: false

Placeholders

Lista de placeholders do plugin.

Comandos

Personalize os comandos do plugin.

Nesta página

Estrutura de arquivosConfiguração do plugin (config.yml)debug-modedatabaselogin-delaylimitright-delete-rewardtop-list-ticktop-entity-ticklook-closetop-menutop-message