Como funciona?
Funcionamento do Sistema de Torneios
O sistema de torneios do Cobblemon BattleHUB é integrado ao ecossistema de combates do servidor. Ele gerencia o ciclo de vida completo de uma competição — desde a abertura das inscrições até a coroação do grande campeão — sem que os administradores precisem controlar chaves externas de forma manual.
Como Configurar e Executar um Torneio na Prática
1. Ativação e Preparação do Arquivo
Para liberar um torneio, abra o arquivo JSON correspondente ao seu torneio na pasta do mod e ajuste as seguintes propriedades para true:
tournamentActive: Flag de marcação do perfil. As inscrições e as partidas são controladas pormanualRegistrationOpene pelos comandos abaixo — essa flag não as bloqueia sozinha.manualRegistrationOpen: Abre as inscrições para que os jogadores possam participar.
Alternativa dentro do jogo (1.4+)
Você não precisa editar o arquivo: /bht <tournamentId> set registration on abre as inscrições na hora e /bht <tournamentId> set testmode on liga o modo de teste. As duas mudanças são gravadas no JSON — veja Tournament Commands.
💡 Dica de Testes: Se você estiver apenas testando a mecânica de torneios sozinho ou com poucas pessoas, ative a opção
"testModeNoMinLimit": truepara ignorar a exigência do número mínimo de participantes.
2. Inscrição de Jogadores
- Os jogadores devem abrir a interface do mod pelo comando
/bh, navegar até a aba de Torneios e clicar em se inscrever. - Métodos para Testes de Inscrição:
- Adicionar Bots: Você pode preencher as vagas do torneio automaticamente usando o comando
/bht <Id do Torneio> playerlist fill(Nota: os bots preenchem as vagas na chave, mas não jogam as partidas). - Testes Reduzidos: Você pode definir um limite mínimo no arquivo do torneio para realizar testes com um amigo ou conta secundária:
"maxParticipants": 2, "minParticipants": 2
3. Sortear o Chaveamento (Seeding)
Com as inscrições encerradas, execute o comando de sorteio para gerar as chaves. <id do torneio> é o tournamentId do arquivo de perfil ("default" no que vem por padrão):
/bht <id do torneio> roll
(Exemplo: /bht default roll)
📢 Recomendação: Certifique-se de estar com o Webhook do Discord configurado para receber o painel visual do chaveamento gerado diretamente no seu servidor.
4. Gerenciamento e Convocação de Partidas
Jeito rápido: próxima partida e auto-run (1.4+)
Você não precisa digitar o ID do bloco a cada partida:
/bht startmatchconvoca a próxima partida na ordem do chaveamento./bht <id do torneio> autorun onfaz o servidor convocar as partidas sozinho, uma depois da outra, seguindo a chave (/bht <id do torneio> autorun offpara)./bht phaseslista cada fase e partida com o status, com um [START] clicável nas que podem ser convocadas.
Os jogadores convocados passam exatamente pelos mesmos passos da Opção A abaixo (overlay → Ready → batalha).
Opção A: Iniciar a Partida Oficialmente para os Jogadores
Para convocar os dois competidores de um bloco para a batalha, use o comando:
/bht prep <blockid> <timelimit>
- Exemplo com segundos:
/bht prep default_phase_1_1 15s - Exemplo com minutos:
/bht prep default_phase_1_1 15m
O que acontece a seguir:
- Um overlay aparecerá na tela dos dois jogadores alertando sobre o início da partida e o tempo restante para a preparação.
- Os jogadores devem abrir o menu com
/bh, ir até a aba de Torneios e clicar em Ready (Pronto). - Se a equipe (party) do jogador estiver dentro de todas as regras e restrições configuradas para o torneio, a confirmação será aceita.
- Assim que ambos confirmarem prontidão, a batalha é iniciada automaticamente.
- Ao término do combate, o mod detecta o vencedor de forma autônoma, atualiza a chave e envia o resultado no Discord.
Opção B: Definir um Vencedor Manualmente (Set Win)
Caso ocorra algum imprevisto ou você precise avançar um jogador manualmente, utilize o comando:
/bht setwinner <blockid> <winner>
(Exemplo: /bht setwinner default_phase_1_1 1)
🔍 Onde encontrar o ID dos Blocos?
Jeito mais fácil (1.4+): use /bht phases — ele lista cada bloco com os jogadores e o status — ou aperte Tab depois de /bht startmatch ou /bht setwinner.
Os IDs de cada partida/bloco são gerados e salvos no arquivo tournaments_state.json, localizado no diretório:
config/cobblemon_battlehub/tournaments_state.json
Padronização comum dos IDs dos blocos:
default_phase_1_1(Fase 1 - Bloco 1)default_phase_2_1(Fase 2 - Bloco 1)default_final_1(Final)
O Ciclo de Vida de um Torneio
O fluxo de execução de um torneio passa por estes estados (o enum Status), controlados pelo gerenciador:
[UPCOMING] ➔ [REGISTRATION] ➔ [SEEDING] ➔ [IN_PROGRESS] ➔ [FINISHED]
(/bht <id> cancel devolve para REGISTRATION a qualquer momento.)
1. Inicialização e Perfis (UPCOMING)
O mod carrega todas as definições e regras estruturais dos torneios diretamente da pasta de perfis. O torneio fica em modo de espera, exibindo seus dados de recompensas, data agendada e regras de formato na interface visual dos jogadores.
2. Abertura de Inscrições (REGISTRATION)
Quando o parâmetro manualRegistrationOpen é definido como true (ou ativado via comando), os jogadores ganham acesso para se inscreverem no torneio através da interface in-game.
- O mod limita estritamente as inscrições ao limite máximo definido por
maxParticipants. - Os dados de inscrição de cada participante são salvos associando sua UUID ao seu Nickname no banco de dados.
3. Sorteio de Chaves e Emparelhamento (SEEDING)
Quando o comando /bht <id do torneio> roll é executado, o sistema encerra as inscrições e inicia a montagem da chave de eliminação única (Single Elimination Bracket):
4. Convocação de Partidas (IN_PROGRESS)
Assim que o chaveamento é gerado, o torneio entra em andamento. O sistema de ticks monitora ativamente as partidas e gerencia os combates através de "Blocos de Luta":
- Chamada de Partida: O administrador ou o sistema envia a ordem de início para um bloco. Os dois competidores recebem um alerta global e um temporizador de preparação é iniciado.
- Boss Bar de Transmissão: Uma Boss Bar global é exibida no topo da tela para todos os jogadores online do servidor que não estão lutando, indicando o progresso atual do torneio (ex: "Torneio Mensal - Fase 1").
5. Execução Automática de Batalhas
- Os jogadores convocados devem preparar seu time e clicar em "Pronto" na interface do mod.
- Assim que ambos estiverem prontos (ou se o tempo de preparação for forçado), o mod inicia a partida de Cobblemon instantaneamente usando a Ladder configurada no perfil do torneio (ex:
tourney_solo).
6. Avanço Dinâmico e Finalização (FINISHED)
- Assim que a sessão de batalha termina, o mod intercepta o resultado in-game.
- O vencedor é promovido na chave de forma instantânea para criar o bloco da próxima fase (ex:
_phase_2_1ou_final_1). - O perdedor é eliminado da competição.
- O processo se repete até que reste apenas 1 competidor ativo. Ao declarar o último vencedor, o status é alterado para FINISHED e o nome do campeão é gravado de forma vitalícia no histórico (
lastChampion).
O Mecanismo Anti-W.O. por Tempo de Preparação
Para evitar que jogadores ausentes (AFK) travem o andamento de todo o torneio, o Mod monitora rigorosamente o tempo limite de preparação:
- Cada partida convocada ganha uma data limite em milissegundos.
- Se o cronômetro estourar e um dos competidores não tiver confirmado prontidão, o sistema executa a eliminação automática:
- Se o Player 2 marcou pronto mas o Player 1 não, o Player 2 é declarado vencedor por W.O.
- Em todos os outros casos (só o Player 1 marcou pronto, ou nenhum dos dois marcou), o Player 1 do bloco avança.
- O anúncio da desclassificação é enviado no chat e a chave é atualizada imediatamente no banco de dados.