Cobblemon é o mod do Minecraft que integra Pokémon no jogo de forma nativa, utilizando o sistema de recursos e datapacks do Minecraft para oferecer personalização máxima. Uma das grandes vantagens dessa abordagem é a possibilidade de modificar completamente a lógica de spawn dos Pokémon sem alterar o código-fonte do mod. Com um datapack bem estruturado, um administrador de servidor ou criador de modpack pode controlar com precisão quais Pokémon aparecem, em quais biomas, em que condições e com que frequência.
Este guia técnico é direcionado para administradores de servidores Cobblemon e criadores de modpacks que desejam dominar o sistema de spawn personalizado do mod. Vamos aprender juntos como estruturar um datapack, compreender o formato JSON dos arquivos de spawn e implantar tudo em um servidor em produção.
Por que personalizar os spawns com um datapack?
Por padrão, Cobblemon gera seus próprios arquivos de spawn para todas as gerações de Pokémon (Gen 1 a Gen 9). Esses arquivos definem as condições nas quais cada espécie pode aparecer no mundo. No entanto, várias situações justificam a criação de um datapack de spawn personalizado:
- Reequilibrar a raridade: um Pokémon pode ser muito comum ou muito raro na sua configuração de biomas.
- Adicionar spawns temáticos: fazer Pokémon aquáticos aparecerem apenas em biomas oceânicos específicos do seu modpack.
- Criar zonas exclusivas: reservar certos Pokémon para dimensões ou estruturas particulares.
- Remover spawns indesejados: desabilitar o aparecimento de certas espécies por razões de equilíbrio.
- Sincronizar com mods terceirizados: integrar biomas adicionados por mods como Terralith ou BYG na lógica de spawn.
Os datapacks Cobblemon são totalmente compatíveis com recarga a quente via comando /reload, o que facilita a depuração e ajustes em tempo real.
Estrutura de um datapack Cobblemon
Um datapack Minecraft padrão segue uma hierarquia de pastas precisa. Para Cobblemon, os arquivos de spawn são colocados em uma subpasta específica. Aqui está a estrutura mínima a ser respeitada:
mon-datapack/
├── pack.mcmeta
└── data/
└── cobblemon/
└── spawn_pool_world/
├── bulbasaur.json
├── pikachu.json
└── ...
O arquivo pack.mcmeta deve conter no mínimo:
{
"pack": {
"pack_format": 15,
"description": "Spawns personalizados Cobblemon"
}
}
Adapte o valor pack_format à versão do Minecraft que você está usando (15 para 1.20.x, 18 para 1.21.x). A pasta spawn_pool_world é o diretório que Cobblemon monitora para carregar as regras de spawn no mundo principal. Também existem spawn_pool_nether e spawn_pool_end para as dimensões correspondentes.
Anatomia de um arquivo JSON de spawn
Cada arquivo JSON de spawn pode conter várias entradas para o mesmo Pokémon ou para várias espécies. Aqui está um exemplo comentado para Pikachu:
{
"enabled": true,
"neededInstalledMods": [],
"neededUninstalledMods": [],
"spawns": [
{
"id": "cobblemon:pikachu_forest",
"pokemon": "pikachu",
"type": "land",
"context": "grounded",
"bucket": "uncommon",
"level": "10-25",
"weight": 8.0,
"condition": {
"biomes": [
"#minecraft:is_forest"
],
"timeRange": "any",
"isRaining": false,
"minY": 60,
"maxY": 120
},
"anticondition": {
"structures": ["#minecraft:villages"]
}
}
]
}
Os campos essenciais
- id: identificador único da regra, no formato
namespace:nome_descritivo. Deve ser único em todo o datapack. - pokemon: nome interno do Pokémon em minúsculas, conforme aparece no Cobblemon (ex:
bulbasaur,garchomp,iron_bundle). - type: o modo de deslocamento do spawn. Valores possíveis:
land,water,water_surface,underwater,air,lava. - context: contexto adicional. Para
land, usegrounded. Para Pokémon voadores, useflying. - bucket: categoria de raridade. Os valores reconhecidos são
common,uncommon,rareeultra_rare. - level: faixa de níveis do Pokémon desovado, no formato
"min-max". - weight: peso relativo no bucket. Quanto maior esse valor em relação às outras entradas do mesmo bucket, mais frequente o Pokémon aparece.
O bloco condition
O campo condition é o coração da personalização. Ele aceita muitos parâmetros:
- biomes: lista de biomas ou tags de biomas. As tags começam com
#(ex:#minecraft:is_ocean,#forge:is_hot, ou tags de mods como#terralith:tropical_island). - structures: lista de estruturas nas quais o spawn é permitido (ex:
minecraft:stronghold). - timeRange: faixa horária. Valores:
any,day,night,dawn,dusk. - minY / maxY: altitude mínima e máxima do spawn.
- minLight / maxLight: nível de luz mínimo e máximo (0-15).
- isRaining: booleano, true para restringir o spawn à chuva.
- isThundering: booleano, para tempestades apenas.
- moonPhase: fase da lua (0 = lua cheia, inteiro 0-7).
- nearbyBlocks: lista de blocos que devem estar presentes próximos ao ponto de spawn.
O bloco anticondition
O campo anticondition funciona como condition, mas negativamente: se uma das condições da anticondição for atendida, o spawn é bloqueado. Isso permite, por exemplo, impedir um Pokémon de desovarem dentro de uma estrutura enquanto o deixa desovarem no bioma que abriga essa estrutura.
Casos práticos de personalização
Caso 1: Pokémon exclusivo para um bioma de mod
Se você usar Terralith, pode fazer Sneasel aparecer apenas no bioma terralith:snowy_badlands:
{
"spawns": [
{
"id": "monpack:sneasel_snowy_badlands",
"pokemon": "sneasel",
"type": "land",
"context": "grounded",
"bucket": "rare",
"level": "25-40",
"weight": 5.0,
"condition": {
"biomes": ["terralith:snowy_badlands"]
}
}
]
}
Caso 2: Spawn noturno condicional
Para fazer Haunter aparecer apenas à noite, em cavernas ou áreas escuras:
{
"spawns": [
{
"id": "monpack:haunter_cave_night",
"pokemon": "haunter",
"type": "land",
"context": "grounded",
"bucket": "rare",
"level": "20-35",
"weight": 4.0,
"condition": {
"timeRange": "night",
"maxY": 50,
"maxLight": 3
}
}
]
}
Caso 3: Desabilitar um spawn existente
Para desabilitar um spawn nativo do Cobblemon, crie um arquivo JSON com "enabled": false e o mesmo identificador que a regra original. Cobblemon mescla datapacks e datapacks de usuário têm prioridade sobre dados integrados:
{
"enabled": false,
"spawns": [
{
"id": "cobblemon:magikarp_river"
}
]
}
Atenção: você deve conhecer o identificador exato da regra original. Estes podem ser consultados no código-fonte do mod no repositório oficial do GitLab do Cobblemon, ou extraindo o JAR do mod.
Spawns de formas e variantes
Cobblemon suporta formas Pokémon diretamente nos arquivos de spawn. Para apontar uma forma específica, adicione a forma depois do nome do Pokémon:
"pokemon": "rattata form=alolan"
Você também pode adicionar aspectos visuais ou modificadores:
"pokemon": "pikachu aspects=[original_cap]"
As propriedades aceitas no campo pokemon seguem a sintaxe dos comandos Cobblemon e permitem especificar gênero, nível, habilidades especiais, ou qualquer outro atributo reconhecido pelo mod.
Implantação em um servidor
Após criar e testar seu datapack localmente, a implantação em um servidor Cobblemon segue um procedimento simples:
- Compactar em ZIP: sua pasta
mon-datapack/deve ser compactada emmon-datapack.zip. A raiz do arquivo deve conter diretamentepack.mcmetae a pastadata/. - Colocar na pasta correta: em um servidor Minecraft, os datapacks são colocados em
world/datapacks/(ouworld_nether/datapacks/para o Nether). - Ativar o datapack: no primeiro lançamento ou após um
/reload, execute/datapack enable "file/mon-datapack.zip"se o datapack não for ativado automaticamente. - Recarregar os spawns: execute
/reloadpara que Cobblemon recarregue todos os arquivos de spawn. Nenhuma reinicialização do servidor é necessária.
Em painéis como PteroPilot ou Pterodactyl, você pode fazer upload do ZIP diretamente via gerenciador de arquivos web ou via SFTP na pasta world/datapacks/.
Verificar o carregamento do datapack
Para confirmar que seu datapack foi carregado e está ativo:
- Comando
/datapack list: lista todos os datapacks ativos. O seu deve aparecer com seu nome. - Logs do servidor: ao iniciar ou durante um
/reload, Cobblemon exibe mensagens indicando o número de regras de spawn carregadas. - Comando Cobblemon
/cobblemon spawnpool(se disponível): permite inspecionar o pool de spawn atual na sua posição.
Boas práticas e armadilhas a evitar
Conflitos de identificadores
Duas regras com o mesmo id se sobrescrevem mutuamente. Isso é útil para desabilitar spawns nativos, mas pode causar comportamentos inesperados se dois datapacks do seu servidor definirem acidentalmente o mesmo identificador. Sempre adote um namespace único para seus identificadores (ex: meuservidor:...).
Pesos e buckets
O sistema de peso funciona por bucket, não globalmente. Um Pokémon com um weight de 100 no bucket ultra_rare não será necessariamente comum: a probabilidade de o bucket ultra_rare ser selecionado permanece baixa. Ajuste primeiro o bucket, depois o peso dentro do bucket.
Tags de biomas não reconhecidas
Se uma tag de bioma em sua condição não existir em sua instância (por exemplo, uma tag de mod não instalado), a regra de spawn pode ser ignorada silenciosamente.