Cobblemon to mod Minecraft, który natywnie integruje Pokémon w grze, opierając się na systemie zasobów i datapacków Minecraft, aby zapewnić maksymalną personalizację. Jedną z głównych zalet tego podejścia jest możliwość całkowitej modyfikacji logiki spawn'u Pokémonów bez ingerencji w kod źródłowy modu. Dzięki dobrze strukturyzowanemu datapackowi administrator serwera lub twórca modpacku może precyzyjnie kontrolować, które Pokémon się pojawiają, w jakich biomach, pod jakimi warunkami i z jaką częstotliwością.

Ten przewodnik techniczny skierowany jest do administratorów serwerów Cobblemon i twórców modpacków, którzy chcą opanować system niestandardowych spawnów modu. Zobaczym y razem, jak strukturyzować datapack, zrozumieć format JSON plików spawnów i wdrożyć wszystko na serwer produkcyjny.

Dlaczego personalizować spawny za pomocą datapacku?

Domyślnie Cobblemon generuje własne pliki spawnów dla wszystkich generacji Pokémon (Gen 1 do Gen 9). Pliki te definiują warunki, w których każdy gatunek może pojawić się na świecie. Jednak kilka sytuacji uzasadnia utworzenie niestandardowego datapacku spawnów:

  • Ponowne zbalansowanie rzadkości: Pokémon może być zbyt pospolity lub zbyt rzadki w konfiguracji biomów.
  • Dodanie tematycznych spawnów: Pokémon wodne pojawiają się tylko w określonych biomach oceanicznych Twojego modpacku.
  • Tworzenie stref ekskluzynych: rezerwacja określonych Pokémon dla poszczególnych wymiarów lub struktur.
  • Usuwanie niepożądanych spawnów: wyłączenie pojawiania się określonych gatunków ze względów balansowania.
  • Synchronizacja z modami trzecich stron: integracja biomów dodanych przez mody takie jak Terralith lub BYG w logikę spawn'u.

Datapacki Cobblemon są w pełni kompatybilne z przeładowaniem na gorąco za pomocą komendy /reload, co ułatwia debugowanie i dostosowania na bieżąco.

Struktura datapacku Cobblemon

Standardowy datapack Minecraft podąża za precyzyjną hierarchią folderów. Dla Cobblemon pliki spawnów umieszcza się w określonym podfolderze. Oto minimalna struktura do zachowania:

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

Plik pack.mcmeta musi zawierać co najmniej:

{
  "pack": {
    "pack_format": 15,
    "description": "Niestandardowe spawny Cobblemon"
  }
}

Dostosuj wartość pack_format do wersji Minecraft, którą używasz (15 dla 1.20.x, 18 dla 1.21.x). Folder spawn_pool_world to katalog, który Cobblemon monitoruje, aby załadować reguły spawnów w głównym świecie. Istnieją również spawn_pool_nether i spawn_pool_end dla odpowiednich wymiarów.

Anatomia pliku JSON spawnów

Każdy plik JSON spawnów może zawierać kilka wpisów dla tego samego Pokémon lub dla wielu gatunków. Oto skomentowany przykład dla 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"]
      }
    }
  ]
}

Pola istotne

  • id: unikalny identyfikator reguły w formacie namespace:nazwa_opisowa. Musi być unikalny w całym datapacku.
  • pokemon: wewnętrzna nazwa Pokémon w małych literach, taka jak pojawia się w Cobblemon (np: bulbasaur, garchomp, iron_bundle).
  • type: tryb ruchu spawnu. Możliwe wartości: land, water, water_surface, underwater, air, lava.
  • context: kontekst dodatkowy. Dla land, użyj grounded. Dla latających Pokémon użyj flying.
  • bucket: kategoria rzadkości. Rozpoznawane wartości to common, uncommon, rare i ultra_rare.
  • level: zakres poziomów spawnowanego Pokémon w formacie "min-max".
  • weight: względny ciężar w buckecie. Im wyższa wartość w stosunku do innych wpisów tego samego bucketu, tym częściej pojawia się Pokémon.

Blok condition

Pole condition jest sercem personalizacji. Akceptuje wiele parametrów:

  • biomes: lista biomów lub tagów biomów. Tagi zaczynają się od # (np: #minecraft:is_ocean, #forge:is_hot, lub tagi modów takie jak #terralith:tropical_island).
  • structures: lista struktur, w których spawn jest dozwolony (np: minecraft:stronghold).
  • timeRange: zakres czasowy. Wartości: any, day, night, dawn, dusk.
  • minY / maxY: minimalna i maksymalna wysokość spawnu.
  • minLight / maxLight: minimalny i maksymalny poziom światła (0-15).
  • isRaining: wartość logiczna, true aby ograniczyć spawn do deszczu.
  • isThundering: wartość logiczna, dla burz tylko.
  • moonPhase: faza księżyca (0 = pełnia, liczba całkowita 0-7).
  • nearbyBlocks: lista bloków, które muszą być obecne w pobliżu punktu spawnu.

Blok anticondition

Pole anticondition działa jak condition, ale w negatywie: jeśli któryś z warunków anticondition zostanie spełniony, spawn jest blokowany. Pozwala to na przykład uniemożliwić Pokémon spawnnięcia się wewnątrz struktury, pozwalając mu spawnować się w biomie, który zawiera tę strukturę.

Praktyczne przypadki personalizacji

Przypadek 1: Pokémon ekskluzywy dla bioma modu

Jeśli używasz Terralith, możesz sprawić, że Sneasel pojawia się tylko w biomie 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"]
      }
    }
  ]
}

Przypadek 2: Spawn nocny warunkowy

Aby sprawić, że Haunter pojawia się tylko w nocy, w jaskiniach lub ciemnych obszarach:

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

Przypadek 3: Wyłączenie istniejącego spawnu

Aby wyłączyć natywny spawn Cobblemon, utwórz plik JSON z "enabled": false i tym samym identyfikatorem co reguła oryginalna. Cobblemon łączy datapacki, a datapacki użytkownika mają pierwszeństwo przed danymi wbudowanymi:

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

Uwaga: musisz znać dokładny identyfikator reguły oryginału. Te można znaleźć w kodzie źródłowym modu w oficjalnym repozytorium GitLab Cobblemon lub wypakowując JAR modu.

Spawny form i wariantów

Cobblemon obsługuje formy Pokémon bezpośrednio w plikach spawnów. Aby kierować określoną formę, dodaj formę po nazwie Pokémon:

"pokemon": "rattata form=alolan"

Możesz również dodać aspekty wizualne lub modyfikatory:

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

Właściwości akceptowane w polu pokemon następują po składni poleceń Cobblemon i pozwalają określić płeć, poziom, specjalne zdolności lub dowolny inny atrybut rozpoznawany przez mod.

Wdrożenie na serwerze

Po stworzeniu i przetestowaniu datapacku lokalnie, wdrożenie na serwerze Cobblemon następuje według prostej procedury:

  1. Kompresowanie do ZIP: Twój folder mon-datapack/ musi być skompresowany do mon-datapack.zip. Root archiwum powinien zawierać bezpośrednio pack.mcmeta i folder data/.
  2. Umieszczenie w właściwym folderze: na serwerze Minecraft datapacki umieszcza się w world/datapacks/ (lub world_nether/datapacks/ dla Nether).
  3. Aktywacja datapacku: przy pierwszym uruchomieniu lub po /reload, wykonaj /datapack enable "file/mon-datapack.zip", jeśli datapack nie jest aktywowany automatycznie.
  4. Przeładowanie spawnów: uruchom /reload, aby Cobblemon przeładował wszystkie pliki spawnów. Nie jest wymagany żaden restart serwera.

Na panelach takich jak PteroPilot lub Pterodactyl możesz przesłać ZIP bezpośrednio przez webowy menedżer plików lub przez SFTP w folderze world/datapacks/.

Weryfikacja załadowania datapacku

Aby potwierdzić, że Twój datapack jest prawidłowo załadowany i aktywny:

  • Komenda /datapack list: wyświetla listę wszystkich aktywnych datapacków. Twój musi się tam pojawić z jego nazwą.
  • Dzienniki serwera: przy uruchamianiu lub podczas /reload Cobblemon wyświetla komunikaty wskazujące liczbę załadowanych reguł spawnów.
  • Komenda Cobblemon /cobblemon spawnpool (jeśli dostępna): pozwala na inspekcję aktualnej puli spawnów w Twojej pozycji.

Najlepsze praktyki i pułapki do uniknięcia

Konflikty identyfikatorów

Dwie reguły o tym samym id nawzajem się przeciążają. Jest to przydatne do wyłączania natywnych spawnów, ale może powodować nieoczekiwane zachowania, jeśli dwa datapacki na Twoim serwerze przypadkowo definiują ten sam identyfikator. Zawsze przyjmuj unikalną przestrzeń nazw dla swoich identyfikatorów (np: monserveur:...).

Ciężar i buckety

System wagi działa per bucket, a nie globalnie. Pokémon z weight 100 w buckecie ultra_rare niekoniecznie będzie pospolity: prawdopodobieństwo wybrania bucketu ultra_rare pozostaje niskie. Najpierw dostosuj bucket, a następnie ciężar w ramach bucketu.

Nierozpoznane tagi biomów

Jeśli tag bioma w Twoim warunku nie istnieje w Twojej instancji (na przykład tag modu, który nie jest zainstalowany), reguła spawnów może być bezgłośnie ignorowana.


Dodany dnia 23 czerwca 2026 przez _Xios_
https://pixelmongo.fr
Loading...