Cobblemonは、MinecraftのリソースとデータパックシステムにNetwork上でPokémonを統合するMinecraft Modで、最大限のカスタマイズを提供します。このアプローチの主な強みの一つは、Modのソースコードに触れることなくPokémonのスポーンロジックを完全に変更できることです。適切に構造化されたデータパックを使えば、サーバー管理者やModpackクリエイターが、どのPokémonがどのバイオームに、どのような条件で、どのくらいの頻度で出現するかを正確にコントロールできます。
この技術的なガイドは、CobblemonのカスタムスポーンシステムをマスターしたいCobblemonサーバーの管理者とModpackクリエイターを対象としています。データパックの構造化方法、スポーンファイルのJSONフォーマットの理解、そして本番サーバーへのデプロイについて見ていきます。
なぜデータパックでスポーンをカスタマイズするのか?
デフォルトでは、Cobblemonはすべての世代(Gen 1〜9)のPokémon用のスポーンファイルを生成します。これらのファイルは各種がワールドに出現できる条件を定義しています。しかし、カスタムスポーンデータパックの作成が正当化される状況があります:
- 希少性の再バランス:あるPokémonがバイオームの設定で多すぎたり少なすぎたりする場合。
- テーマスポーンの追加:Modpackの特定の海洋バイオームにのみ水生Pokémonを出現させる。
- 独占エリアの作成:特定のPokémonを特定のディメンションや構造物に限定する。
- 不要なスポーンの削除:バランス調整のために特定の種の出現を無効化する。
- サードパーティModとの同期:TerralithやBYGなどのModで追加されたバイオームをスポーンロジックに統合する。
Cobblemonのデータパックは/reloadコマンドによるホットリロードと完全互換で、デバッグとライブ調整が容易です。
Cobblemonデータパックの構造
標準的なMinecraftデータパックは正確なフォルダ階層に従います。Cobblemonの場合、スポーンファイルは特定のサブフォルダに配置されます。守るべき最小限の構造:
mon-datapack/
├── pack.mcmeta
└── data/
└── cobblemon/
└── spawn_pool_world/
├── bulbasaur.json
├── pikachu.json
└── ...
pack.mcmetaファイルには最低限以下が必要です:
{
"pack": {
"pack_format": 15,
"description": "Spawns personnalisés Cobblemon"
}
}
使用しているMinecraftバージョンに応じてpack_format値を調整します(1.20.xは15、1.21.xは18)。spawn_pool_worldフォルダはCobblemonがメインワールドのスポーンルールをロードするために監視するディレクトリです。対応するディメンション用にspawn_pool_netherとspawn_pool_endも存在します。
スポーンJSONファイルの解剖
各スポーンJSONファイルには同じPokémonまたは複数の種の複数のエントリを含めることができます。ピカチュウの注釈付き例:
{
"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"]
}
}
]
}
必須フィールド
- id:
namespace:説明名形式のルールの一意の識別子。データパック全体でユニークである必要があります。 - pokemon:Cobblemonに表示される小文字のPokémonの内部名(例:
bulbasaur、garchomp、iron_bundle)。 - type:スポーンの移動モード。可能な値:
land、water、water_surface、underwater、air、lava。 - context:追加のコンテキスト。
landにはgroundedを使用。飛行Pokémonにはflyingを使用。 - bucket:希少度カテゴリ。認識される値は
common、uncommon、rare、ultra_rare。 - level:スポーンするPokémonのレベル範囲、
"min-max"形式。 - weight:バケット内の相対ウェイト。同じバケット内の他のエントリよりこの値が高いほど、そのPokémonはより頻繁に出現します。
conditionブロック
conditionフィールドはカスタマイズの核心です。多くのパラメーターを受け入れます:
- biomes:バイオームまたはバイオームタグのリスト。タグは
#で始まります(例:#minecraft:is_ocean、#forge:is_hot、または#terralith:tropical_islandのようなModタグ)。 - structures:スポーンが許可される構造物のリスト(例:
minecraft:stronghold)。 - timeRange:時間帯。値:
any、day、night、dawn、dusk。 - minY / maxY:スポーンの最小・最大高度。
- minLight / maxLight:最小・最大光レベル(0〜15)。
- isRaining:ブール値、雨の時にスポーンを制限するにはtrue。
- isThundering:ブール値、雷雨時のみ。
- moonPhase:月相(0=満月、整数0〜7)。
- nearbyBlocks:スポーンポイント近くに存在する必要があるブロックのリスト。
anticonditionブロック
anticonditionフィールドはconditionと同じように機能しますが逆の意味です:anticonditionの条件の一つが満たされると、スポーンはブロックされます。これにより、例えばPokémonがその構造物を含むバイオームではスポーンを維持しながら、構造物内部にはスポーンしないよう設定できます。
実践的なカスタマイズ事例
事例1:Mod専用バイオームに限定したPokémon
Terralithを使用している場合、Sneaselを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"]
}
}
]
}
事例2:条件付き夜間スポーン
Gengarを夜間のみ、洞窟や暗いエリアに出現させるには:
{
"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
}
}
]
}
事例3:既存のスポーンを無効化する
Cobblemonのネイティブスポーンを無効化するには、"enabled": falseと元のルールと同じ識別子を持つJSONファイルを作成します。Cobblemonはデータパックをマージし、ユーザーデータパックが組み込みデータよりも優先されます:
{
"enabled": false,
"spawns": [
{
"id": "cobblemon:magikarp_river"
}
]
}
注意:元のルールの正確な識別子を知っている必要があります。これらはCobblemonの公式GitLabリポジトリのソースコードで確認するか、Mod JARを展開して調べることができます。
フォームとバリアントのスポーン
Cobblemonはスポーンファイルでのフォームを直接サポートしています。特定のフォームをターゲットにするには、Pokémon名の後にフォームを追加します:
"pokemon": "rattata form=alolan"
ビジュアルアスペクトや修正子を追加することもできます:
"pokemon": "pikachu aspects=[original_cap]"
pokemonフィールドで受け入れられるプロパティはCobblemonのコマンド構文に従い、性別、レベル、特別な技、またはModが認識するその他の属性を指定できます。
サーバーへのデプロイ
データパックがローカルで作成・テストされたら、Cobblemonサーバーへのデプロイは簡単な手順に従います:
- ZIPに圧縮:
mon-datapack/フォルダをmon-datapack.zipに圧縮します。アーカイブのルートにはpack.mcmetaとdata/フォルダが直接含まれる必要があります。 - 正しいフォルダに配置:Minecraftサーバーでは、データパックは
world/datapacks/(またはネザーの場合はworld_nether/datapacks/)に配置します。 - データパックを有効化:初回起動後または
/reload後、データパックが自動的に有効化されない場合は/datapack enable "file/mon-datapack.zip"を実行します。 - スポーンをリロード:
/reloadを実行してCobblemonにすべてのスポーンファイルをリロードさせます。サーバーの再起動は不要です。
PteroPilotやPterodactylなどのパネルでは、ウェブファイルマネージャーまたはSFTP経由でworld/datapacks/フォルダに直接ZIPをアップロードできます。
データパックのロードを確認する
データパックが正しくロードされてアクティブであることを確認するには:
- コマンド
/datapack list:すべてのアクティブなデータパックをリスト表示。あなたのデータパックが名前付きで表示される必要があります。 - サーバーログ:起動時または
/reload時に、CobblemonはロードされたスポーンルールNUMBERを示すメッセージを表示します。 - Cobblemonコマンド
/cobblemon spawnpool(利用可能な場合):現在の位置でのスポーンプールを検査できます。
ベストプラクティスと避けるべき落とし穴
識別子の競合
同じidを持つ2つのルールは相互に上書きします。これはネイティブスポーンを無効化するのに便利ですが、サーバーの2つのデータパックが誤って同じ識別子を定義すると予期せぬ動作が発生する場合があります。識別子には常にユニークなネームスペースを採用してください(例:myserver:...)。
ウェイトとバケット
ウェイトシステムはバケット単位で機能し、グローバルではありません。ultra_rareバケットでweightが100のPokémonが必ずしもcommonになるわけではありません:ultra_rareバケットが選択される確率は低いままです。まずバケットを調整し、次にバケット内のウェイトを調整してください。
認識されないバイオームタグ
conditionにあるバイオームタグがインスタンスに存在しない場合(例えば、インストールされていないModのタグ)、スポーンルールはサイレントに無視されるかエラーを生成する場合があります。使用するタグを定義するModが必ずサーバーに存在することを確認してください。
パフォーマンス
多数の複雑なスポーンルールはサーバーパフォーマンスに若干影響する可能性があります、特に近くのブロック検索を含む条件の場合。nearbyBlocksの使用は本当に必要なケースに限定し、本番環境にデプロイする前にSparkのようなプロファイリングツールでパフォーマンスをテストしてください。
さらに深く
基本をマスターしたら、ゲームイベントにリンクした条件付きスポーン、CobblemonのAPIを通じたサーバープラグインとの統合、または専用スポーンルールを持つPokémonボスの作成などのCobblemonの高度な機能を探索できます。管理の全体的なアプローチのためにCobblemonサーバーの完全設定ガイドもご覧ください。
CobblemonのデータパックシステムはMinecraftのPokémon Mod中で最も柔軟なものの一つです。JSON構造とconditionパラメーターを理解することに時間をかければ、バランス調整のためにModの更新に依存することなく、サーバーのPokémonエコシステムを完全にコントロールできます。