メインコンテンツへスキップ
見出し画像

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日 - )は、日本の作詞家、ミュージシャン。ロックバンドはっぴいえんどの元ドラマー。

    Wikipediaより

    「はっぴいえんど」というと、私はこの曲しか知らないですが。

    リアタイで岡林信康氏と同じ世代だったら、日本全国を追っかけてライブ会場に足を運んでたでしょうね。

    今の時代、こういうカリスマ性のある人って少ないじゃないかな。

    時代の陰に埋もれて恐らく沢山いる気がします。

    そういう人を沢山見つけたい。

    私が、個人サイトで検索してサーチエンジンに引っかからない、無名サイトを探す理由も同じ。

    「でも、誰か?知りませんか?」
    「風そよぐ、草原を映し出す。」
    「幸せと不幸せ、かき混ぜる」
    「夢色の小さなスプーン」

    あなたへのおすすめ