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.

Estrutura de arquivos

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

Configuração do plugin (config.yml)

O arquivo config.yml contém as configurações principais do sistema de câmbio. Abaixo estão todas as opções disponíveis com explicações detalhadas.

login-delay

Delay em ticks para carregar os dados do jogador após o login. Esta configuração é necessária para sincronização de dados em servidores com BungeeCord/Velocity, especialmente quando o servidor de mina é separado do lobby.

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

Quando ajustar:

• Servidor único (sem BungeeCord): Pode usar valores menores como 5 ou 10
• Rede BungeeCord/Velocity: Mantenha em 20 ou aumente para 40 se houver lag
• Servidor de mina separado: Recomendado 20 ou superior

npc

Sistema de NPC para facilitar o acesso ao menu de câmbio. Os jogadores podem clicar no NPC para abrir o menu sem precisar usar comandos.

# Sistema de npc
npc:
  skin: 'Pitombaa'
  hologram:
    offset: 3.4
    hologram:
      - '&6&lCâmbio'
      - '&7Clique para trocar suas economias.'
      - '[item]EMERALD'

skin

Define a skin que o NPC usará. Você pode usar o nome de qualquer jogador do Minecraft para copiar sua skin.

npc:
  skin: 'Pitombaa'

Exemplos:

skin: 'Notch'          # Usa a skin do Notch
skin: 'Herobrine'      # Usa a skin do Herobrine
skin: 'Steve'          # Usa a skin padrão Steve

hologram

Configuração do holograma exibido acima do NPC.

offset

Define a distância vertical (em blocos) entre o NPC e o holograma. Valores maiores colocam o holograma mais alto.

hologram:
  offset: 3.4

Valores recomendados:

• 2.5 - Holograma mais próximo do NPC
• 3.4 - Altura padrão (recomendado)
• 4.0 - Holograma mais alto, útil para NPCs em áreas movimentadas

hologram (linhas)

Lista de linhas que aparecem no holograma. Suporta cores usando & e itens usando [item]NOME_DO_ITEM.

hologram:
  hologram:
    - '&6&lCâmbio'
    - '&7Clique para trocar suas economias.'
    - '[item]EMERALD'

Exemplo personalizado:

hologram:
  hologram:
    - '&e&l⚡ CÂMBIO ⚡'
    - ''
    - '&7Troque suas moedas aqui!'
    - '&aClique para abrir'
    - ''
    - '[item]GOLD_INGOT'

Como usar o NPC: