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żyjgrounded. Dla latających Pokémon użyjflying. - bucket: kategoria rzadkości. Rozpoznawane wartości to
common,uncommon,rareiultra_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:
- Kompresowanie do ZIP: Twój folder
mon-datapack/musi być skompresowany domon-datapack.zip. Root archiwum powinien zawierać bezpośredniopack.mcmetai folderdata/. - Umieszczenie w właściwym folderze: na serwerze Minecraft datapacki umieszcza się w
world/datapacks/(lubworld_nether/datapacks/dla Nether). - Aktywacja datapacku: przy pierwszym uruchomieniu lub po
/reload, wykonaj/datapack enable "file/mon-datapack.zip", jeśli datapack nie jest aktywowany automatycznie. - 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
/reloadCobblemon 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.