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 funcionamento dos eventos. 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 dos eventos 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: ''

login-delay

Delay em ticks para carregar os dados do jogador após o login. Útil quando você usa yEventos em um servidor de mina separado na sua rede BungeeCord/Velocity.

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

Quando usar:

• Servidores com múltiplos mundos que compartilham dados
• Rede BungeeCord/Velocity onde jogadores podem estar em diferentes servidores
• Evita problemas de sincronização de dados ao fazer login

void-detect

Define a altura Y onde o plugin considera que o jogador caiu no void. Usado em eventos presenciais para detectar quando jogadores caem do mapa.

# Altura do void do seu servidor
void-detect: 0

Valores comuns:

• 0 - Padrão do Minecraft
• -64 - Para servidores com mundos personalizados
• 5 - Para eventos em ilhas flutuantes

inventory-cache

Ativa o sistema de cache de inventário quando jogadores entram em eventos que exigem inventário vazio. Se ativado, os itens do jogador são salvos temporariamente.

# Cachear inventário caso o jogador entre com itens no evento (em eventos que exige inventário vazio)
inventory-cache: false

Quando ativar:

• Quando jogadores frequentemente entram em eventos com itens
• Para evitar perda de itens se o servidor crashar durante eventos
• Se quiser dar aos jogadores a opção de recuperar itens pelo menu /eventos

announce-world-blacklist

Lista de mundos onde os jogadores NÃO receberão anúncios de eventos no chat.

# Mundos em que não irá receber anúncios dos eventos
announce-world-blacklist: []

Exemplo de uso:

announce-world-blacklist: ['lobby', 'spawn', 'tutorial']

Útil para evitar spam de anúncios em mundos onde jogadores estão AFK ou em áreas de lobby.

camarote-fly

Permite que jogadores ativem o modo de voo quando estão no camarote assistindo eventos.

# Ativar dar fly no camarote
camarote-fly: false

• true - Jogadores podem voar no camarote
• false - Voo desativado no camarote

calculate-knockback

Define se o plugin deve calcular o knockback (repulsão ao tomar dano) ao invés do Minecraft.

# Calcular o KnockBack (repulsão) pelo próprio plugin
calculate-knockback: false

# Tag que será dada ao TOP 1 de eventos ganhos
tag: '&e[EVENT-MASTER]'

Quando ativar:

• Se estiver tendo problemas com knockback inconsistente em eventos PvP
• Para ter mais controle sobre o combate em eventos como Sumo ou Fight
• Em servidores com muitos plugins que modificam o sistema de combate

tag

Define a tag entregue ao jogador TOP 1 em eventos ganhos.

# Tag que será dada ao TOP 1 de eventos ganhos
tag: '&e[EVENT-MASTER]'

camarote-allowed-commands

Lista de comandos que jogadores podem executar enquanto estão no camarote assistindo eventos.

# Comandos liberados no camarote
camarote-allowed-commands:
  - '/g'
  - '/l'
  - '/.'

Exemplo de uso:

camarote-allowed-commands:
  - '/g'           # Chat global
  - '/l'           # Chat local
  - '/.'           # Chat de clan/faction
  - '/tell'        # Mensagens privadas
  - '/discord'     # Comandos do Discord

Todos os outros comandos serão bloqueados automaticamente enquanto o jogador estiver no camarote.

disabled-events

Lista de eventos que não serão carregados pelo plugin. Use o nome do arquivo do evento sem o .yml.

# Eventos que não serão carregados no plugin
disabled-events: []

Exemplo de uso:

disabled-events:
  - 'sumo'
  - 'fight'
  - 'tntrun'

Com esta configuração, os eventos listados não aparecem nos menus, não podem ser iniciados e não entram no auto-start.

disappear-delay

Delay em ticks para blocos desaparecerem em eventos como TNTRun ou Spleef.

# Delay de desaparecimento de blocos da arena (TNTRUN ou similar)
# em ticks (20t = 1s)
disappear-delay: 8

Valores recomendados:

• 8 - Padrão, equilibrado
• 5 - Mais difícil, blocos desaparecem mais rápido
• 15 - Mais fácil, blocos desaparecem mais devagar

ip-limit

Limite de jogadores simultâneos do mesmo IP em eventos com participantes.

# Limite de jogadores simultaneos por IP nos eventos com participantes.
ip-limit:
  # Ativar a limitacao
  enabled: true
  # Quantos jogadores do mesmo IP podem participar do mesmo evento
  max-players: 1

Use para evitar que múltiplas contas do mesmo IP participem do mesmo evento ao mesmo tempo.

proxy

Sistema de anúncios na proxy (BungeeCord/Velocity) para divulgar eventos em múltiplos servidores da sua rede.

# Sistema de anúncios na proxy
proxy:
  # Ativar o sistema
  enabled: true
  # Whitelist de servidores que irão receber os anúncios
  server-whitelist: [ 'mina' ]
  # Nome deste servidor na proxy (evita anúncio duplicado)
  server-name: 'survival1'

Como funciona:

Quando enabled: true, os anúncios de eventos serão enviados para os servidores listados em server-whitelist. Jogadores em outros servidores receberão mensagens no chat sobre eventos acontecendo.

O campo server-name deve conter o nome exato deste servidor na proxy. Quando configurado, o plugin ignora os anúncios recebidos da proxy para este próprio servidor, evitando que a mensagem apareça duplicada.

Exemplo de uso:

proxy:
  enabled: true
  server-whitelist: [ 'lobby', 'survival', 'mina', 'pvp' ]
  server-name: 'survival1'

auto-start

Sistema de inicialização automática de eventos em horários programados.

# Autostart dos eventos
auto-start:
  schedule1:
    # nome do arquivo do evento sem o ".yml"
    # deixe 'random' para iniciar um aleatório
    type: 'fastclick'
    # todos, segunda, terca, quarta, quinta, sexta, sabado, domingo
    # dia-hora:minuto:segundo
    schedule: [ 'todos-00:00:01' ]

Dias disponíveis:

• todos - Todos os dias da semana
• segunda, terca, quarta, quinta, sexta, sabado, domingo

Exemplo de uso:

auto-start:
  schedule1:
    type: 'parkour'
    schedule: [ 'todos-12:00:00', 'todos-18:00:00', 'todos-22:00:00' ]
  schedule2:
    type: 'sumo'
    schedule: [ 'sabado-15:00:00', 'domingo-15:00:00' ]
  schedule3:
    type: 'fastclick'
    schedule: [ 'segunda-10:00:00', 'quarta-10:00:00', 'sexta-10:00:00' ]

auto-start-random-blacklist

Lista de eventos que não serão incluídos quando você usar type: 'random' no auto-start. Útil para excluir eventos que você não quer que iniciem automaticamente de forma aleatória.

# Eventos excluídos do random auto-start
auto-start-random-blacklist: []

Como funciona:

• Quando você configura type: 'random' no auto-start, o plugin escolhe um evento aleatoriamente a cada horário programado
• Eventos listados nesta blacklist serão ignorados e nunca selecionados pelo random
• Você pode usar isso para evitar eventos que requerem setup ou não são adequados para auto-start

Exemplo de uso:

auto-start:
  schedule1:
    type: 'random'
    schedule: [ 'todos-12:00:00', 'todos-18:00:00' ]

auto-start-random-blacklist:
  - 'dropper'      # Exclui dropper do random
  - 'parkour'      # Exclui parkour do random
  - 'voting'       # Exclui voting do random

Com esta configuração:

• A cada 12:00 e 18:00, um evento aleatório será iniciado
• Dropper, Parkour e Voting nunca serão escolhidos
• Apenas os outros eventos configurados poderão ser iniciados

Dicas de uso:

# Excluir eventos que requerem muita staff
auto-start-random-blacklist:
  - 'sumo'         # Requer moderação
  - 'fight'        # Requer moderação
  - 'parkour'      # Requer área grande

# Ou excluir eventos de chat apenas (deixando eventos presenciais)
auto-start-random-blacklist:
  - 'quiz'
  - 'lottery'
  - 'math'
  - 'phrase'
  - 'unscramble'

wand

Configuração do item usado como varinha de seleção de área para configurar eventos presenciais.

# Configuração do item da varinha
wand:
  material: 'GOLD_AXE'
  name: '&eSeleção de Área'
  lore: [ '&7Evento: &f{event}', '', '&aEsquerdo -> POS1', '&aDireito -> POS2' ]

Como usar:

1. Execute /[evento] wand para receber a varinha
2. Clique com o botão esquerdo para definir a primeira posição (POS1)
3. Clique com o botão direito para definir a segunda posição (POS2)
4. Execute /[evento] define para definir a área do evento

Personalização:

wand:
  material: 'BLAZE_ROD'
  name: '&6✦ &eVarinha Mágica &6✦'
  lore: 
    - '&7Evento: &f{event}'
    - ''
    - '&e▸ &aBotão Esquerdo &7→ Posição 1'
    - '&e▸ &aBotão Direito &7→ Posição 2'
    - ''
    - '&7Use &f/[evento] define &7para confirmar'

# Formatos de status
# Para a placeholder %yeventos_status%
status-format:
  none: ''
  watching: '&cAssistindo'
  waiting: '&eAguardando'
  playing: '&aJogando'

Dicas de configuração