
CreditBoard汎用化 — ゲーム内クレジット看板を3プロジェクトで共有する
WebXRマルチゲームプラットフォーム「PROJECT_LAIN」の開発記録です。
今回は、グラディウス風STG「WIT」で作ったクレジット看板を汎用コンポーネントに切り出して、ADV/RPGとパズルゲームにも展開しました。ついでにVRMアバターのY軸回転機能も追加しています。
詳細版はこちら:

クレジット看板の問題
もともとWIT(STG)用に作ったWITCreditBoard.tsxは、WIT専用のJSONファイルを直接importしていました。Canvas上にクリエイター名を描画して、テクスチャとしてAフレーム看板に貼り付け、スクロールさせる仕組みです。
見た目は気に入っていたのですが、WIT専用のデータに依存しているので、ADV/RPGやパズルでは使えませんでした。
さらに、トップページのindex.astroにはクレジット情報がHTMLタグで手書きされていて、メンテナンスが面倒な状態でした。
汎用化のアプローチ
やったことはシンプルです。
CreditBoard.tsx:JSON import を全部外して、クレジットデータをpropsで受け取る汎用コンポーネントに
WITCreditBoard.tsx:WITのJSONからcreatorを抽出してCreditBoardに渡すだけの薄いラッパー
ADVCreditBoard.tsx:ADV/RPGのJSON群(Stages, Avatars, SoundEffects)から同様に抽出
PuzzleCreditBoard.tsx:puzzleConfig.jsonから抽出、木箱GLBモデルの上に看板を配置
これでJSONのcreatorやauthorフィールドを書くだけで、自動的にゲーム内の看板に反映されるようになりました。
ADV/RPG — 自室に看板設置
ADV/RPGでは、ゲーム開始地点のSTAGE_MY_ROOM(イレイナの部屋)にクレジット看板を配置しました。

Stages.json、Avatars.json、SoundEffects.jsonからクリエイター情報を自動抽出して、STAGE MODEL / CHARACTER MODEL / AUDIO の3セクションで表示します。
これのおかげで、index.astroに大量に書いていたクレジット用HTMLタグを大幅に削減できました。
トップページで直接使っているアセットの分だけ残して、ゲーム内で使うアセットのクレジットはすべてゲーム内看板に集約しています。
パズルゲーム — 木箱の上にクレジット看板
パズルゲームには「エンディングまでプレイするとクレジットが表示される」機能があるのですが、難易度が高すぎて自分でも一度もクリアしたことがありません。
素材を提供してくれたクリエイターのクレジットが実質誰にも見られない状態だったので、ゲーム開始時から見える位置に看板を置くことにしました。
Sketchfabからダウンロードしたローポリ木箱のGLBモデルを台座にして、その上にクレジット看板を立てています。VRとPCではカメラ位置が異なるため、Z座標をisXRで分岐させています。


VRMアバターのY軸回転機能
外部からロードしたVRMの中には、デフォルトの向きが逆になっているモデルがあります。おそらくVRoid Studioでのエクスポート設定の違いが原因です。
右クリックメニューのSYSタブにROTATION_Yスライダーを追加して、0〜360°で自由に回転できるようにしました。値はlocalStorageに保存されるので、リロードしても維持されます。

ハマったポイント
いくつかハマりました。
import type問題:CreditSectionはTypeScriptのinterfaceなので、import typeで分離しないとVite + Astro環境でランタイムエラーになります
primitiveの重複:WiredAvatar.tsxで回転用の内側groupを追加した際、元のprimitiveを消し忘れて2体描画されました。スライダーを動かしても見た目が変わらず、しばらく原因がわかりませんでした
PC用メニューへのprops渡し漏れ:VR用メニューにはpropsを渡していたのに、PC用の右クリックメニューへのonRotYChangeが欠落していました。オプショナルチェイン(?.)のせいでエラーも出ず、サイレントに無視されていました
おまけ:外部VRM保存の仕組み
ついでに「外部からロードしたVRMファイルはどこに保存されているのか」を調査しました。
結論としては、assetCache.tsのgetCachedAssetUrl内でblob URLからバイナリを取得し、LOCAL_VRM_${fileName}_${fileSize}をキーにIndexedDBへ保存されていました。リロード時はlocalStorageに記録されたキー名を使ってIndexedDBから復元し、新しいblob URLを生成する仕組みです。
DevToolsのIndexedDBビューアにはページネーションがあり、デフォルト表示件数を超えた分は▶ボタンで次のページに進まないと見えません。これに気づかず「保存されてない」と思い込んでいました。

格ゲー(LAYER FIGHTER)は?🤔
実装する予定でしたが、思うように進まず、今まで後回しにしてた、別のタスクを今日は実装して終わってます。
格ゲー開発の雲行きは凄く怪しいです。
Quest3をかったり、MR開発をした影響は大きいというのは、いいわけでしかないですね。
やらないといけないと思えば思うほど、遠ざかっていく。
飯島真理氏の名曲「夢色のスプーン」の歌詞
「追えば追うほど遠ざかるのが夢なんだよ」
という、歌詞が脳内でリフレインします。😞
昔のアニソンは歌詞が非常に深いです。
作詞は、巨匠「松本隆」氏なので当然ですが…。
松本 隆(まつもと たかし、1949年7月16日 - )は、日本の作詞家、ミュージシャン。ロックバンドはっぴいえんどの元ドラマー。
「はっぴいえんど」というと、私はこの曲しか知らないですが。
リアタイで岡林信康氏と同じ世代だったら、日本全国を追っかけてライブ会場に足を運んでたでしょうね。
今の時代、こういうカリスマ性のある人って少ないじゃないかな。
時代の陰に埋もれて恐らく沢山いる気がします。
そういう人を沢山見つけたい。
私が、個人サイトで検索してサーチエンジンに引っかからない、無名サイトを探す理由も同じ。
「でも、誰か?知りませんか?」
「風そよぐ、草原を映し出す。」
「幸せと不幸せ、かき混ぜる」
「夢色の小さなスプーン」