カスタムルールセットエディターを使えば、カードバトルRPGの遊び方を広げられます。ただし、エディターはデッキの適法性、キャラクターロール、カード効果、バトル処理、ゲームの進行、セーブデータに深く関わります。対応済みのオプションを決められた形式で選ぶための機能として設計し、バトルロジックの書き換えには使わないようにします。まずは機能を絞ったローカルエディターから始め、対戦前にデータを検証し、標準搭載のルールセットを安全な既定値として残します。

このガイドは、すでに動作するカードバトルRPGを拡張するためのものです。作例、カードプール、キャラクターロール、テスト結果は架空です。リポジトリ、バトル処理、デッキデータ、ビルド、プレイテストはいずれも利用できませんでした。以下のテスト案は、実施済みのテストや成功を確認した結果を示すものではありません。
設定項目を追加する前に現行ルールを記録する
作業前の状態をコミットするか、プロジェクトのコピーを作ってそこで作業します。標準ルールセット、対戦の開始手順、デッキの検証方法、キャラクターロールによるカードの制限、ターンや効果を処理するサービスを記録します。ルールと進行状況の保存先も確認します。ゲームをローカルで実行できない場合は、確認したコードを記録し、実行時の挙動は未確認とします。
エディターを追加しても維持する条件を列挙します。たとえば、カードのコストが負にならないこと、各キャラクターロールで使用できるカード系統が変わらないこと、ターン順が決定的であること、標準搭載モードの初期設定が維持されることなどです。これらの条件が当てはまるかどうかは、対象プロジェクトごとに確認します。すべてのカードバトルRPGに共通する条件ではありません。
| システム | 現状を確認する項目 | 原則として維持する事項 |
|---|---|---|
| バトル処理 | ターンと効果を処理する箇所、イベントの順序 | 処理の重複実装や置き換えを避ける |
| デッキルール | デッキ枚数、ロールとの適合性、同一カードの枚数上限 | 既存の適法性チェックを維持する |
| カードデータ | コスト、対象、効果の各フィールドとID | カードカタログ全体に反映される編集は行わない |
| モードとセーブデータ | 標準プリセット、進行状況、セーブデータのスキーマ | カスタム設定の下書きを分けて保存する |
AIには、実際に渡したファイルだけを調べ、ファイルごとの変更計画を出すように依頼します。現時点でルール検証とバトル実行をそれぞれ担うコードも特定させます。プロジェクト内でのルールの優先順位やデータの扱いの範囲を把握するまでは、広範囲にわたるコードの書き換え案を採用しないようにします。
ルールセットで設定できる範囲を絞る
まずは、対戦の長さ、デッキ制限のプリセット、対応済みのカード系統に関するルールを1つなど、既存のゲームが安全に扱える項目を少数選びます。各項目には、わかりやすいラベル、許容値、既定値、キャラクターロールとの相互作用を定めます。初期版のエディターでは、任意のスクリプトやカードの全数値フィールドを編集できるようにする必要はありません。
架空のAshen Archiveの例では、ローカルのカスタムプリセットで、対戦開始時のリソース上限、同一カードの枚数上限、指定したカード系統の使用可否を選びます。これは説明用の作例です。実際のプロジェクトがこれらの設定に対応しているとは限りません。各設定がバトルシステムでどのように機能するかを定義してから追加します。

ルールの優先順位を明文化します。全体に適用されるプリセットがあるカードを制限し、キャラクターロールにも制限がある場合は、どちらのルールを適用するか、両方を満たす必要があるかを決めます。カード単位でルールを上書きできるようにする場合は、変更可能なフィールドを定義し、カードIDを固定しておきます。エディター上の表示順で対戦の挙動が決まる設計は避けます。
ルールデータをバトル処理から分離する
既存の対戦準備処理や検証処理で読み取れるルールセットの値オブジェクトを使います。エディターはそのデータを更新し、ターンと効果は引き続き既存のバトル処理が実行します。ルールの編集とバトルの実行を分けておくと、カスタムルールでの対戦を既定のプリセットでの対戦と比較しやすくなります。
データレコードには、たとえばスキーマのバージョン、ルールセットID、作成元のゲームバージョン、対応するオプションの値、表示名を含めます。保存するのはデータだけにし、実行可能な式は含めません。検証済みの設定値は、ゲーム側で既存のルールに対応付けます。現在のバトル処理で扱えない値については、保存すれば効果が有効になるかのような表示を避けます。
GodotのJSONドキュメントには、JSONテキストを解析してVariantに変換する方法と、データをJSONにシリアライズし直す方法が記載されています。実行時のファイル操作ガイドでは、ファイルの読み書きに使うFileAccessが、ユーザーが用意したコンテンツを扱う例とともに説明されています。これらの資料で確認できるのはエンジンAPIの存在です。この作例のスキーマを規定したり、安全性を保証したり、動作するAshen Archiveの実装を示したりするものではありません。
プレイヤーが作成したデータを使う前に、バージョンとすべてのフィールドを検証します。将来のバージョンとの互換性に関する方針が定められていない限り、未知のルールIDは拒否します。プロジェクトで定めた下限と上限を適用し、カード系統の識別子が既知のものか、キャラクターロールのキーが有効かを確認します。任意のリソースをインスタンス化したり、ルールファイル内のテキストをコードとして評価したりしないようにします。ゲームがコンテンツのインポートに対応している場合は、その経路もテストし、制約を別途文書化します。
標準搭載モードと以前のセーブデータを維持する
カスタム設定の下書きは、正式なモードや進行状況とは別に保存します。プレイヤーがプリセットを編集するときはコピーを作り、元のプリセットが知らないうちに上書きされないようにします。実績、ランク戦、キャンペーンのセーブ状態を扱うゲームでは、カスタムルールでの対戦結果を区別します。カスタムルールでそれらの機能を利用できるかどうかは、製品の方針として明示します。
スキーマをバージョン管理し、作成元のゲームバージョンを記録します。フィールドを変更したときは、データを移行するか、理由を明示して読み込みを拒否するかを決めます。既存のセーブデータとユーザー作成のルールセットのコピーを使い、両方の対応をテストします。欠落したフィールドにゲームバランスを左右する値を適用する場合は、プロジェクトの責任者がその値を既定値として指定していることを確認します。
| 互換性を確認するケース | 確認事項 | 確認に使う資料・記録 |
|---|---|---|
| 古いカスタムファイル | このスキーマバージョンを移行できるか | 移行前にコピーしたテストデータ |
| 設定項目の欠落 | 既定値は文書化されているか | 既定値の適用を確認したテスト結果 |
| 未知のカード系統 | 読み込みを拒否するか、警告を出すか | エラーが画面に表示され、無断で別の値に置き換わらないこと |
| 標準プリセット | 編集によって標準搭載の値が変わる可能性はあるか | 元のプリセットのハッシュまたはコピー |
| カスタム対戦の結果 | キャンペーンやランキングに影響するか | 明文化されたモードの方針 |
初期版のエディターに必要な操作だけを実装する
最小限のインターフェースには、設定可能な項目の一覧、実際に適用されるルールのプレビュー、検証結果の概要、名前を付けて保存する機能、複製、既定値へのリセットが必要です。どの制約が選択中のキャラクターロールに由来するかを表示します。選択した項目がロールやカードセットと競合する場合は、バトル中にエラーになる前に、対戦開始前の画面で競合の内容を説明します。
単位を明示し、入力には許容範囲を設けます。プロジェクト内で裏付けが取れている場合に限り、設定項目に「バランス調整済み」や「競技向け」といったラベルを付けます。現在の標準搭載時の挙動を再現する既定のルールセットを用意し、簡単に戻せるようにします。詳細なフィールドは、実行時処理、UI、テストのすべてが対応できるまで非表示にしておきます。
生成イラストにある架空のインターフェースは、画面のコンセプトを示すためのものです。実際のルールセットエディターやゲームデータを示すものでも、検証の完了を示すものでもありません。実際のプロジェクトでは、既存のUIパターンに合わせてエディターを作り、別のルールサービスを立ち上げずに既存のサービスを再利用します。
最小限のパッチとロールバック手順を計画する
コードを取り込む前に、変更してよいファイルを書き出します。初回の変更を小さく抑えるなら、エディター画面1つ、ルールセットのモデルまたはアダプター、検証の入口、ローカルの下書き保存サービス、対象を絞ったテストなどが候補になります。プロジェクトを調べて依存関係上の変更が不可欠だと判明した場合を除き、バトル処理、カードデータベース全体、キャラクターロールのロジック、標準プリセット、キャンペーンのセーブデータ読み込み処理は現状のままにします。
差分全体をレビューします。AIには、変更したファイルを一つずつ説明し、既定値、イベント順序、カードの値、進行処理に関わるフックに変更があれば指摘するように依頼します。コードの変更範囲を、変更を許可したファイルの一覧と照合します。カードプール全体のバランス調整やバトル処理のリファクタリングにまで作業が広がったら、いったん止めて、別の変更として範囲を定めます。
作業はブランチか、変更を加えていないプロジェクトのコピーで行います。移行前に、既定のプリセットのサンプルと、旧形式のルールファイルがあればそのコピーを保存します。カスタムルールセットによって既存モードの挙動が変わったり、これまで使えていたデッキが予期せず無効になったりした場合は、変更前の状態に戻し、パッチの範囲を絞ります。ロールバックは、バージョン管理で実行できる具体的な操作として定めておきます。
コピーを使ってルールの組み合わせをテストする
組み合わせを試す前に、各設定項目を単独でテストします。次に、全体に適用される制限、ロール固有のデッキルール、同一カードの枚数上限、対戦設定が重なる場合を確認します。有効なカスタム対戦、無効なデッキ、未対応の値、旧スキーマ、フィールドの欠落、標準プリセットへのリセットを検証します。互換性やバランスが確保されていると述べる前に、実際のプロジェクトでこれらのケースを実行します。

| 確認項目の案 | 操作 | 記録する内容 |
|---|---|---|
| 既定ルールの回帰テスト | 標準搭載のルールで既知の対戦を開始する | ビルド、プリセット、デッキ、実際に観察したバトル処理の流れ |
| ロールとの適合性 | 制限対象のカードを各キャラクターロールで使う | 検証結果とその理由 |
| 許容範囲 | 許容範囲外の値を入力する | 入力の拒否と修正、通知なしに上限値や下限値に丸められないこと |
| 形式が不正なコンテンツ | フィールドが欠落しているデータ、無効なフィールドを含むデータ、将来のバージョンのフィールドを含むデータを読み込む | 安全に読み込みが拒否され、対処方法がわかるエラーが表示されること |
| 保存データの移行 | 旧形式のカスタムルールセットのコピーを読み込む | 移行結果、または文書化された読み込み拒否の取り扱い |
| ロールバック | 変更を加えていない元のブランチに戻す | 標準モードが以前と同じように動作すること |
この表はテスト計画であり、実施済みのテスト記録ではありません。テスト時は、ゲームのバージョン、ルールセットのバージョン、キャラクターロール、デッキID、操作、期待される挙動、実際の挙動、差異があればその内容を記録します。画面のモックアップだけでは、ルールの組み合わせが公平かどうかも、旧形式のセーブデータを引き続き読み込めるかどうかも確認できません。
よくある質問
カスタムルールセットエディターでは何を設定できるようにすべきですか?
ターン数の上限や、文書化された少数のカード制限など、既存のバトルシステムが安全に扱える対戦設定だけを公開します。設定値には許容範囲を設け、読み取ったときに意味がわかるようにします。初期版のエディターから、バトル処理の中核、キャラクターの成長処理、すべてのカード効果を書き換えられるようにするのは避けます。
カスタムルールでカードバトルに不具合が起きるのを防ぐにはどうすればよいですか?
既存のバトル処理を引き続き判定の基準とし、検証済みのルールセットオブジェクトを渡します>。全体ルール、キャラクターロール、カードの記載内容が関係する場合の優先順位を定義します。既定のルールで既知の対戦をテストし、エディター追加後の結果と比較します。
プレイヤーがカードのすべての値を編集できるようにすべきですか?
ダメージやコストを自由に変更したり、任意の効果スクリプトを設定したりできるようにする前に、対応済みの少数のオプションを許可リストにまとめます。数値には上下限を設け、未対応の組み合わせは拒否します。新しい設定項目は、ゲーム内でのルールが明確に定義され、他のルールとの相互作用を確認するテストケースが用意できた段階で追加します。
カスタムルールセットはどのように保存・更新すればよいですか?
バージョン付きのデータ形式を使い、作成元のゲームバージョンを記録し、ユーザー作成のルールを標準プリセットから分けて保存します。読み込み前にフィールドを検証し、古いデータを移行する場合と読み込みを拒否する場合の処理を明確にします。既存のセーブデータと公式モードが維持されるよう、変更はコピーでテストします。
AIで自分のゲームのカスタムカードルールセットのバランスを調整できますか?
AIは、提供されたルールの確認、相互作用の洗い出し、テストケースの下書きに役立ちます。ただし、実際のカードプール、バトルロジック、プレイデータがなければ、バランスが取れていることは証明できません。AIが生成した値は提案として扱います。ルールセットを共有する前に、差分全体を確認し、代表的な対戦を実行します。
バトル処理を置き換えずにルールの選択肢を追加する
標準搭載時の挙動を記録し、少数の設定項目を許可リストにまとめて公開します。バージョン付きのデータレコードを検証し、対応済みの値だけを既存のバトル処理に渡します。カスタム設定の下書きは、標準搭載のプリセットや古いセーブデータと分けて保存します。エディターが動作すると判断する前に、差分全体を確認し、コピーでテストし、変更前の状態に戻せる地点を残します。
別のカードバトルRPGの構想を試したいときは、SEELE AI Game Makerを使ってみてください。ゲームの企画を形にするためのツールで、既存プロジェクトの編集には対応していません。


