Cobblemon ist das Minecraft-Mod, das Pokémon nativ in das Spiel integriert, indem es sich auf das Ressourcen- und Datapack-System von Minecraft stützt, um maximale Anpassung zu bieten. Einer der großen Vorteile dieses Ansatzes ist die Möglichkeit, die gesamte Spawn-Logik von Pokémon zu ändern, ohne den Quellcode des Mods zu berühren. Mit einem gut strukturierten Datapack kann ein Serveradministrator oder Modpack-Ersteller präzise kontrollieren, welche Pokémon wo erscheinen, unter welchen Bedingungen und mit welcher Häufigkeit.

Dieser technische Leitfaden richtet sich an Cobblemon-Serveradministratoren und Modpack-Ersteller, die das benutzerdefinierte Spawn-System des Mods beherrschen möchten. Wir werden gemeinsam sehen, wie man ein Datapack strukturiert, das JSON-Format von Spawn-Dateien versteht und alles auf einem Produktionsserver einsetzt.

Warum Spawns mit einem Datapack anpassen?

Standardmäßig generiert Cobblemon seine eigenen Spawn-Dateien für alle Pokémon-Generationen (Gen 1 bis Gen 9). Diese Dateien definieren die Bedingungen, unter denen jede Art in der Welt erscheinen kann. Es gibt jedoch mehrere Situationen, die die Erstellung eines benutzerdefinierten Spawn-Datapacks rechtfertigen:

  • Seltenheit neu ausbalancieren: ein Pokémon kann in Ihrer Biom-Konfiguration zu häufig oder zu selten sein.
  • Thematische Spawns hinzufügen: Wasser-Pokémon nur in spezifischen ozeanischen Biomen Ihres Modpacks erscheinen lassen.
  • Exklusive Zonen erstellen: bestimmte Pokémon für bestimmte Dimensionen oder Strukturen reservieren.
  • Unerwünschte Spawns entfernen: das Erscheinen bestimmter Arten aus Ausgleichsgründen deaktivieren.
  • Mit Third-Party-Mods synchronisieren: von Mods wie Terralith oder BYG hinzugefügte Biome in die Spawn-Logik integrieren.

Cobblemon-Datapacks sind vollständig kompatibel mit dem Hot-Reload über den Befehl /reload, was das Debugging und Live-Anpassungen erleichtert.

Struktur eines Cobblemon-Datapacks

Ein Standard-Minecraft-Datapack folgt einer präzisen Ordnerhierarchie. Für Cobblemon werden Spawn-Dateien in einem spezifischen Unterordner platziert. Hier ist die minimale Struktur, die beachtet werden muss:

mon-datapack/
├── pack.mcmeta
└── data/
    └── cobblemon/
        └── spawn_pool_world/
            ├── bulbasaur.json
            ├── pikachu.json
            └── ...

Die Datei pack.mcmeta muss mindestens Folgendes enthalten:

{
  "pack": {
    "pack_format": 15,
    "description": "Benutzerdefinierte Cobblemon-Spawns"
  }
}

Passen Sie den Wert pack_format an die von Ihnen verwendete Minecraft-Version an (15 für 1.20.x, 18 für 1.21.x). Der Ordner spawn_pool_world ist das Verzeichnis, das Cobblemon überwacht, um Spawn-Regeln in der Hauptwelt zu laden. Es gibt auch spawn_pool_nether und spawn_pool_end für die entsprechenden Dimensionen.

Anatomie einer JSON-Spawn-Datei

Jede JSON-Spawn-Datei kann mehrere Einträge für dasselbe Pokémon oder für mehrere Arten enthalten. Hier ist ein kommentiertes Beispiel für 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"]
      }
    }
  ]
}

Die wesentlichen Felder

  • id: eindeutige Kennung der Regel im Format namespace:descriptive_name. Sie muss im gesamten Datapack eindeutig sein.
  • pokemon: interner Name des Pokémon in Kleinbuchstaben, wie er in Cobblemon erscheint (z.B.: bulbasaur, garchomp, iron_bundle).
  • type: der Spawn-Bewegungsmodus. Mögliche Werte: land, water, water_surface, underwater, air, lava.
  • context: zusätzlicher Kontext. Für land verwenden Sie grounded. Für fliegende Pokémon verwenden Sie flying.
  • bucket: Seltenheitskategorie. Die erkannten Werte sind common, uncommon, rare und ultra_rare.
  • level: Levelbereich des gespawnten Pokémon im Format "min-max".
  • weight: relatives Gewicht im Bucket. Je höher dieser Wert im Vergleich zu anderen Einträgen im selben Bucket ist, desto häufiger ist das Pokémon.

Der Bedingungsblock

Das Feld condition ist das Herzstück der Anpassung. Es akzeptiert viele Parameter:

  • biomes: Liste von Biomen oder Biom-Tags. Tags beginnen mit # (z.B.: #minecraft:is_ocean, #forge:is_hot, oder Mod-Tags wie #terralith:tropical_island).
  • structures: Liste von Strukturen, in denen der Spawn erlaubt ist (z.B.: minecraft:stronghold).
  • timeRange: Zeitbereich. Werte: any, day, night, dawn, dusk.
  • minY / maxY: minimale und maximale Höhe des Spawns.
  • minLight / maxLight: minimale und maximale Lichtstufe (0-15).
  • isRaining: Boolesch, true um den Spawn auf Regen zu beschränken.
  • isThundering: Boolesch, für Gewitter nur.
  • moonPhase: Mondphase (0 = Vollmond, Ganzzahl 0-7).
  • nearbyBlocks: Liste von Blöcken, die in der Nähe des Spawn-Punkts vorhanden sein müssen.

Der Antibedingungsblock

Das Feld anticondition funktioniert wie condition, aber in Negativ: Wenn eine der Bedingungen der Antibedingung erfüllt ist, wird der Spawn blockiert. Dies ermöglicht es beispielsweise, ein Pokémon am Spawnen in einer Struktur zu hindern, während es im Biom, das diese Struktur beherbergt, spawnen kann.

Praktische Anpassungsfälle

Fall 1: Pokémon exklusiv für ein Mod-Biom

Wenn Sie Terralith verwenden, können Sie Sneasel nur im Biom terralith:snowy_badlands erscheinen lassen:

{
  "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"]
      }
    }
  ]
}

Fall 2: Bedingter nächtlicher Spawn

Um Haunter nur nachts in Höhlen oder dunklen Bereichen erscheinen zu lassen:

{
  "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
      }
    }
  ]
}

Fall 3: Einen existierenden Spawn deaktivieren

Um einen nativen Cobblemon-Spawn zu deaktivieren, erstellen Sie eine JSON-Datei mit "enabled": false und derselben Kennung wie die ursprüngliche Regel. Cobblemon fusioniert Datapacks und Benutzerdatapacks haben Vorrang vor integrierten Daten:

{
  "enabled": false,
  "spawns": [
    {
      "id": "cobblemon:magikarp_river"
    }
  ]
}

Vorsicht: Sie müssen die genaue Kennung der ursprünglichen Regel kennen. Diese sind im Quellcode des Mods im offiziellen GitLab-Repository von Cobblemon einsehbar oder können durch Extrahieren der JAR-Datei des Mods abgerufen werden.

Spawns von Formen und Varianten

Cobblemon unterstützt Pokémon-Formen direkt in den Spawn-Dateien. Um eine bestimmte Form anzuzielen, fügen Sie die Form nach dem Namen des Pokémon hinzu:

"pokemon": "rattata form=alolan"

Sie können auch visuelle Aspekte oder Modifikatoren hinzufügen:

"pokemon": "pikachu aspects=[original_cap]"

Die im Feld pokemon akzeptierten Eigenschaften folgen der Syntax der Cobblemon-Befehle und ermöglichen die Angabe von Geschlecht, Level, besonderen Fähigkeiten oder jedem anderen vom Mod erkannten Attribut.

Bereitstellung auf einem Server

Nachdem Ihr Datapack erstellt und lokal getestet wurde, folgt die Bereitstellung auf einem Cobblemon-Server einer einfachen Prozedur:

  1. In ZIP komprimieren: Ihr Ordner mon-datapack/ muss in mon-datapack.zip komprimiert werden. Die Wurzel des Archivs muss direkt pack.mcmeta und den Ordner data/ enthalten.
  2. Im richtigen Ordner platzieren: auf einem Minecraft-Server werden Datapacks in world/datapacks/ platziert (oder world_nether/datapacks/ für den Nether).
  3. Das Datapack aktivieren: beim ersten Start oder nach einem /reload führen Sie /datapack enable "file/mon-datapack.zip" aus, falls das Datapack nicht automatisch aktiviert wird.
  4. Spawns neu laden: führen Sie /reload aus, damit Cobblemon alle Spawn-Dateien neu lädt. Ein Neustart des Servers ist nicht erforderlich.

Bei Panels wie PteroPilot oder Pterodactyl können Sie die ZIP-Datei direkt über den Web-Dateimanager oder SFTP im Ordner world/datapacks/ hochladen.

Laden des Datapacks überprüfen

So bestätigen Sie, dass Ihr Datapack richtig geladen und aktiv ist:

  • Befehl /datapack list: listet alle aktiven Datapacks auf. Die Ihrige muss mit ihrem Namen aufgeführt sein.
  • Server-Logs: beim Start oder während eines /reload zeigt Cobblemon Nachrichten an, die die Anzahl der geladenen Spawn-Regeln angeben.
  • Cobblemon-Befehl /cobblemon spawnpool (falls verfügbar): ermöglicht die Überprüfung des aktuellen Spawn-Pools an Ihrer Position.

Best Practices und Fallstricke zu vermeiden

Kennungskonflikte

Zwei Regeln mit derselben id überschreiben sich gegenseitig. Dies ist nützlich, um native Spawns zu deaktivieren, kann aber zu unerwartetem Verhalten führen, wenn zwei Datapacks auf Ihrem Server versehentlich dieselbe Kennung definieren. Verwenden Sie immer einen eindeutigen Namespace für Ihre Kennungen (z.B.: monserver:...).

Gewichte und Buckets

Das Gewichtssystem funktioniert pro Bucket, nicht global. Ein Pokémon mit einem weight von 100 im Bucket ultra_rare ist nicht unbedingt häufig: die Wahrscheinlichkeit, dass der Bucket ultra_rare ausgewählt wird, bleibt gering. Passen Sie zuerst den Bucket an, dann das Gewicht innerhalb des Buckets.

Nicht erkannte Biom-Tags

Wenn ein Biom-Tag in Ihrer Bedingung in Ihrer Instanz nicht vorhanden ist (z.B. ein Tag eines nicht installierten Mods), kann die Spawn-Regel möglicherweise schweigend ignoriert werden.


Gepostet am 23. Juni 2026 von _Xios_
https://pixelmongo.fr
Loading...