Quests Config
Configuração do Sistema de Missões (quests.json)
O sistema de missões do Cobblemon BattleHUB recompensa a atividade e a fidelidade dos jogadores através de desafios diários, semanais e permanentes. O arquivo quests.json é o núcleo onde todas as missões, metas de conclusão e comandos de recompensa são armazenados e editados.
Caminho do Arquivo
config/cobblemon_battlehub/quests.json
Como o Sistema Funciona
O comportamento do sistema é orquestrado de forma dinâmica pela classe QuestManager.java a cada login e término de partida:
- Geração Automática: Na primeira inicialização, se o arquivo quests.json não for encontrado, o mod cria o arquivo automaticamente, populando-o com mais de 90 missões pré-definidas.
- Seleção Randômica Inteligente: Para as missões diárias e semanais, o mod não entrega o catálogo inteiro para o jogador. Ele seleciona aleatoriamente um subconjunto de IDs com base em uma seed gerada pela data atual combinada com a UUID do jogador. Isso garante que cada jogador receba missões diferentes a cada ciclo!
- Persistência Segura: O progresso atual do jogador (quantas etapas concluiu, o que já foi resgatado e os horários de reset) é salvo de forma assíncrona no banco de dados.
Modelo Estrutural de Configuração
Abaixo está a estrutura simplificada do arquivo quests.json que demonstra como as missões e parâmetros globais são definidos:
{
"daily_quests_per_player": 2,
"weekly_quests_per_player": 5,
"daily_quests": [
{
"id": "daily_01",
"type": "PLAY_MATCHES",
"title": "Primeiro Passo",
"description": "Participe de 1 partida em qualquer fila.",
"targetAmount": 1,
"typeFilter": null,
"rewardDescription": "50 Dinheiros",
"rewardCommands": ["eco deposit 50 dollar %player%"]
}
],
"weekly_quests": [
{
"id": "weekly_01",
"type": "WIN_RANKED",
"title": "Veterano da Arena",
"description": "Vença 15 partidas Ranqueadas.",
"targetAmount": 15,
"typeFilter": null,
"rewardDescription": "1000 Pontos de Batalha",
"rewardCommands": ["eco deposit 1000 battlepoint %player%"]
}
],
"permanent_quests": [
{
"id": "perm_mono_fire",
"type": "MASTER_MONOTYPE",
"title": "Mestre das Chamas",
"description": "Alcance 100 vitórias usando Monotype Fogo.",
"targetAmount": 100,
"typeFilter": "fire",
"rewardDescription": "Tag Mestre Fogo",
"rewardCommands": ["lp user %player% parent add master_fire"]
}
]
}
Explicação Detalhada dos Parâmetros
1. Parâmetros de Seleção Global
daily_quests_per_player(Padrão: 2):
Determina quantas missões diárias serão sorteadas do pool global e atribuídas para cada jogador individualmente a cada 24 horas.weekly_quests_per_player(Padrão: 5):
Determina quantas missões semanais serão sorteadas do pool e atribuídas individualmente a cada 7 dias.
2. Parâmetros das Listas de Missões (daily_quests, weekly_quests, permanent_quests)
Cada objeto de missão inserido nas listas possui as seguintes propriedades obrigatórias:
id:
O identificador técnico da missão. Ele é usado pelo banco de dados para salvar se o jogador já concluiu ou resgatou o prêmio. Nunca duplique IDs!type:
O gatilho de ação da missão que se conecta com as estatísticas do mod. Deve bater exatamente com os nomes enumerados em QuestType.java (Ex:PLAY_MATCHES, WIN_RANKED, USE_TYPE, MASTER_MONOTYPE).title:
O título visual e chamativo que será exibido para o jogador no menu de missões e nos avisos do chat.description:
A explicação de texto que ensina o jogador exatamente o que ele precisa fazer para completar a missão.targetAmount:
A quantidade de vezes que o gatilho precisa ser acionado para a missão ser considerada "completa" (Ex: Vencer 15 partidas, nocautear 50 Pokémons).typeFilter:
Filtro refinador de condições. Ele pode ser usado para limitar a missão a um formato específico (como singles ou doubles) ou a um tipo de Pokémon na equipe (como fire, electric, water). Defina como null se a missão for genérica.rewardDescription:
A descrição visual do prêmio que aparecerá para o jogador quando ele concluir ou resgatar a missão.rewardCommands:
Lista de comandos que o console do servidor executará imediatamente quando o jogador resgatar a recompensa. Suporta a variável%player%ou{player}para injetar automaticamente o nome do jogador que completou o objetivo.
Como Recarregar Novas Missões
Se você adicionar novas missões, alterar descrições ou modificar os prêmios diretamente no arquivo quests.json, você pode aplicar as mudanças em tempo real e sincronizar a interface de todos os jogadores utilizando o comando:
/bh reload