Tournament Examples
Exemplo e Configuração de Torneios
O sistema do Cobblemon BattleHUB permite que você crie múltiplos perfis de torneios independentes dentro do servidor. Cada torneio é definido por um arquivo .json individual e possui suas próprias regras, limites de participantes, formato de batalha (Ladder) e descrição visual.
Guia Prático de Criação e Execução de Torneios
Siga este fluxo rápido para criar e lançar um novo evento no seu servidor Minecraft:
Passo 1: Crie o Arquivo de Perfil
Vá até a pasta /tournaments/ e crie um arquivo com a extensão .json (ex: copa_mensal.json). Cole a estrutura padrão de exemplo e altere os campos com as informações do seu evento.
Passo 2: Recarregue os Torneios no Servidor
Com o arquivo salvo, sincronize todos os dados executando o seguinte comando in-game ou no console:
/bhubtournament reload
Passo 3: Abra as Inscrições
Altere o campo "manualRegistrationOpen" para true no arquivo JSON e dê /bhubtournament reload, ou use a interface administrativa in-game para liberar o botão de inscrição para a comunidade. Sem mexer no arquivo (1.4+): /bhubtournament <ID_do_Torneio> set registration on abre as inscrições na hora e grava a mudança no JSON.
Passo 4: Sorteie a Tabela e Inicie o Evento
Assim que o limite de participantes for preenchido (ou no horário agendado com os jogadores online), execute o comando para travar as inscrições e gerar a árvore de eSports:
/bhubtournament <ID_do_Torneio> roll
(Neste momento, o mod gerará a chave de brackets, enviará a tabela inicial ao Discord e colocará as primeiras lutas da Fase 1 em estado de espera).
Caminho do Diretório de Perfis
config/cobblemon_battlehub/tournaments/
Modelo de Configuração Real
Na primeira inicialização, o mod gera automaticamente um perfil de teste de exemplo chamado tournament_ex.json. Abaixo está a estrutura completa para você usar como base de criação:
{
"tournamentId": "weekly_cup_ou",
"name": "Copa Semanal BattleHUB",
"description": "O clássico torneio de eSports 6v6 no formato OverUsed (OU)! Prepare a sua melhor equipa, elabore as suas estratégias de switch e prove que você é o mestre das arenas.",
"tournamentActive": true,
"manualRegistrationOpen": false,
"maxParticipants": 16,
"minParticipants": 4,
"testModeNoMinLimit": false,
"ladderName": "Singles OverUsed (OU)",
"ladderId": "tourney_solo",
"dateText": "Sábado, 18 de Julho às 19:00",
"rewardsText": "1.500 Moedas + Shiny Tinkaton com 6 IVs Perfeitos",
"showChampion": true,
"lastChampion": "F4xizzz"
}
Explicação Detalhada dos Parâmetros
1. Identificação Técnica
tournamentId(Padrão: "default"):
O ID técnico e único do torneio. Ele é utilizado internamente no banco de dados para salvar os estados e no comando de gerenciamento administrativo (ex:/bhubtournament <tournamentId> roll). Use letras minúsculas, números e underlines.
2. Informações Visuais
name: O título amigável e estilizado que aparece destacado para todos os jogadores na interface de torneios.description: A sinopse ou regras gerais que explicam o formato do torneio na interface do jogador.dateText: Texto informativo indicando a data e horário agendados para a competição (ex: "Sábado, 18 de Julho às 19:00").rewardsText: Texto de exibição destacando o prêmio reservado para quem alcançar a primeira colocação.
3. Mecânicas de Inscrição e Lógica
tournamentActive(true/false):
Flag de marcação do perfil (editável in-game comset active on|off). Ela não é usada para esconder o torneio nem bloquear inscrições — o torneio aparece para os jogadores de qualquer forma; usemanualRegistrationOpenpara controlar as inscrições.manualRegistrationOpen(true/false):
Determina se as inscrições para o torneio estão liberadas para os jogadores normais se registrarem via menu do mod.maxParticipants(Padrão: 16):
A quantidade máxima de jogadores que podem se inscrever na competição. O mod bloqueia novas inscrições instantaneamente ao atingir este valor.minParticipants(Padrão: 4):
A quantidade mínima de jogadores necessária para que o sorteio de chaves (roll) possa ser executado de forma oficial.testModeNoMinLimit(true/false):
Se ativado, ignora a regra de minParticipants. É ideal para testes de desenvolvimento em servidores locais com bots ou poucos jogadores.
Edite isto dentro do jogo (1.4+)
/bhubtournament <ID_do_Torneio> set <campo> <valor> altera registration, testmode, active, min, max, name, date, rewards... e já grava o JSON para você — veja Tournament Commands.
4. Integração de Formatos
ladderName: O nome estético e descritivo do formato que os jogadores lerão (ex: "OverUsed (OU)", "VGC 2026").ladderId(Padrão:"tourney_solo"):
O ID técnico da Ladder de regras que as arenas instanciadas herdarão (deve bater com os IDs de arquivos .json localizados na pasta ladders/). Isso garante que os duelos do torneio sigam rigorosamente as cláusulas competitivas e proibições de Pokémon/itens que você definiu.
5. Histórico de Campeões
showChampion(true/false):
Ativa ou desativa a exibição do último campeão do torneio no menu gráfico dos jogadores.lastChampion:
O nome (nickname) do jogador que venceu a última edição deste torneio. Este campo é atualizado automaticamente pelo TournamentManager no momento em que a final é concluída, mas também pode ser modificado manualmente por aqui se você desejar cadastrar um campeão clássico.