Cobblemon è il mod Minecraft che integra i Pokémon nel gioco in modo nativo, basandosi sul sistema di risorse e datapack di Minecraft per offrire la massima personalizzazione. Uno dei principali vantaggi di questo approccio è la possibilità di modificare completamente la logica di spawn dei Pokémon senza toccare il codice sorgente del mod. Grazie a un datapack ben strutturato, un amministratore di server o un creatore di modpack può controllare precisamente quali Pokémon compaiono, in quali biomi, in quali condizioni e con quale frequenza.
Questa guida tecnica è rivolta agli amministratori di server Cobblemon e ai creatori di modpack che desiderano padroneggiare il sistema di spawn personalizzato del mod. Vedremo insieme come strutturare un datapack, comprendere il formato JSON dei file di spawn e distribuire il tutto su un server in produzione.
Perché personalizzare gli spawn con un datapack?
Per impostazione predefinita, Cobblemon genera i propri file di spawn per tutte le generazioni di Pokémon (Gen 1-9). Questi file definiscono le condizioni in cui ogni specie può apparire nel mondo. Tuttavia, diverse situazioni giustificano la creazione di un datapack di spawn personalizzato:
- Ribilanciare la rarità: un Pokémon potrebbe essere troppo comune o troppo raro nella vostra configurazione di biomi.
- Aggiungere spawn tematici: far apparire Pokémon acquatici solo in biomi oceanici specifici del vostro modpack.
- Creare zone esclusive: riservare certi Pokémon a dimensioni o strutture particolari.
- Rimuovere spawn indesiderati: disabilitare l'apparizione di determinate specie per ragioni di bilanciamento.
- Sincronizzare con mod di terze parti: integrare biomi aggiunti da mod come Terralith o BYG nella logica di spawn.
I datapack Cobblemon sono completamente compatibili con il ricaricamento a caldo tramite il comando /reload, il che facilita il debug e gli aggiustamenti in tempo reale.
Struttura di un datapack Cobblemon
Un datapack Minecraft standard segue una gerarchia di cartelle precisa. Per Cobblemon, i file di spawn si posizionano in una sottocartella specifica. Ecco la struttura minima da rispettare:
mio-datapack/
├── pack.mcmeta
└── data/
└── cobblemon/
└── spawn_pool_world/
├── bulbasaur.json
├── pikachu.json
└── ...
Il file pack.mcmeta deve contenere almeno:
{
"pack": {
"pack_format": 15,
"description": "Spawn personalizzati Cobblemon"
}
}
Adattate il valore pack_format alla versione di Minecraft che utilizzate (15 per 1.20.x, 18 per 1.21.x). La cartella spawn_pool_world è la directory che Cobblemon monitora per caricare le regole di spawn nel mondo principale. Esistono anche spawn_pool_nether e spawn_pool_end per le dimensioni corrispondenti.
Anatomia di un file JSON di spawn
Ogni file JSON di spawn può contenere più voci per lo stesso Pokémon o per più specie. Ecco un esempio commentato per 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"]
}
}
]
}
I campi essenziali
- id: identificatore univoco della regola, nel formato
namespace:nome_descrittivo. Deve essere univoco in tutto il datapack. - pokemon: nome interno del Pokémon in minuscolo, come appare in Cobblemon (es:
bulbasaur,garchomp,iron_bundle). - type: la modalità di movimento dello spawn. Valori possibili:
land,water,water_surface,underwater,air,lava. - context: contesto aggiuntivo. Per
land, utilizzategrounded. Per i Pokémon volanti, utilizzateflying. - bucket: categoria di rarità. I valori riconosciuti sono
common,uncommon,rareeultra_rare. - level: intervallo di livelli del Pokémon generato, nel formato
"min-max". - weight: peso relativo nel bucket. Più questo valore è alto rispetto alle altre voci dello stesso bucket, più frequente è il Pokémon.
Il blocco condition
Il campo condition è il cuore della personalizzazione. Accetta molti parametri:
- biomes: lista di biomi o tag di biomi. I tag iniziano con
#(es:#minecraft:is_ocean,#forge:is_hot, o tag di mod come#terralith:tropical_island). - structures: lista di strutture in cui lo spawn è autorizzato (es:
minecraft:stronghold). - timeRange: intervallo orario. Valori:
any,day,night,dawn,dusk. - minY / maxY: altitudine minima e massima dello spawn.
- minLight / maxLight: livello di luce minimo e massimo (0-15).
- isRaining: booleano, true per limitare lo spawn alla pioggia.
- isThundering: booleano, per i temporali soltanto.
- moonPhase: fase lunare (0 = luna piena, intero 0-7).
- nearbyBlocks: lista di blocchi che devono essere presenti nelle vicinanze del punto di spawn.
Il blocco anticondition
Il campo anticondition funziona come condition ma in negativo: se una delle condizioni dell'anticondition è soddisfatta, lo spawn è bloccato. Questo permette ad esempio di impedire a un Pokémon di generarsi all'interno di una struttura pur permettendogli di generarsi nel bioma che ospita questa struttura.
Casi pratici di personalizzazione
Caso 1: Pokémon esclusivo a un bioma di mod
Se utilizzate Terralith, potete far apparire Sneasel solo nel bioma terralith:snowy_badlands:
{
"spawns": [
{
"id": "miopack: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 notturno condizionale
Per far apparire Haunter solo di notte, in grotte o zone buie:
{
"spawns": [
{
"id": "miopack: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: Disabilitare uno spawn esistente
Per disabilitare uno spawn nativo di Cobblemon, create un file JSON con "enabled": false e lo stesso identificatore della regola originale. Cobblemon unisce i datapack e i datapack utente hanno la priorità rispetto ai dati incorporati:
{
"enabled": false,
"spawns": [
{
"id": "cobblemon:magikarp_river"
}
]
}
Attenzione: dovete conoscere l'identificatore esatto della regola originale. Questi sono consultabili nel codice sorgente del mod sul repository ufficiale GitLab di Cobblemon, o estraendo il JAR del mod.
Spawn di forme e varianti
Cobblemon supporta le forme Pokémon direttamente nei file di spawn. Per indirizzare una forma specifica, aggiungete la forma dopo il nome del Pokémon:
"pokemon": "rattata form=alolan"
Potete anche aggiungere aspetti visivi o modificatori:
"pokemon": "pikachu aspects=[original_cap]"
Le proprietà accettate nel campo pokemon seguono la sintassi dei comandi Cobblemon e permettono di specificare genere, livello, mosse speciali, o qualsiasi altro attributo riconosciuto dal mod.
Distribuzione su un server
Una volta creato e testato il vostro datapack in locale, la distribuzione su un server Cobblemon segue una procedura semplice:
- Comprimere in ZIP: la vostra cartella
mio-datapack/deve essere compressa inmio-datapack.zip. La radice dell'archivio deve contenere direttamentepack.mcmetae la cartelladata/. - Posizionare nella cartella corretta: su un server Minecraft, i datapack si posizionano in
world/datapacks/(oworld_nether/datapacks/per il Nether). - Attivare il datapack: al primo avvio o dopo un
/reload, eseguite/datapack enable "file/mio-datapack.zip"se il datapack non si attiva automaticamente. - Ricaricare gli spawn: lanciate
/reloadperché Cobblemon ricarichi tutti i file di spawn. Nessun riavvio del server è necessario.
Su pannelli come PteroPilot o Pterodactyl, potete caricare il ZIP direttamente tramite il gestore di file web o via SFTP nella cartella world/datapacks/.
Verificare il caricamento del datapack
Per confermare che il vostro datapack è caricato e attivo:
- Comando
/datapack list: elenca tutti i datapack attivi. Il vostro deve apparire con il suo nome. - Log del server: all'avvio o durante un
/reload, Cobblemon visualizza messaggi che indicano il numero di regole di spawn caricate. - Comando Cobblemon
/cobblemon spawnpool(se disponibile): permette di ispezionare il pool di spawn attuale alla vostra posizione.
Buone pratiche e trabocchetti da evitare
Conflitti di identificatori
Due regole con lo stesso id si sovrascrivono mutuamente. È utile per disabilitare spawn nativi, ma può causare comportamenti inaspettati se due datapack del vostro server definiscono accidentalmente lo stesso identificatore. Adottate sempre uno spazio dei nomi univoco per i vostri identificatori (es: mioserver:...).
Pesi e bucket
Il sistema di pesi funziona per bucket, non globalmente. Un Pokémon con un weight di 100 nel bucket ultra_rare non sarà necessariamente comune: la probabilità che il bucket ultra_rare sia selezionato rimane bassa. Regolate prima il bucket, poi il peso all'interno del bucket.
Tag di biomi non riconosciuti
Se un tag di bioma nella vostra condizione non esiste nella vostra istanza (ad esempio, un tag di mod non installato), la regola di spawn potrebbe essere ignorata silenziosamente