Cobblemon is de Minecraft-mod die Pokémon op een native manier in het spel integreert, met ondersteuning voor het ressource- en datapack-systeem van Minecraft voor maximale aanpassingsmogelijkheden. Een van de voornaamste voordelen van deze aanpak is de mogelijkheid om de logica van Pokémon-spawns volledig aan te passen zonder de broncode van de mod te veranderen. Met een goed gestructureerde datapack kan een serverheerser of modpack-maker precies bepalen welke Pokémon verschijnen, in welke biomen, onder welke omstandigheden en hoe vaak.
Deze technische gids is bedoeld voor Cobblemon-serverheerders en modpack-makers die het aangepaste spawn-systeem van de mod onder de knie willen krijgen. We gaan samen kijken hoe je een datapack structureert, het JSON-formaat van spawn-bestanden begrijpt, en alles op een productieserver implementeert.
Waarom spawns aanpassen met een datapack?
Standaard genereert Cobblemon zijn eigen spawn-bestanden voor alle Pokémon-generaties (Gen 1 tot Gen 9). Deze bestanden bepalen onder welke omstandigheden elke soort in de wereld kan verschijnen. Echter, meerdere situaties rechtvaardigen het aanmaken van een aangepaste spawn-datapack:
- Zeldzaamheid herbalanceren: een Pokémon kan in je bioom-configuratie te veel of te weinig voorkomen.
- Thematische spawns toevoegen: waterige Pokémon alleen laten verschijnen in specifieke oceanbiomen van je modpack.
- Exclusieve zones maken: bepaalde Pokémon reserveren voor bepaalde dimensies of structuren.
- Ongewenste spawns verwijderen: het verschijnen van bepaalde soorten uitschakelen om balansredenen.
- Synchronisatie met third-party mods: biomen toegevoegd door mods zoals Terralith of BYG integreren in de spawn-logica.
Cobblemon-datapacks zijn volledig compatibel met hot-reloading via het commando /reload, wat debugging en live-aanpassingen vergemakkelijkt.
Structuur van een Cobblemon-datapack
Een standaard Minecraft-datapack volgt een nauwkeurige mappenstructuur. Voor Cobblemon worden spawn-bestanden in een specifieke submap geplaatst. Hier is de minimale structuur die moet worden nageleefd:
mijn-datapack/
├── pack.mcmeta
└── data/
└── cobblemon/
└── spawn_pool_world/
├── bulbasaur.json
├── pikachu.json
└── ...
Het bestand pack.mcmeta moet minimaal het volgende bevatten:
{
"pack": {
"pack_format": 15,
"description": "Aangepaste Cobblemon-spawns"
}
}
Pas de waarde pack_format aan aan de Minecraft-versie die je gebruikt (15 voor 1.20.x, 18 voor 1.21.x). De map spawn_pool_world is de directory die Cobblemon monitort om spawn-regels in de hoofdwereld in te laden. Er zijn ook spawn_pool_nether en spawn_pool_end voor de corresponderende dimensies.
Anatomie van een spawn JSON-bestand
Elk spawn JSON-bestand kan meerdere vermeldingen bevatten voor dezelfde Pokémon of voor meerdere soorten. Hier is een geannoteerd voorbeeld voor 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"]
}
}
]
}
De essentiële velden
- id: unieke identifier voor de regel, in het formaat
namespace:beschrijvende_naam. Het moet uniek zijn in de hele datapack. - pokemon: interne naam van het Pokémon in kleine letters, zoals deze in Cobblemon verschijnt (bijv:
bulbasaur,garchomp,iron_bundle). - type: de bewegingsmodus van de spawn. Mogelijke waarden:
land,water,water_surface,underwater,air,lava. - context: aanvullende context. Voor
land, gebruikgrounded. Voor vliegende Pokémon, gebruikflying. - bucket: zeldzaamheidscategorie. Herkende waarden zijn
common,uncommon,rareenultra_rare. - level: niveaubereik van het gespawinde Pokémon, in het formaat
"min-max". - weight: relatief gewicht in de bucket. Hoe hoger deze waarde ten opzichte van andere vermeldingen in dezelfde bucket, hoe frequenter het Pokémon verschijnt.
Het condition-blok
Het veld condition is het hart van de aanpassing. Het accepteert veel parameters:
- biomes: lijst van biomen of biomen-tags. Tags beginnen met
#(bijv:#minecraft:is_ocean,#forge:is_hot, of mod-tags zoals#terralith:tropical_island). - structures: lijst van structuren waar de spawn is toegestaan (bijv:
minecraft:stronghold). - timeRange: tijdstip-bereik. Waarden:
any,day,night,dawn,dusk. - minY / maxY: minimale en maximale hoogte van de spawn.
- minLight / maxLight: minimaal en maximaal lichtniveau (0-15).
- isRaining: boolean, true om spawn op regen te beperken.
- isThundering: boolean, voor alleen onweer.
- moonPhase: maanfase (0 = volle maan, geheel getal 0-7).
- nearbyBlocks: lijst van blokken die in de buurt van het spawn-punt moeten zijn.
Het anticondition-blok
Het veld anticondition werkt als condition maar negatief: als een van de anticondition-voorwaarden waar is, wordt de spawn geblokkeerd. Dit stelt je bijvoorbeeld in staat om een Pokémon niet in een structuur te laten spawnen terwijl het wel in het bioom dat de structuur bevat mag spawnen.
Praktische voorbeelden van aanpassing
Voorbeeld 1: Pokémon exclusief voor een mod-bioom
Als je Terralith gebruikt, kun je Sneasel alleen in het bioom terralith:snowy_badlands laten verschijnen:
{
"spawns": [
{
"id": "mijnpack:sneasel_snowy_badlands",
"pokemon": "sneasel",
"type": "land",
"context": "grounded",
"bucket": "rare",
"level": "25-40",
"weight": 5.0,
"condition": {
"biomes": ["terralith:snowy_badlands"]
}
}
]
}
Voorbeeld 2: Voorwaardelijke nachtelijke spawn
Om Haunter alleen 's nachts te laten verschijnen, in grotten of donkere gebieden:
{
"spawns": [
{
"id": "mijnpack:haunter_cave_night",
"pokemon": "haunter",
"type": "land",
"context": "grounded",
"bucket": "rare",
"level": "20-35",
"weight": 4.0,
"condition": {
"timeRange": "night",
"maxY": 50,
"maxLight": 3
}
}
]
}
Voorbeeld 3: Een bestaande spawn uitschakelen
Om een native Cobblemon-spawn uit te schakelen, maak je een JSON-bestand met "enabled": false en dezelfde identifier als de originele regel. Cobblemon voegt datapacks samen en gebruiker-datapacks hebben prioriteit over ingebouwde gegevens:
{
"enabled": false,
"spawns": [
{
"id": "cobblemon:magikarp_river"
}
]
}
Let op: je moet de exacte identifier van de originele regel kennen. Deze zijn raadpleegbaar in de broncode van de mod op de officiële Cobblemon GitLab-repository, of door de JAR van de mod uit te pakken.
Spawns van vormen en varianten
Cobblemon ondersteunt Pokémon-vormen rechtstreeks in spawn-bestanden. Om een specifieke vorm aan te duiden, voeg je de vorm na de Pokémon-naam toe:
"pokemon": "rattata form=alolan"
Je kunt ook visuele aspecten of modificatoren toevoegen:
"pokemon": "pikachu aspects=[original_cap]"
De eigenschappen die in het veld pokemon worden geaccepteerd, volgen de syntaxis van Cobblemon-commando's en stellen je in staat om geslacht, niveau, speciale mogelijkheden of elk ander attribuut dat door de mod wordt herkend, op te geven.
Implementatie op een server
Zodra je datapack is aangemaakt en lokaal getest, volgt de implementatie op een Cobblemon-server een eenvoudige procedure:
- Comprimeren als ZIP: je map
mijn-datapack/moet worden gecomprimeerd alsmijn-datapack.zip. De root van het archief moet directpack.mcmetaen de mapdata/bevatten. - In de juiste map plaatsen: op een Minecraft-server worden datapacks geplaatst in
world/datapacks/(ofworld_nether/datapacks/voor de Nether). - De datapack activeren: bij de eerste start of na een
/reload, voer je/datapack enable "file/mijn-datapack.zip"uit als de datapack niet automatisch wordt geactiveerd. - Spawns herladen: voer
/reloaduit zodat Cobblemon alle spawn-bestanden herlaadt. Het is niet nodig de server opnieuw op te starten.
Op panelen zoals PteroPilot of Pterodactyl kun je de ZIP rechtstreeks uploaden via de webbestandsbeheerder of via SFTP in de map world/datapacks/.
De laadstatus van de datapack controleren
Om te bevestigen dat je datapack correct is geladen en actief:
- Commando
/datapack list: geeft een lijst van alle actieve datapacks. De jouwe moet erin voorkomen met zijn naam. - Logbestanden van de server: bij het opstarten of bij een
/reloadgeeft Cobblemon berichten weer met het aantal geladen spawn-regels. - Cobblemon-commando
/cobblemon spawnpool(indien beschikbaar): stelt je in staat om de huidige spawn-pool op jouw positie te inspecteren.
Best practices en valkuilen om te vermijden
Conflicterende identifiers
Twee regels met dezelfde id overschrijven elkaar. Dit is nuttig om native spawns uit te schakelen, maar kan onverwacht gedrag veroorzaken als twee datapacks op je server per ongeluk dezelfde identifier definiëren. Gebruik altijd een unieke namespace voor je identifiers (bijv: mijnserver:...).
Gewichten en buckets
Het gewichtssysteem werkt per bucket, niet globaal. Een Pokémon met een weight van 100 in de bucket ultra_rare is niet noodzakelijk veel voorkomend: de waarschijnlijkheid dat de bucket ultra_rare wordt geselecteerd, blijft laag. Pas eerst de bucket aan, vervolgens het gewicht binnen de bucket.
Niet-herkende biomen-tags
Als een biomen-tag in je voorwaarde niet bestaat in je instantie (bijvoorbeeld een tag van een niet-geïnstalleerde mod), kan de spawn-regel stilzwijgend worden genegeerd.