リズムのタイミングを崩さずにプレイヤー向けレベルエディターを追加する方法

拍のタイミング、再生、スコア、既存の譜面を維持したまま、プレイヤー向けの譜面エディターを設計する方法。ローカルでの譜面作成、プレビュー、検証、変更を元に戻す手順を解説します。

Seele Editorial Team更新日 2026年11月16日

プレイヤー向けのレベルエディターがあれば、リズムゲームをより長く楽しんでもらえます。ただし、その追加は譜面形式、オーディオクロック、スコア計算、入力、セーブデータ、場合によってはコミュニティ機能にも関わります。再生の基準は既存のシステムに置いたままにしましょう。まずはローカルでの譜面作成に絞り、楽曲の拍に沿ったグリッドにイベントを配置し、譜面をプレビューして検証し、バージョン付きの下書きとして保存できるようにします。既に配信されているステージの再生方法は変えません。

架空のリズムゲームのエディターに、拍グリッド、ノーツレーン、コンパクトな再生プレビューが表示されている。
Pulse Harborとこのエディター画面は架空のものです。実際のリズムゲームでのテストは行っていません。

この記事では、既存のプロジェクトにエディターを追加する方法を扱います。リズムエンジンを置き換える手順ではありません。例に登場するゲーム、楽曲、画面、譜面データ、結果はすべて架空です。プロジェクトファイル、楽曲、パーサー、ビルドはいずれも確認できるものがありませんでした。チェックリストに記載しているのは検証案であり、テスト結果ではありません。

エディターが関わる範囲を決める

未コミットの変更がない状態から始め、すでに正常に再生できることが分かっている譜面を1つ、基準として記録します。オーディオクロック、譜面ローダー、テンポマップ、入力の割り当て、ノーツレーン、スコア計算のルール、楽曲のオフセット、保存先のパス、進行状況を管理するフラグを確認し、記録してください。ビルドを実行できない場合は、提供されたファイルだけを調べ、実行時の挙動は未確認であることを明記します。

初回リリースはローカルで使える基本機能に絞ります。プレイヤーが利用可能な楽曲を選び、イベントを配置・移動し、編集を元に戻し、区間をプレビューできるようにします。下書きの保存と再読み込み、検証メッセージの確認も必要です。オンライン共有、評価、モデレーション、サブスクリプション、端末間の同期は別に計画できます。同時に追加すると、タイミングに問題が生じたときに原因を切り分けにくくなります。

既存のシステム作業前に記録すること基本の保護方針
音声とタイミングクロックの参照元、遅延補正オフセット、テンポの変化再生クロックを置き換えない
実行時の譜面処理ファイルのフィールド、イベントの順序、ローダーの挙動配信済みの譜面との互換性を維持する
スコア計算と入力判定時間幅、アクション名、レーンの対応関係プレビューでも同じルールを使う
ゲームの進行アンロック状況、クリア状況、保存済みスコア下書きと正式なプレイ結果を分ける

AIには、編集に着手する前に実際のファイルを調べ、変更計画を出すように依頼します。変更を許可するファイルの一覧と、変更しないシステムの一覧も求めましょう。「レベルエディターを追加して」という依頼だけでは範囲が広すぎて、新しいタイミングモデルを導入したり、正常に動いている譜面ローダーを置き換えたりする可能性があります。対象となる譜面形式とローカル保存先をそれぞれ1つに絞り、既存の再生コードを呼び出す小さな画面を指定すると、変更範囲を抑えやすくなります。

楽曲内の位置を基準にイベントを配置する

イベントの位置は、ブロックをドラッグした時点の実時間のタイムスタンプではなく、楽曲のどこに置くかで表します。既存のランタイムが拍位置を使うなら、その座標を維持します。秒単位で扱っているなら、変換を担うアダプターを明示的に設け、既存のテンポマップに照らして変換結果を確かめます。どのテンポ区間でも、エディターの目盛りと実際にプレイする譜面の位置が一致しなければなりません。

イベントのデータには、たとえば変更されないID、レーン、小節、拍、拍の分割位置、イベント種別、任意の長さを持たせることが考えられます。フィールドは必要最小限に絞り、プロジェクトで実際に使われているローダーに合わせます。テンポ変化を譜面形式に含めるのは、ランタイムがすでに対応している場合か、機能の計画に対応の追加が明記されている場合に限ります。スクリーンショットだけを見たり、提供されていないサンプル譜面を想定したりして、スキーマ全体を推測してはいけません。

架空の譜面タイムラインでは、各ノーツイベントが拍を分割した目盛りに揃い、その下の別の帯に音声波形が表示されている。
拍位置と音声波形はそれぞれ異なる役割を持ちます。タイミングの基準は引き続き既存の再生クロックです。

Godotの安定版ドキュメントには、FileAccessや関連APIを使って実行時にファイルを読み書きする方法が記載されており、ユーザーが提供したコンテンツを扱う例もあります。データパスのガイドでは、ユーザーデータを永続的に保存するためのuser://が説明されています。これらの資料で確認できるのは、エンジンが提供するファイル入出力の選択肢です。リズムゲームの譜面形式を指定するものでも、安全性を保証するものでも、Pulse Harborで実装を検証したことを示すものでもありません。

各イベントに固定の識別子を付け、1つのイベントを移動したり削除したりしても、ほかのイベントの番号が振り直されないようにします。再生時の並び順が常に同じになるようにし、同時に鳴るノーツの扱いを定め、任意フィールドの欠落と必須フィールドの無効な値を区別してください。プロジェクトがすでに譜面をリソースとして保存している場合は、別のデータ構造で既存形式を迂回せず、その形式に対応するエディター用アダプターを作ります。

編集の結果が分かりやすく、元に戻せるようにする

拍グリッドには、保存されるタイミングに影響しないズーム操作を用意します。クリックでイベントを追加し、ドラッグで移動し、選択中のイベントを見分けて削除できるようにします。「元に戻す」操作では直前の編集を取り消せるようにします。キーボードショートカットは、ゲームの既存アクションと競合しないようにしてください。現在の小節、拍の分割、選択中のレーン、再生ヘッドを表示し、作成者が自分の操作で何が変わるか分かるようにします。

下書きの操作が正式なクリア状況に影響しないようにします。プレビューでゲームの進行状況を更新したり、配信済みの譜面を上書きしたり、ランキングにスコアを送信したりしてはいけません。下書きは専用フォルダーに保存し、プレイヤーが既存のカスタム譜面を開くときは元のファイルを残します。同梱の楽曲にしか対応していないゲームなら、エディターで選べるのもその楽曲に限り、任意の音声を取り込めるかのような表示は避けます。

架空のPulse Harborでは、エディターがバージョン番号付きの譜面の下書きをローカルに保存し、既存のプレビューシーンを再利用する想定です。これは構成案であり、実在するファイルや実際に組み込んだ結果を報告するものではありません。特に譜面の読み込みがリソースのインポート処理と結び付いている場合は、プロジェクトに合わせて機能の境界を引き直す必要があるかもしれません。

プレビュー前にローカルの譜面ファイルを検証する

プレイヤーが作成したファイルは、実行する命令ではなく、検証対象のデータとして扱います。ファイルのバージョン、必須プロパティ、レーン識別子、イベント種別、数値の範囲、IDの重複、参照先の楽曲を確認してください。プロジェクトの上限を超えた譜面や、利用できないリソースを参照する譜面は受け付けません。エラーメッセージでは問題のあるイベントやフィールドを示し、作成者がどう直せばよいかを分かりやすく説明します。

警告と、処理を続けられないエラーを分けます。たとえば、ノーツの密度が通常の範囲を外れていても有効なら、警告で済む場合があります。一方、レーン指定が欠けていたり拍位置が無効だったりしてランタイムが処理できない場合は、プレビューを止めます。ファイルサイズとイベント数にはプロジェクトに合った上限を設け、空のファイル、途中で途切れたファイル、旧バージョンのファイル、形式が不正なファイルに対するパーサーの挙動をテストします。上限は対象ゲームの設計に基づいて決めるものであり、どのゲームにも通用する数値を思いつきで設定してはいけません。

検証項目確認すること問題が見つかったときの処理
バージョンエディターはこのバージョンのスキーマを読み込めるか更新方法、または読み込めない理由を示す
楽曲の参照先この楽曲は利用可能な楽曲一覧にあるか別の音声に無断で差し替えない
イベントの座標レーンと拍の値はサポート範囲内か無効なイベントを示す
イベントの識別子IDは一意で、変更されずに維持されるか安全に修正する方法を提示するか、保存を止める
ファイルの上限内容はプロジェクトで定めた上限内か読み込み前に、定められた方法でエラーとして処理する

プロジェクトへの変更を最小限に抑える計画を立てる

パッチを取り入れる前に、変更内容をファイル単位の計画と照らし合わせます。初回の実装範囲を絞れば、エディターのシーンとコントローラー、譜面データのアダプター、ローカルの下書きを扱うサービス、数件のテストで済む場合があります。全曲を知らないうちに書き換えたり、判定時間幅やオーディオドライバーを変更したり、下書きの譜面を正式なゲーム進行に組み込んだりしないようにします。

AIには差分の全体を示し、互換性について何を前提にしたか、この機能をどう取り外せるかを説明するように依頼します。作業はブランチ上かプロジェクトのコピーで行い、基準となる譜面と比較用の録画・録音は変更せずに残します。データのバージョンを上げる必要があるなら、移行計画を作り、プレイヤーのデータに手を加える前にコピーした譜面でテストします。再生の挙動が変わった場合は、基準の状態に戻して原因を切り分けます。

プロジェクトのコピーでタイミングのずれと既存機能への影響を確かめる

エディター画面が開くことを確かめるだけでは不十分です。正常に再生できると分かっている同じ譜面を使い、変更前後を比較します。開始付近のノーツ、曲の中盤、テンポの切り替わり、終盤を確認してください。エディターの再生ヘッド、プレビュー音声、ノーツのアニメーション、入力のヒット判定、スコア計算が同じタイミング基準を使っていることを確かめます。グリッドが見た目で揃っていても、音声の遅延やプレイ時のタイミングが正しいとは限りません。

架空のローカル譜面プレビューに、プレイ画面と、拍とのずれ、ファイルのバージョン、イベントの範囲を確認するチェックリストが並んでいる。
検証パネルはイメージです。アプリケーションのタイミングやパーサーはテストしていません。
確認項目の案操作記録すること
基準の譜面旧ビルドで動作が分かっている譜面を1つ再生するビルド、楽曲、想定されるタイムスタンプ
エディターでの保存と再読み込みイベントを配置して下書きを保存し、開き直してプレビューするファイルに書き出されたイベントと、差異があればその内容
テンポの切り替わりテンポが変わる前後にイベントを配置する拍、音声の再生位置、再生ヘッドの位置
不正な形式のファイル欠落したフィールド、無効なフィールド、未対応のフィールドを試すクラッシュせず、エラーが明確に示されるか
既存機能への影響変更していない基準譜面をもう一度プレイするタイミング、スコア計算、入力、ゲームの進行
ロールバック機能を追加したブランチを取り除くか、コピーから復元する元の譜面を引き続きプレイできるか

この表は検証案であり、タイミングの正確さが維持されたことを示す証拠ではありません。実際にテストを行う際は、プロジェクトのバージョン、オーディオ機器、譜面、オフセット、具体的な操作、想定した挙動、実際の挙動、既存機能に生じた不具合を記録します。生成した画面のモックアップを根拠に、エディターや検証パネルが実在すると主張してはいけません。

公開とコミュニティでの共有は別に計画する

長期的に譜面の共有を目指すなら、まずモデレーション、通報、削除、所有権、楽曲のライセンス、ストレージの上限、ゲームのバージョン間の互換性について方針を定めます。ローカルエディターを作っただけで、安全なオンライン譜面ライブラリができるわけではありません。必要なサービスと方針を整え、テストするまでは、ユーザーが作成した譜面を公開したりダウンロードしたりできるとは案内しないでください。

既存のゲームとは別に、リズムゲームのコンセプトを試したい場合は、SEELE AI Game Makerを使ってみてください。ゲームのコンセプトを試すためのツールであり、既存のプロジェクトを編集するエディターではありません。

よくある質問

リズムゲームのレベルエディターでは、プレイヤーに何ができるとよいですか?

まずは譜面の作成とプレビューに必要な操作を揃えます。楽曲を選び、拍グリッドにイベントを置き、編集したり元に戻したりし、下書きを保存して検証できるようにします。ローカルで安定して譜面を作れるようになるまでは、公開、共有、モデレーションは別の機能として扱います。

譜面イベントの位置は秒と拍のどちらで保存すべきですか?

ゲームにすでにテンポマップがあるなら、小節、拍、拍の分割位置といった、楽曲内の位置を安定して表せる座標を優先します。再生時刻への変換には既存のタイミングシステムを使います。現在のオーディオクロックとオフセットのルールを維持したうえで、テンポの変化や区間の境目付近にあるノーツをテストします。

リズムゲームの再生の挙動を変えずにエディターを追加するには?

現在の譜面ローダー、オーディオクロック、スコア計算、入力、ノーツレーンを基準にします。エディターでは、ランタイムが使っている形式でデータを作成するか、バージョンを管理するアダプターを介して作成します。動作が分かっている譜面で変更前後を比較し、イベントのタイミングがずれたら変更を元に戻します。

プレイヤーが作成した譜面はどのように検証すべきですか?

プレビュー前に、ファイルのバージョン、必須フィールド、楽曲の参照先、イベント種別、拍の範囲、IDの重複、未対応の値を確認します。修正できる問題はエディターに表示し、形式が不正なコンテンツは安全に拒否します。スキーマのチェックリストだけでは、実際のパーサーが悪意のあるファイルをすべて処理できることの証明にはなりません。

AIで既存のリズムゲームにレベルエディターを組み込めますか?

AIは、提供されたファイルの確認、変更範囲を絞ったパッチの提案、検証ケースの作成を手伝えます。ただし、実際のプロジェクトとテストなしに、タイミングや互換性は確認できません。変更を許可するファイルの一覧、変更を加えていない基準譜面、拍のタイミングに関する期待値、元に戻すためのコミットを渡し、差分全体を確認してください。

再生処理を書き換えずに譜面作成機能を追加する

タイミングの管理は現在のリズムエンジンに任せます。機能を絞ったローカルエディターを追加し、楽曲内の位置で表したイベントをバージョン付きのデータとして保存し、プレビュー前に検証します。下書きは配信済みの譜面や正式なスコアから切り離してください。差分を確認し、プロジェクトのコピーで動作が分かっている譜面をテストし、変更を元に戻せる地点を残します。実際のゲームでテストするまでは、結果はすべて未確認として扱います。

参考資料

SEELE AI

このガイドをプレイできる作品に。

作りたいものを明確にし、Seele AI ワークスペースで改善を重ねましょう。

制作を始める