🚀 クイックスタートガイド

LuraSwitch2 を最速で導入するための実践的なガイドです。基本的な機能を実際に設置しながら学んでいきましょう。

---

📥 インストール

LuraSwitch2 を Unity プロジェクトに導入する手順を解説します。

📋 必要な環境

LuraSwitch2 を使用するには、以下の環境が必要です。

• Unity: 2022.3.22f1 以上
• VRChat SDK: SDK3 - Worlds
• UdonSharp: 3.10 以上

🛠️ インストール手順

1️⃣ パッケージのダウンロード

BOOTH 商品ページ から LuraSwitch2 の最新版をダウンロードしてください。

2️⃣ UnityPackage のインポート

1. Unity プロジェクトを開く
2. ダウンロードした .unitypackage ファイルをダブルクリック
3. インポートダイアログで「Import」をクリック

3. インストールの確認

インポートが完了すると、以下のフォルダが作成されます：

Assets/
  QuickBrown/
    LuraSwitch2/
      01_PREFAB/     # 使用可能なプレハブ
      02_CORE/       # コアスクリプト
      SCENE/         # サンプルシーン

サンプルシーンの確認

Assets/QuickBrown/LuraSwitch2/SCENE/LuraSwitch2_SAMPLE.unity を開くと、各コンポーネントの使用例を確認できます。

TextMeshPro のインポート

テキストを正しく表示するために、TextMeshPro パッケージをインポートしてください。

💡 うまく表示されないときは

シーンを開いている際にインポートしても表示されない場合は、シーンを再度開きなおしてみてください。

💡 間違って消してしまった場合

ウィンドウを消してしまった場合、Package Manager からTextMeshProを検索し、再度インポートしてください。

1️⃣ まずは「ミラーセット」を配置しよう

手軽に始めるためにはLuraSwitch2 の機能が一通り揃った *LuraMirror_SwitchSet[SAMPLE] プレハブを配置することから始めましょう。

プレハブの配置

プロジェクトウィンドウから LuraMirror_SwitchSet[SAMPLE] をシーンにドラッグ＆ドロップしてください。

基本的な調整手順

ミラーセットには以下の重要なコンポーネントが含まれています。

• LuraMirror（ミラー本体）
• Switch（ミラースイッチ）
• Slider（スライダー）
• ModeSwitch（HQ／LQ 切り替えスイッチ）
• SwitchSyncer（スイッチ連動用Prefab）
• SwitchBoard（2Dスイッチを配置可能なボード）

ステップ 1: 鏡の配置を調整する

ヒエラルキー内の ReferenceMirror オブジェクトを選択し、Position・Rotation・Scale を調整して、鏡を好みの位置・サイズに配置してください。

ステップ 2: エリアの設定を行う

ミラーシステムには2つのエリア設定があります。

• FullArea（フルエリア）: 鏡が最高品質で表示される範囲を設定します。通常、鏡の正面に配置します。
• StartArea（スタートエリア）: プレイヤーがこの範囲に入ると鏡が起動します。負荷管理のため、適切なサイズに調整してください。

💡 プレビュー機能を活用しよう

エディタ上で鏡の見え方を確認したい場合は、PreviewMirrorType を切り替えてください。

※ 鏡が真っ白で表示される場合は、Unity エディタ上で一度 Play モードに入ることで正しく表示されるようになります。

詳細については LuraMirror のページ をご覧ください。

---

2️⃣ スイッチを使いこなそう

ミラーセットに含まれるスイッチ

ミラーセットには Switch_Mirror が含まれています。これは鏡のオン・オフを切り替えるための専用スイッチです。

スイッチの基本

スイッチは オン・オフの2状態 を切り替えるコンポーネントです。ライトの点灯・消灯、オブジェクトの表示・非表示など、様々な要素を制御できます。

ターゲットの指定方法

スイッチのインスペクタで、制御対象を指定します。

• On Targets: オン状態でアクティブになるオブジェクト
• Off Targets: オン状態で非アクティブになるオブジェクト

💡 旧 LuraSwitch との違い

旧版は Toggle 方式でしたが、LuraSwitch2 では On 状態と Off 状態を明確に区別します。これにより、より直感的で予測可能な動作を実現しています。

💡 ミラーセットPrefab

ミラーセットに含まれているスイッチには既にミラーを起動するためのActivatorがターゲットが設定されているため変更する必要はありません。

同期モード (SyncMode)

• None: 同期なし（各プレイヤー個別に動作）
• Global: 全プレイヤーで状態を同期
• Local: ローカルに保存（ワールドセーブ）

デフォルト状態の切り替え

ToggleDefaultOn を切り替えることで、スイッチの初期状態（オン・オフ）を設定できます。

💡 エディタプレビュー

この設定を変更すると、Unity エディタ上でも即座にスイッチと、設定したオブジェクトの見た目が変化します。
Play モードに入らなくても、視覚的に状態を確認できます。

SwitchTextの設定

SwitchText を記入すると、3Dスイッチと2Dスイッチに表示されるテキストを一括で設定できます。

Switch_InformationText を記入すると、VRChatでUseしようとするときに浮かび上がるテキストを設定できます。

💡 スイッチテキストのヒント

• Switch_InformationText: Mirror(Local)のようにLocal/Global/LocalSave の状態が自動的に追加されます。
• Text Auto Update: チェックを外すと自動設定されなくなります。手動でテキストを設定する必要がある場合はこちらをオフにしてください。
• 文字数オーバー: 文字数が多くなって表示がおかしくなった場合は、Textのフォントサイズを直接調整してください。

多様なスイッチバリエーション

LuraSwitch2 では、用途に応じて多彩なデザインのスイッチを用意しています。

MirrorHQ（ミラーHQ）

MirrorLQ（ミラーLQ）

Object（オブジェクト）

Pen（ペン）

Key（キー）

Information（情報）

Accept（承認）

Setting（設定）

Power（電源）

Liquar（リキュール）

Food（食べ物）

Heart（ハート）

Audio（オーディオ）

Video（ビデオ）

Music（音楽）

Chair（椅子）

LiteMode（軽量モード）

SavePoint（セーブポイント）

SavePoint（セーブポイント）

One

Two

Three

Four

Language JP（日本語）

Language EN（英語）

Language KO（韓国語）

Language CH（中国語）

Collider（コライダー）

Bed（ベッド）

PostEffect（ポストエフェクト）

Night（昼夜切替）

Effect（エフェクト）

Skybox（スカイボックス）

AvatarLight（アバターライト）

Light（ライト）

スイッチの詳細な機能については、スイッチ概要ページ をご覧ください。

---

3️⃣ スライダーでミラー透明度をコントロールしよう

ミラーセットに含まれるスライダー

Slider_Mirror は鏡の透明度を段階的に調整できるスライダーです。

スライダーの基本

スライダーは 0〜100% の連続的な値 を調整するコンポーネントです。10% 刻みでスナップするため、正確な値設定が簡単に行えます。

スライダーだけでも運用可能

スライダーの値を0にした場合でも、ミラーは非アクティブ状態になり、負荷は発生しなくなります。
つまり、メインのミラースイッチ無しでもスライダーだけで鏡のオン・オフを管理することも可能です。
使いやすいかどうかはユーザーによりますが、選択肢の一つとして覚えておくと良いでしょう。

ターゲット設定 (TargetSetting)

スライダーのインスペクタで、制御対象とパラメータを指定します。ミラーの解像度、ライトの明るさ、音量など、用途に応じた設定が可能です。

同期モード (SyncMode)

• None: 同期なし（各プレイヤー個別に調整）
• Global: 全プレイヤーで値を同期
• Local: ローカルに保存（次回訪問時も設定を保持）

デフォルト値の設定

DefaultValue で、スライダーの初期値（0〜100%）を設定できます。

💡 推奨設定

• ローカル（ミラー透明度、音量など）: 基本的には Local モードが推奨です。
• グローバル（演出の変更など）: Global モードで全員に同じ設定を適用できます。

機能別スライダーバリエーション

用途に応じた専用スライダーを多数用意しています。

MirrorRotate（鏡回転）

MirrorHeight（鏡の高さ）

Object（オブジェクト）

Music（音楽）

Audio（オーディオ）

AvatarLight（アバターライト）

Light（ライト）

Collider（コライダー）

Night（ナイトモード強度）

PostEffect（ポストエフェクト）

詳細については スライダー概要ページ をご覧ください。

---

4️⃣ モードスイッチで複数の選択肢を管理しよう 🔀

モードスイッチは、複数の状態から1つだけを選択する 排他制御 を実現します。

内部構造

モードスイッチには通常のスイッチが2つ（SwitchA と SwitchB）内包されています。それぞれのスイッチでターゲットを個別に設定できます。

設定方法

同期設定やデフォルト値の管理は、親オブジェクトの ModeSwitch 本体にある SwitchSelector コンポーネントで行います。

💡 使用例：ミラーの HQ/LQ 切り替え

• SwitchA に HQ ミラーのアクティベーターを設定
• SwitchB に LQ ミラーのアクティベーターを設定

これで、どちらか一方だけが有効になる排他制御が完成します。プレイヤーは自分の環境に合わせて鏡のHQ／LQを選択できます。

詳細については モードスイッチ概要ページ をご覧ください。

---

5️⃣ 2D切り替え機能で見た目を変更しよう

すべてのスイッチとスライダーは 3Dモード と 2Dモード を簡単に切り替えられます。用途に合わせて最適な操作方法を選択してください。

3つの操作モード

モード	説明	用途
2D_Interact	2Dモード。トリガーに直接インタラクトする方式。近づく必要がありますが、レーザーポインターを向ける必要がありません。	押しやすいパネル
2D_UI	2Dモード。レーザーポインターで操作する方式。離れた場所からレーザーによる操作が可能です。	UIパネル
3D	3Dモード。トリガーをインタラクトする従来の方式。	物理スイッチ

---

6️⃣ SwitchBoard で操作パネルを作ろう

SwitchBoard は、2Dモードのスイッチ・スライダーを一箇所に集約する操作パネルです。

セットアップ手順

ヒエラルキー内の ■■■■SwitchHere■■■■ の子として、2Dモードのスイッチやスライダーを配置してください。

ホルダーシステム

SwitchBoard は、指定した最も近い SwitchBoardHolder の位置に自動的に移動します。

インスペクタで SwitchBoardHolder を指定することで、移動・呼び出しが可能になります。

動作モード

• Pickup モード: プレイヤーが持ち運べる可搬型パネル
• Static モード: 壁面などに固定された据え置き型パネル

💡 効率的な配置のコツ

• 複数のホルダーを配置: ワールド内の各エリアに SwitchBoardHolder を配置し、Holdersに指定することで、プレイヤーの最寄りの位置に操作パネルが移動します。
• Pickup ／ Static: 持ち運びたい場合は Pickup モード、壁に固定したい場合は Static モードを選択してください。

詳細については SwitchBoard のページ をご覧ください。

---

7️⃣ SwitchSyncer でスイッチを連動させよう 🔗

SwitchSyncer は、複数のスイッチやスライダーの状態を連動させるためのツールです。

使い方

SwitchSyncerにスイッチを指定するだけで、それらのスイッチが同期されるようになります。

💡 ベストプラクティス

複数のスイッチを常に連動させる場合、ターゲットの参照設定は1つのスイッチだけで行い、残りのスイッチは SwitchSyncer で連動させる構成にすると、セットアップと保守が大幅に簡素化されます。

詳細については SwitchSyncer のページ をご覧ください。

---

次のステップ 🎯

基本的な使い方を理解できたら、以下のページで詳細を確認してください：

• 🎓 基本的な使い方