Common Game System

入門者のためのリリースです — CGS を初めて見る人が数分で使い始められるよう、ドキュメントとパッケージングを作り直しました。すべてのランタイムフォルダとリファレンスドキュメントが平易な英語名になり(Bootstrap、SaveLoad、Tween、…)、フォルダ名・ファイル名から旧内部番号のプレフィックスが消えました。目に見えるデモシーンを Assets/CommonGameSystem.Core/Demo/MotionLab.unity に同梱 — 開いて Play を押すだけ、セットアップ不要です。Tween のイージングギャラリー、Tween シーケンスのショーケース、スケジューラのタイマー、そしてゲームプレイを静止させながら UI の時計は回り続ける Time Scale スライダーを収録し、必要なのは組み込みの uGUI パッケージだけです。Welcome ウィンドウは「60 秒でデモを試す」を軸に作り直しました: パッケージバージョンごとに 1 回自動で開き、Tools > Common Game System > Welcome と Window > Common Game System > Welcome の両方から開けて、サンプルのワンクリックインポート、クイックリンク(PDF マニュアル / ドキュメント / 変更履歴 / モジュールリファレンス)、折りたたまれた環境チェックを備えています。サンプルは 6 種になりました — UI Panel Stack、Save/Load + Seeded Random、Command Console は実行できるシーン、Scene Flow、Localization、RPG Starter は手順つきのスクリプトテンプレートです。(Motion Lab はサンプルから常時表示のデモへ昇格しました。)目次と注釈付きスクリーンショットを備えたページ形式の PDF マニュアルを Documentation/CGS-Manual.pdf に同梱し、AI アシスタント用ファイルは Documentation/AI/ へ移動しました。2,600 件以上の自動テストは引き続きパッケージ内に同梱されますが、いまは非表示のままです — Welcome ウィンドウからワンクリックでインポートするまで、購入者のプロジェクトにコンパイルされることはありません。サービスは変わらず 23 個、サードパーティ依存は 0 個です。

ランタイムアセンブリを 7 本に分割したリリースです。単一だった CommonGameSystem.Core ランタイムアセンブリは 7 本になりました — Core(パッケージ依存ゼロの 18 サービスに、純粋な UI コントラクトを加えたもの)、Input、UI、Localization、Assets、AddressableScene、Bootstrap — 実際に使うものだけを参照できます。破壊的変更となるのは独自の asmdef を持つプロジェクトだけで、変わるのも references リストだけです: ソースの変更はなく、名前空間はすべて CommonGameSystem.Core のまま、Assembly-CSharp のプロジェクトには影響しません。使わない UPM パッケージ(Addressables / Input System / UGUI)の削除も正式にサポートされました: 依存アセンブリは — 同梱のテスト / サンプルアセンブリも含めて — defineConstraints により自動的に外れ、Bootstrap はその登録をスキップします(UI Panel Stack は NullPanelStack にフォールバック)。3 パッケージともデフォルトでは引き続き自動インストールされます。link.xml はモジュール単位になり、オプションアセンブリの IL2CPP 保存エントリはそのアセンブリと一緒に外れます。シーンロードのキャンセルには正直なコントラクトを与えました(動作としては破壊的変更です): 従来の「アクティベーションをブロックし、新しいシーンの OnEnable は決して走らない」という約束は、そもそも実装不可能でした — Unity はアクティベートされていないロードの後ろで AsyncOperation キュー全体を停止させるため、一度のキャンセルがそれ以降のすべてのシーンロードを、プロセスが生きている間ずっと凍結させていたのです。現在は、バックエンドへロードが発行される前のキャンセルは本当のキャンセルになります。発行後のキャンセルではシーン遷移は完了し、アクティベーションの前 — 遷移元シーンの購読者がまだ存在する時点 — で SceneLoadCanceled が publish されます。修正: エディタの Play 終了時の後始末が、何もしないまま静かに終わっていました(LIFO の Dispose チェーンより先にレジストリがクリアされ、実績のディスクへのフラッシュとアセットハンドルの解放も飛ばされていました)。SFX の自動解放が、実時間で再生されるオーディオに対してスケール後のゲーム時間で走っていました(現在は unscaled 時間で、ピッチも考慮します)。TimeServiceTicker は [DefaultExecutionOrder(-100)] を宣言するようになり、あなたのスクリプトがフレームの delta を巡ってこれと競合することはなくなりました。IConfiguration.Set<T> は、渡したインスタンスをその場でクランプする代わりに、プライベートなコピーを保存します。追加: InputServiceOptions.AlwaysEnabledMaps(コンテキスト切り替えをまたいで UI / Debug のアクションマップを有効なまま保てます)、IPanelVisual(オプトインのパネルフェードトランジションに加え、オプションがずっと約束していたモーダル背景)、GraphicsSettingsApplier(品質 / 解像度 / フルスクリーン / vSync / フレームレート上限が、実際に Unity へ届くようになりました)、ISaveStorageBackend(セーブの保存媒体を注入できます — 暗号化セーブ、任意の保存場所、Steam Cloud。新しい Steam レシピドキュメント付き)、FileLogger(再起動後も残る、オプトインのローテーション式ファイルログ)、さらに遅延書き込みの設定は、フォーカスを失ったときにもフラッシュされるようになりました。サービスは引き続き 23 個、サードパーティ依存は 0 個。自動 EditMode テストは 2,665 件です。

初回の公開リリースです。未公開に終わった 1.14.0 ビルド以降、Core のサービスが 3 つ増えました(20 → 23)。いずれも変わらず Bootstrap.Run() 1 回で立ち上がります: Addressable Scene(IAddressableSceneService — Addressables カタログからの非同期な Additive シーンのロード / アンロード、キー単位の参照カウント、実行時データに対しては例外を投げない設計)、Deferred Event Queue(IDeferredBus — イベントをいまキャプチャして、あとから任意の Flush() のタイミングで publish)、Command Registry(ICommandRegistry — 登録 / トークナイズ / 実行、履歴、プレフィックス補完を備えたランタイムコマンドの中核。ゲーム内コンソールの UI 自体はご自身で作る前提です)。サンプルはインポート可能な 7 種に増え、うち 4 種は開いてそのまま実行できる完成済みシーンです: Motion Lab(イージング 8 種を並べた tween ギャラリー、ウェイポイントのシーケンス、そして Clock 分離の見せ場 — ゲームプレイの TimeScale を 0 にするとギャラリーは止まり、UI のスピナーだけが動き続けます)、Save/Load + Seeded Random(ロード後に引くシード付き乱数 3 回分が、セーブ時に予告した値と完全に一致します)、M25 Command Console(履歴と補完が実際に動くゲーム内デベロッパーコンソール)、さらに RPG Starter のコードテンプレート。Tools ▸ Common Game System 以下には新しいエディタツールを追加しました: Welcome / Quick Start ウィンドウ(環境チェック、サンプルのワンクリックインポート)と、ランタイム用の Service Debugger(サービスレジストリのライブ表示、Clock 別のタイムスケール、動作中の tween / FSM / audio / command の統計)。修正: 保存済みのオーディオ設定が起動時に適用されるようになりました(ミキサー初期化の競合)。UI サンプルの音量 / ミュート操作が即座に効くようになり、その効果を耳で確かめられるよう「カノン」(ニ長調)の BGM ループを同梱しました(楽曲はパブリックドメイン、音源は自社制作の合成演奏)。ほかに、パネルナビゲーションの NullReferenceException、「No cameras rendering」のウォーターマーク、Play 終了時の後始末で出ていた例外も修正しています。サードパーティ依存は引き続き 0 個。IL2CPP 対応、レンダーパイプライン非依存、自動 EditMode テスト 2,550 件。

レビューに提出しましたが、公開はされていません。このビルドは 2026-06-15 に Unity Asset Store へ送ったものの、レビューが行われることはなく、誰の手にも届きませんでした。インストールできたバージョンとしてではなく、開発の記録としてここに残しています。Bootstrap.Run() 1 回で立ち上がる、プロダクション品質のサービス 20 個 — Service Locator、Logger、Event Bus、Save/Load、Configuration、Input、Time、Object Pool、Audio、UI Panel Stack、Scene Flow(+ Additive)、Localization、Achievements/Stats、Scheduler、Tween、Asset Provider、Random、FSM、Pushdown Stack、Tween Sequencing。サードパーティ依存 0 個、IL2CPP 対応、レンダーパイプライン非依存、AI 対応(AGENT.md + 5 つのタスクスキル)。1.14.0 より前のバージョンは、いずれも社内の開発マイルストーンです。