リアル綿菓子機PBギミック 説明書

PCVRプレイヤー向けのPhysboneを使った、みんなで遊べる綿菓子機ギミックです。

• Quest単機、モバイルプラットフォームには対応していません。

• PCデスクトップユーザーはギミックの配置のみ可能です (綿菓子をつくる・食べる操作に非対応)

• ワールド用ギミックではありません。アバターに組み込むことを前提に制作しています。

• ミドルクラスGPUがあるスペックのPC+VRで遊ぶことを想定しています。

  • Intel i5 10500 + nVidia GTX1070Ti + Valve IndexによるVRプレイで、体験を損ねるようなフレームレートの著しい低下などが発生しないことを確認しています。
  • AMD Ryzen5800X + nVidia RTX3080 + HTC VIVE によるVRプレイで、デフォルトホームワールドにプレイヤー１人、ギミックを稼働させた状態でフレームレートは90Hzを維持。

• 相応に負荷はあるギミックですので、イベントなどでは了承を取ってから使ってください (効果音もでます！)

仕様

• ポリゴン数: 約3万ポリゴン (30,045 Tris)
• テクスチャメモリ: 24.01 MB (既定)
• 同期パラメーター使用数 (Synced Expression Parameters): 59 Bits (WSSプレハブ)

目次

1. 導入方法
2. 機能説明
3. トラブルシューティング
4. Q&A

導入方法

慣れているユーザー向け説明

• プレハブをアバター直下に配置してください。(動作するアバターなら) ポン入れで動き、特別な設定は不要です。

  • ギミックのあるフォルダ Assets > Nekopanya > CottonCandyMachine
  • 配置するプレハブ "WSS_CottonCandyMachine.prefab"

• オプションとしてParameterSyncedWorldFixedSystemを使ったプレハブも用意しています。

  • このPSWFバージョンはVRChatのアニメーターカリングにより、WSSに比べ、同期が上手く出来ない可能性があります。

• アバターにはWSS、PSWFのどちらか一方のみを入れてください。

ModularAvatar (必須)

簡便なギミック導入のために、ModularAvatar(以下、MA)を使用しています。

2025年現在、日本のVRCユーザーに広く使われているツールですので、導入について詳細な説明は省かせていただきます。 詳しくはMA公式のドキュメントや、VRChatter向けの解説サイトなどを参考にしてください。

• https://modular-avatar.nadena.dev/ja にアクセスし、「ダウンロード(VCC経由)」を押してダウンロード。VCCのプロジェクトにModular Avatarを追加します。

LilToon (必須)

LilToonシェーダーを使用しています。 こちらも、よく使われているシェーダーパッケージですので、詳細な説明は省略させていただきます。

• https://lilxyzw.github.io/lilToon/ にアクセスし、「VCCに追加」を押してダウンロード。VCCのプロジェクトにLilToonを追加します。
• 制作にはLilToonバージョン1.10.3を使用しています。特別な理由のない限り、最新版のLilToonを使用してください。

当アイテムの UnityPackageインポート手順

• zipファイル内のパッケージをUnityエディタにインポートしてください。

• インポートするファイルの一覧が表示されたら、Importボタンを押します。

• Assets内に、以下の３つのフォルダが作成されます (新たに導入する場合)
  • NekoPanya (弊ショップ)
  • LABO405's shop (LABO405の出来合い置き場 様)
  • ParameterSyncedWorldFixedSystem (なめなめWorkshop 様)

※ LABO405様、なめなめWorkshop様のワールド固定ギミックを同梱しています。ライセンスについては各ショップのページをご確認ください。

シーンへのPrefab設置方法

• Assets > Nekopanya > CottonCandyMachine に移動します。

• プレハブ "WSS_CottonCandyMachine" をシーン上のアバター直下に配置します。
  • プレハブをProjectパネルからHierarchyパネルのアバタープレハブにドラッグ＆ドロップしてください。
  • アバターの外に配置してしまうと、正しくアップロードできません。

※ PSWFバージョンはPSWFバージョンPrefabフォルダ内にあります。 理由のない限り、アニメーターカリングに対応しているWSSバージョンの使用を推奨しています。

• 正しいヒエラルキー配置の例 (画像)

• シーン上に正しいプレハブが配置されると、画像のような箱が置かれます。正しいヒエラルキー配置になっていることを確認し、アバターをアップロードしてください。

• 箱がテキストの無い、ピンク1色で表示される場合、LilToonが導入されていない可能性があります。(画像は正しく表示された例)
• アバターBuild時にエラーが発生する場合は、トラブルシューティングの項目を確認してください。

機能説明

当アイテムは3つのギミックの組み合わせで出来ています。

※ワールド固定ギミックはLABO405様、なめなめWorkshop様のギミックを使用しています。

• ワールド固定ギミック
  • 同期型ワールド固定ギミック同封(WSS/PSWFの2バージョン)
  • 綿菓子機をワールドに配置できる
  • 途中参加者(レイトジョイナー)にも正しい位置に綿菓子機が表示される
• 昇降テーブルギミック
  • Physboneのハンドルを掴んで上下できる昇降テーブル機能
  • 身長90cm(目線の高さ約70cm)～身長180cmのアバターに対応
  • ギミックを持っているプレイヤー以外も高さを操作することが出来ます (VRオンリー)

• 綿菓子機ギミック
  • 綿菓子機をギミックを持っているプレイヤー以外も操作することができる (VRオンリー)
  • 綿菓子を最大2本まで同時に作成できる
  • 4色の綿菓子がつくれる
  • ひとつの綿菓子を3回にわけて食べることができる

• ラジアルメニュー
  • 表示/非表示とワールド固定
  • 綿菓子機モーター音の音量調整
  • 箸Physboneリセットボタン
  • 綿菓子強制消費ボタン
  • 側面・上部カバーの表示/非表示の切り替えボタン

ギミックの展開とワールド固定のしかた (WSS)

• ラジアルメニューを開き、綿菓子機メニューを選択

• View(Local) または View(Global) を押すと綿菓子機が出現します。(違いはローカル表示かグローバル表示か)
  • 右手を動かすと位置を微調節できます。
• WorldSet を押すとワールド固定を開始します。同期の設定に１０秒前後かかり、その間は全てのプレイヤーから見えなくなります。
  • 同期が完了すると綿菓子機が再度表示されます。
• 設置した綿菓子機を再設置する場合はアバターを一度アンロードすると同期失敗の可能性が減ります
  • 別のアバターを一旦ロードするか、メニューからアバターのリセットを実行

綿菓子を作る

• テーブルの赤いハンドルを掴んでから手を上下すると、机の高さを変えることが出来ます。

• 本体の電源スイッチにふれ、電源をいれてください。
  • 電源が入っていない状態で綿菓子を作ろうとするとエラーメッセージが表示されます。

• 綿菓子機右側にある匙をつかみ、砂糖をすくい取ります。
  • 砂糖は同じ色の砂糖に触れると元に戻せます。
• 匙を綿菓子機本体の釜上空に持っていくと砂糖が投入されます。

• 綿菓子機右側の割り箸を掴み、タライの中で回します。(釜から出てくる糸状砂糖を絡め取ります)
  • 一定量動かすと箸に砂糖が絡みついた状態になり、"巻取り"に移行します。この間は箸を動かす必要はありません。
  • 巻取りモード時に箸をタライの外に出してしまうと、もう一度絡め取るところからやり直しになります。
  • 釜から出てくる砂糖を放置するとタライの側面に溜まっていきます。適当にタライの中で箸を動かして剥がしてください。

絡め取り時

巻取り時

綿菓子を台座に差し込む

• 完成した綿菓子は台座に差し込むことで、続けて２本目の綿菓子を作ることが出来ます。
  • ひと口以上食べてしまった綿菓子は台座に差し込むことはできません。

食べ方

• 口元 (Headコンタクト) に綿菓子を持っていき、箸を手放すとひとくちずつ食べます。
  • ３口で完食します。
• Headコンタクトの無いアバターに対して綿菓子を食べさせたい場合は、ラジアルメニューの"Force Feed"ボタンを使ってください。

トラブルシューティング

アバターをアップロードできない

• 当アイテムを入れていない状態でアバターを正常にアップロードできることを確認してください。
• アップロードに失敗し、Avatar validation failedというエラーが出る場合、アップロードしようとしているアバターに何らかの問題があります。
  • 当アイテムを抜いた状態で正常にアップロードできることを確認してください。
  • コンソールに"VRCExpressionParameters has too many parameters defined."というエラーがある場合、導入しているギミックが多すぎます。アバターにギミック無しのプレハブがある場合はこれを使用してください。
  • アバター付属のギミックをどうやって削除すればいいのか分からない。といった質問には、こちらでは対応しかねます。使用しているアバターの制作者へお問い合わせください。

アバターをアップロードしてもラジアルメニューにギミックの項目が表示されない

• アバターの直下に当アイテムのプレハブが配置されていることを確認してください。

ギミックが動作しない・動作が途中で止まる

• BOOTH商品ページに記載している一部アバターで、当アイテムのギミックを正しく動作させることが出来ないことを確認しています。問題のアバターは、当方が所有していないため対応を検討中です。
  • 当アイテムはBOOTHにおけるダウンロード商品に該当するため、返金対応は行えません。別のアバターにギミックを入れる、などの対策をお願いします。
• 綿菓子機を設置後に、設置したプレイヤーが椅子など(VRC Station)に座ると予期せぬ動作を招く可能性があります。
  • ギミック使用中はSitしないようお願いします。Sitしてしまったらギミックを再設置してください。

自分と他の人で綿菓子機の位置がズレて見える

• はじめからその場にいる人達の間でも、アバターを読み込むタイミングなどにより同期に失敗することがあります。
  • 設置時に近くにいても、ギミックに対して背を向けているひとはカリングにより同期が失敗する可能性があります。
    • 同期に失敗している人がいる場合は、アバターをロードしなおしてギミックを再度、設置してください。
  • 同期に失敗しにくい二通りの設置方法が考えられます。
    • A: 設置時に、全員に設置場所が見える状態で待ってもらう
    • B: 周囲に人がいない場所に設置し設置後に来てもらう (順次ロードしてもらう)

ワールド固定に失敗する・指定した場所に固定されない

• 正しい位置に綿菓子機が出現しない場合は以下の理由が考えられます。
  • その場にいるアバターのコンタクトの数がVRChatが制限する上限数を超えているため、ギミックが動作を完了できない。
  • ワールドの座標がワールド固定ギミックがサポートする範囲を超えている。
  • 単純に重くてアニメーターやPhysboneの動作が不安定。
  • ジャンプ・落下中に同期ロジックを実行している。
• PSWFプレハブを使用している場合は、WSSプレハブに切り替えると少し改善するかもしれません。(アニメーターカリング周りの違い)

他の人から見えない

• WSSプレハブを使用している場合、同期が完了する場でギミックが表示されません。これは途中参加者にも適用されるので、ギミックの周囲で最大10秒ほど待つ必要があります。
  • 10秒待っても表示されない場合、Show Avatarなどを試してください。それでも表示されない場合、ギミック保有者がアバターを再読み込みして再設置してください。

Q&A

突然机がプルプル震えます

• 不明な条件下で机が振動する現象を確認しています。ハンドルを握ると解決します。
  • 原因が不明なため対応は検討中です。

箸の位置が同期していない

• PhysBoneを使っているため、状況によっては位置が同期されません。
  • ラジアルメニュー内にPBをリセットするボタンがあります。PBの同期ズレが疑われる場合は使ってください。

ワールドギミック版が欲しい

• Physbone主体で作っていることからワールドギミックに作り直すには一手間必要です。なので現在のところ、対応の予定はないです。すみません。

○○○できるようにしてほしい。

• 既に規模の大きいギミックになってしまっているので、機能追加などは考えていません。

メッシュ・テクスチャ・アニメーターを改変して使用したい

• (公序良俗に反する表現でない限り)ご自由にお使いください。改変データの取り扱いについてはVN3ライセンスをご確認ください。