Ir para o conteúdo

Server Config


Configuração Geral

O arquivo server_config.json é o núcleo de configuração do Cobblemon BattleHUB. Ele é gerado automaticamente na primeira inicialização do mod dentro do diretório do seu servidor.

Caminho do Arquivo

config/cobblemon_battlehub/server_config.json

Modelo Padrão de Configuração

Abaixo está o modelo com a estrutura oficial gerada pela classe ServerConfig para você usar como referência rápida:

    {  
      "guiTheme": "ULTRA",
      "activeRankedLadders": [  
        "singles_ranked",  
       "doubles_ranked",  
       "triples_ranked"  
      ],  
     "activeCasualLadders": [  
      "singles_50_casual",  
      "doubles_50_casual",
      "monotype_50_casual",
      "singles_100_casual",
      "doubles_100_casual",
      "triples_100_casual",
      "monotype_100_casual"
    ],  
     "actionTimerSeconds": 30,  
     "afkStrikeLimit": 3,  
     "afkExtensionSeconds": 15,  
     "maxAfkAutopilotRounds": 3,  
     "autopilotActionSeconds": 5,
     "allowEntityInteractionInQueue": false, 
     "dailyLimitRankedEnabled": true,
     "dailyLimitRanked": 10,
     "dailyLimitCasualEnabled": false,
     "dailyLimitCasual": 10, 
     "currentSeasonNumber": 1,  
     "currentSeasonId": "season_1",  
      "currentSeasonName": "Season 1",  
     "currentSeasonStartedAtMs": 1718064000000,  
     "completedRankedSeasons": [],  
     "rewards": {  
      "milestoneRewardsEnabled": true,  
       "seasonRewardsEnabled": true,  
       "milestoneRewards": [  
        {  
         "id": "ranked_wins_10",  
         "title": "10 Ranked Wins",  
         "statType": "RANKED_WINS",  
            "threshold": 10,  
         "commands": [  
              "give %player% minecraft:diamond 5"  
            ]  
          },  
       {  
         "id": "ranked_wins_25",  
         "title": "25 Ranked Wins",  
         "statType": "RANKED_WINS",  
         "threshold": 25,  
         "commands": [  
           "give %player% minecraft:netherite_ingot 1"  
         ]  
       },  
       {  
         "id": "arena_matches_50",  
         "title": "50 Arena Matches",  
         "statType": "TOTAL_BATTLES",  
         "threshold": 50,  
         "commands": [  
           "eco give %player% 1000"  
         ]  
       }  
     ],  
     "seasonEndRewards": {  
       "placementRewards": [  
         {  
           "maxPlacement": 1,  
           "minimumGames": 5,  
            "commands": [  
             "lp user %player% parent add top1"  
              ]  
           },  
          {  
            "maxPlacement": 3,  
            "minimumGames": 10,  
            "commands": [  
             "lp user %player% parent add top3"  
              ]  
         },  
         {  
              "maxPlacement": 10,  
              "minimumGames": 20,  
            "commands": [  
               "eco give %player% 5000"  
            ]  
          }  
          ],  
          "participationReward": {  
           "minimumGames": 15,  
           "commands": [  
            "give %player% cobblemon:poke_ball 15"  
           ]  
          }  
      }  
     }  
    }

Explicação Detalhada dos Parâmetros

1. Categorias Ativas (Ladders)

  • activeRankedLadders: Lista contendo os IDs das categorias competitivas (Ranked) que estarão disponíveis nas filas do servidor.
  • activeCasualLadders: Lista contendo os IDs das categorias sem valer pontos (Casual) liberadas para matchmaking rápido.

2. Timers e Sistema Anti-AFK

  • actionTimerSeconds (Padrão: 30): Tempo máximo (em segundos) que um jogador tem para tomar uma decisão em seu turno de batalha.
  • afkStrikeLimit (Padrão: 3): Quantidade máxima de vezes que o jogador pode estourar o tempo de turno antes de sofrer punições.
  • afkExtensionSeconds (Padrão: 15): Tempo adicional em segundos que o sistema concede em situações específicas de travamento ou reconexão.
  • maxAfkAutopilotRounds (Padrão: 3): Limite de turnos seguidos que o sistema de piloto automático pode agir de forma automática antes do jogador ser removido da partida por AFK.
  • autopilotActionSeconds (Padrão: 5): Tempo de resposta do piloto automático após o cronômetro do jogador esgotar de vez.

3. Temporadas (Seasons)

  • currentSeasonNumber: Contador incremental identificando o número ordinal da temporada atual.
  • currentSeasonId: Identificador interno gerado automaticamente pela lógica do mod para banco de dados (ex: season_1).
  • currentSeasonName: Nome fantasia/exibição da temporada ativa (ex: Season 1).
  • currentSeasonStartedAtMs: Timestamp Unix em milissegundos marcando o início exato da temporada em andamento.
  • completedRankedSeasons: Histórico que armazena dados de todas as temporadas finalizadas e arquivadas pelo comando /bh season rollover.

4. Sistema de Premiações (rewards)

Permite automatizar o envio de itens, moedas ou permissões via console quando metas forem alcançadas.

Configurações Globais

  • milestoneRewardsEnabled: (true/false) Habilita ou desabilita as recompensas por marcos de progresso do jogador.
  • seasonRewardsEnabled: (true/false) Habilita ou desativa as recompensas distribuídas aos melhores colocados no encerramento de temporada.

Metas de Progresso (milestoneRewards)

Array onde você cadastra metas específicas de jogo:

  • id: String única para registrar a entrega da meta e evitar resgates duplicados.
  • title: O nome visual exibido aos jogadores.
  • statType: Tipo de estatística avaliada no gatilho. As opções suportadas na classe Java são:
  • TOTAL_BATTLES: Quantidade total de duelos travados (Ranked + Casual).
  • RANKED_WINS: Total de vitórias na fila competitiva.
  • RANKED_MATCHES: Quantidade de partidas jogadas na fila competitiva.
  • QUICK_WINS: Vitórias em partidas casuais.
  • QUICK_MATCHES: Partidas casuais completadas.
  • threshold: O número alvo de vitórias ou partidas para destravar a recompensa.
  • commands: Lista de comandos que o console rodará. O marcador %player% substitui automaticamente pelo nick do jogador.

Premiações de Fim de Temporada (seasonEndRewards)

  • placementRewards: Lista contendo prêmios para o topo do ranking.
  • maxPlacement: Posição máxima elegível (ex: 1 dará apenas para o Top 1, 3 premiará o Top 2 e Top 3, etc).
  • minimumGames: Quantidade mínima de partidas completadas na temporada para evitar que alguém que jogou só uma partida herde o Top 1.
  • commands: Lista de comandos a serem disparados pelo console para os vencedores.
  • participationReward: Prêmio de consolação por participação.
  • minimumGames: Mínimo de partidas que o jogador precisa ter completado para ser elegível a este prêmio de participação.
  • commands: Comandos enviados ao console para premiar os participantes válidos.

### 5. Interface e Limites Diários

  • guiTheme: Define o tema visual da interface gráfica (GUI) do mod. Os presets disponíveis são: DEFAULT, POKE, GREAT, ULTRA, QUICK, DUSK e MASTER.

  • dailyLimitRankedEnabled (true/false): Habilita ou desabilita o limite de partidas competitivas que um jogador pode jogar por dia.

  • dailyLimitRanked: Quantidade máxima de partidas Ranked permitidas por jogador diariamente.
  • dailyLimitCasualEnabled (true/false): Habilita ou desabilita o limite de partidas casuais por dia.
  • dailyLimitCasual: Quantidade máxima de partidas Casuais permitidas por jogador diariamente.

6. Interação Enquanto na Fila (desde a 1.4)

  • allowEntityInteractionInQueue (true/false, Padrão: false): Enquanto o jogador está numa fila, o mod bloqueia clicar com o botão direito em entidades (outros jogadores, NPCs...), blocos (PCs, máquinas de cura, baús...) e a maioria dos comandos. Com true, quem está na fila pode interagir com entidades — necessário para servidores que abrem o menu do BattleHUB por um NPC. Blocos e comandos continuam bloqueados. Quem está se preparando para uma partida de torneio mantém os três bloqueios independentemente desta opção. Aplique com /bh reload.