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 é o coração do plugin, onde você controla todos os aspectos do sistema de Mito. 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

database

Define como e onde os dados do sistema de Mito 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: ''

general

Configurações gerais do sistema de Mito. Aqui você controla como funciona a mecânica de ganhar e perder a tag de Mito.

general:
  # Tag do Mito
  tag: '&5[MITO]'
  # Ativar abrir o menu ao digitar /mito
  mito-menu: true
  # Ativar o sistema de perder mito por inatividade
  lose: true
  # Tempo inativo no servidor para perder o Mito
  # em segundos
  time-lose: 30
  # Perder o mito por tempo apenas se tiver outro jogador on
  lose-has-player: true
  # Tempo que o jogador pode morrer sem perder a tag após recebê-la
  # em segundos
  cooldown-lose-death: 30

Como funciona o sistema:

• tag: Define a tag visual que será exibida no mito. Suporta códigos de cor (&).
• mito-menu: Se true, o comando /mito abre o menu. Se false, exibe mensagens de ajuda.
• lose: Ativa o sistema de perder a tag por inatividade (ficar offline).
• time-lose: Tempo em segundos que o mito pode ficar offline antes de perder a tag (30 = 30 segundos).
• lose-has-player: Se true, só perde a tag se houver outro jogador online para recebê-la.
• cooldown-lose-death: Proteção inicial em segundos após receber a tag. Durante este período, o jogador pode morrer sem perder o status de mito.

Exemplo de configuração equilibrada:

general:
  tag: '&6&l[LENDA]'
  mito-menu: true
  lose: true
  time-lose: 300        # 5 minutos offline
  lose-has-player: true
  cooldown-lose-death: 60  # 1 minuto de proteção

effect

Sistema de efeitos visuais e sonoros que são aplicados quando um jogador se torna o novo Mito. Cria uma experiência épica e memorável para o momento.

effect:
  # Soltar efeito de raio no novo mito
  strike-lightning: true
  # Spawnar morcegos ao redor do novo mito
  spawn-bats: true
  # Tocar som no novo mito
  sound: 'ENDERDRAGON_GROWL'

Opções disponíveis:

• strike-lightning: Cria um efeito visual de raio no jogador (não causa dano).
• spawn-bats: Spawna morcegos temporários ao redor do jogador para um efeito dramático.
• sound: Toca um som específico. Sons válidos dependem da versão do Minecraft.

Sons populares para diferentes versões:

# Minecraft 1.8-1.12
sound: 'ENDERDRAGON_GROWL'
sound: 'WITHER_SPAWN'
sound: 'LEVEL_UP'

# Minecraft 1.13+
sound: 'ENTITY_ENDER_DRAGON_GROWL'
sound: 'ENTITY_WITHER_SPAWN'
sound: 'ENTITY_PLAYER_LEVELUP'

rewards

Sistema de recompensas dadas ao jogador que mata o Mito atual. As recompensas incentivam o PvP e a disputa pela tag.

# Recompensas por matar o mito
rewards:
  amount: 1
  list:
    - '100.0,give {player} diamond 1'

Como funciona:

• amount: Quantas recompensas da lista serão sorteadas e dadas ao jogador.
• list: Lista de recompensas no formato chance,comando
  • chance: Porcentagem de 0.0 a 100.0 (100.0 = sempre dará)
  • comando: Comando a ser executado (use {player} para o nome do jogador)

Exemplo com múltiplas recompensas:

rewards:
  amount: 2
  list:
    - '100.0,give {player} diamond 5'
    - '100.0,eco give {player} 1000'
    - '50.0,give {player} golden_apple 3'
    - '25.0,give {player} nether_star 1'

Neste exemplo, o jogador receberá 2 recompensas sorteadas da lista, sendo que diamantes e dinheiro sempre serão dados (100%), enquanto maçãs douradas têm 50% de chance e estrela do nether 25%.

commands

Lista de comandos executados automaticamente quando há mudança de Mito. Útil para dar recompensas, notificar staff ou executar ações customizadas.

# Comandos executados no mito
commands:
  - 'give {new} diamond 1'
  - 'give {old} stone 1'

Placeholders disponíveis:

• {new}: Nome do jogador que se tornou o novo Mito
• {old}: Nome do jogador que era o Mito anterior (se houver)
• {player}: Nome do jogador (contexto dependente)

Exemplos práticos:

commands:
  # Dar itens ao novo mito
  - 'give {new} diamond_sword 1'
  - 'give {new} golden_apple 5'
  
  # Dar dinheiro
  - 'eco give {new} 5000'
  
  # Anunciar no servidor
  - 'broadcast &6{new} é o novo MITO do servidor!'
  
  # Consolar o antigo mito
  - 'eco give {old} 1000'
  - 'tell {old} &cVocê perdeu a tag, mas ganhou uma consolação!'
  
  # Executar comando customizado
  - 'lp user {new} permission set mito.vip true'

npc

Configurações do NPC visual que representa o Mito atual no mundo. Jogadores podem usar /mito setnpc para posicionar o NPC.

# Configurações do npc
npc:
  # Altura do holograma
  off-set: 3.1
  hologram:
    - '&c&lMITO'
    - '&7Mito Atual &c{player}&7.'

Opções disponíveis:

• off-set: Altura em blocos acima do NPC onde o holograma será exibido.
• hologram: Lista de linhas de texto que aparecerão sobre o NPC.

Placeholder disponível:

• {player}: Nome do jogador que é o Mito atual

Exemplo de holograma customizado:

npc:
  off-set: 3.5
  hologram:
    - '&6&l⚔ LENDA VIVA ⚔'
    - ''
    - '&fJogador: &e{player}'
    - '&7Mate-o para se tornar o próximo!'
    - ''
    - '&cClique para ver informações'