Configuração

O arquivo config.yml reúne as opções gerais do yDragon. Os atributos, as habilidades, os horários e os grupos de recompensa de cada dragão ficam em arquivos individuais na pasta dragons/.

Antes de iniciar um evento, defina a arena e o ponto de spawn de cada dragão com /dragon setarena <dragão> [raio] e /dragon setspawn <dragão>. Consulte os comandos e permissões.

Estrutura de arquivos

Abaixo está a estrutura dos arquivos de configuração do plugin. Clique em uma pasta para expandi-la.

commands.yml

config.yml

economies.yml

menus.yml

messages.yml

rewards.yml

ender.yml

nightmare.yml

Arquivo ou pasta	Finalidade
`config.yml`	Banco de dados, Redis, status, arena padrão e mecânicas gerais.
commands.yml	Comando principal e aliases.
economies.yml	Economia padrão e provedores usados nas recompensas.
menus.yml	Lista de dragões, ranking, armazém e preview de recompensas.
messages.yml	Textos de chat, actionbar e títulos.
rewards.yml	Catálogo global de recompensas.
dragons/	Tipos de dragão, combate, agendamento e distribuição de recompensas.

As posições definidas pelos comandos de arena e spawn são salvas pelo plugin no arquivo data.yml, separadas pelo ID de cada dragão.

Configuração do plugin (config.yml)

debug-mode

Ativa o modo de depuração para auxiliar na identificação de problemas no plugin.

# Modo de depuração para correção de problemas no plugin.
debug-mode: false

database

Define o tipo de armazenamento dos dados do plugin:

SQLITE: utiliza armazenamento local.
MYSQL: utiliza uma conexão com um banco MySQL.
HIKARI: utiliza um pool de conexões para MySQL e é a opção recomendada nos comentários da configuração.

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: ''

Ao escolher MYSQL ou HIKARI, preencha database.data com o endereço, a porta, o nome do banco, o usuário e a senha da sua conexão. Para SQLITE, os campos de conexão MySQL não são utilizados.

redis

Configura a conexão com o servidor Redis. Por padrão, ela fica desativada. Para utilizá-la, ative enabled e preencha os dados de conexão.

# Configurações do servidor redis
redis:
  # Ativar a conexão com o redis
  enabled: false
  # Endereço de conexão. [EX: 127.0.0.1]
  host: 'localhost'
  # Porta de conexão do Redis.
  port: 6379
  # Usuário de conexão. [EX: root]
  username: ''
  # Senha do usuário de conexão: [EX: 123]
  password: ''

Tempo de espera, em ticks, para carregar os dados do jogador após o login. O arquivo recomenda 20 ticks para uso com servidor de mina separado.

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

limit

Controla quantas unidades de recompensa podem ser recolhidas do armazém por clique. Com os valores padrão, o limite está ativo e permite recolher até 1000 unidades por vez.

# Este limite serve para recolher recompensas do armazém.
# Desativar ou aumentar o limite pode gerar lag.
limit:
  # Se true, limita quantas recompensas são recolhidas por clique.
  enabled: true
  # Máximo que irá recolher por vez. [EX: 1000]
  max: 1000

Uma unidade armazenada representa uma recompensa do catálogo. A quantidade de itens entregue por unidade é definida em rewards.<id>.item.amount no arquivo rewards.yml.

status

Personaliza os textos exibidos nos menus, nas mensagens e nos placeholders. Essa seção altera a apresentação dos estados, dos modos de spawn e dos grupos de recompensa.

# Textos de status exibidos em menus, mensagens e placeholders.
status:
  # Evento sem dragão spawnado
  waiting: '&eAguardando'
  # Evento com dragão vivo
  fighting: '&aEm andamento'
  # Dragão específico em combate (/dragon info)
  combat: '&cEm combate'
  # Dragão habilitado/desabilitado
  enabled: '&aAtivo'
  disabled: '&cInativo'
  # Sim/não (raro, vivo, etc.)
  yes: '&asim'
  no: '&cnao'
  # Spawn sem horário automático
  manual: '&7Manual'
  # Formato do próximo spawn no menu. Placeholders: {name} {time}
  next-format: '{name} &8— &7{time}'
  # Nomes dos modos de spawn
  spawn-interval: '&fIntervalo'
  spawn-daily: '&fDiário'
  spawn-schedule: '&fHorários'
  spawn-manual: '&7Manual'
  # Nomes dos grupos de ranking/recompensa
  rank-top1: '&eTop 1'
  rank-top2: '&7Top 2'
  rank-top3: '&6Top 3'
  rank-participation: '&fParticipação'

waiting, fighting e combat identificam a situação do evento ou do dragão consultado.
enabled e disabled representam o estado de habilitação do dragão.
yes e no também são usados por %ydragon_alive%; o retorno segue esses textos configurados.
manual é exibido quando não há previsão automática de spawn.
next-format combina o nome do próximo dragão em {name} com o tempo restante em {time}.
spawn-* define os nomes visíveis dos modos de spawn.
rank-* define o nome do grupo mostrado em {rank} no preview de recompensas.

general

Spawn, partículas e contabilização de dano

Estas opções controlam as condições gerais dos eventos. Os horários de cada dragão são definidos em spawn no respectivo arquivo da pasta dragons/.

# Sistemas gerais
general:
  # Distância (blocos) para envio de partículas via PacketEvents
  view-distance: 48
  # Jogadores mínimos online no mundo da arena para o spawn automático ocorrer
  min-players: 1
  # Se true, tenta spawnar um dragão ao ligar o servidor (ainda respeita min-players)
  spawn-on-enable: false
  # Segundos de contagem regressiva global antes do spawn automático
  countdown-seconds: 30
  # Chance (%) de substituir o dragão agendado por um dragão raro
  rare-chance: 5.0
  # Delay mínimo (ms) entre hits contabilizados no ranking (anti-lag)
  hit-delay-ms: 150
  # Deletar a recompensa do armazém ao clicar com botão direito
  right-delete-reward: true

Opção	Funcionamento com o valor padrão
`view-distance`	Envia partículas para jogadores próximos, em até 48 blocos.
`min-players`	Exige ao menos um jogador online no mundo da arena para o spawn automático.
`spawn-on-enable`	Não tenta iniciar um dragão ao ligar o servidor.
`countdown-seconds`	Anuncia uma contagem regressiva de 30 segundos antes do spawn automático.
`rare-chance`	Usa 5% de chance para substituir o dragão agendado por um raro.
`hit-delay-ms`	Aplica um intervalo mínimo de 150 milissegundos entre hits contabilizados no ranking.
`right-delete-reward`	Permite excluir recompensas armazenadas com o botão direito.

O nightmare.yml já possui rare: true, enquanto o ender.yml possui rare: false. A raridade é definida por dragão e a chance de substituição é definida globalmente por general.rare-chance.

arena

Define o raio padrão e o controle de saída da área de batalha. O centro e o ponto de spawn são individuais por dragão e devem ser definidos pelos comandos administrativos.

general:
  # Arena padrão (pode ser redefinida com /dragon setarena)
  arena:
    # Raio da área de batalha em blocos
    radius: 80
    # Teleporta o jogador de volta se sair da arena durante o evento
    keep-players: true
    # Teleporta o dragão de volta se sair da arena
    keep-dragon: true

Exemplo de uso: /dragon setarena ender utiliza o raio padrão de 80 blocos. Já /dragon setarena nightmare 100 salva um raio de 100 blocos para o Nightmare Dragon.

Com keep-players e keep-dragon ativados, jogadores e dragão são teleportados de volta ao sair da área durante o evento.

mechanics

Controla as mecânicas de camas, âncoras, cristais e destruição de blocos.

general:
  # Mecânicas / anti-exploit
  mechanics:
    # Desativa explosão de camas na arena durante o evento
    disable-bed-damage: true
    # Desativa âncoras de respawn na arena durante o evento
    disable-anchor-damage: true
    # Impede colocar cristais do end na arena
    block-crystal-place: true
    # Cancela spawn vanilla de Ender Dragon (cristais / portal)
    block-vanilla-respawn: true
    # Se false, cristais não causam dano no dragão do evento
    allow-crystal-damage: false
    # Impede o dragão de quebrar blocos
    prevent-block-destroy: true

block-crystal-place controla a colocação de cristais na arena, enquanto allow-crystal-damage controla se os cristais podem causar dano no dragão do evento. Já block-vanilla-respawn cancela o reaparecimento vanilla por cristais e portal.

progress-bar

Define a barra visual de vida usada em {bar} na actionbar da batalha.

general:
  progress-bar:
    # Símbolo e cor da parte preenchida.
    filled: '&5|'
    # Símbolo e cor da parte vazia.
    empty: '&7|'
    # Quantidade de segmentos da barra.
    length: 20

Com length: 20, a barra possui 20 segmentos. A parte preenchida acompanha a proporção da vida restante do dragão. O texto que acompanha a barra é configurado em messages.yml → actionbar.fight.

sounds

Define os sons para spawn, morte, uso de habilidades, vitória e falha.

general:
  # Sons utilizados pelo plugin.
  sounds:
    spawn: 'ENTITY_ENDERDRAGON_GROWL'
    death: 'ENTITY_ENDERDRAGON_DEATH'
    ability: 'ENTITY_ENDERDRAGON_SHOOT'
    win: 'ENTITY_PLAYER_LEVELUP'
    fail: 'ENTITY_VILLAGER_NO'

As habilidades também podem ter um som próprio no campo sound de cada definição em dragons/<id>.yml.

Aplicando as alterações

Use /dragon reload para recarregar os YAMLs, os tipos de dragão, o catálogo de recompensas e as definições dos menus. Após alterar o comando principal ou seus aliases em commands.yml, reinicie o servidor para aplicar o registro dos comandos.

Nesta página