メインコンテンツまでスキップ

導入手順

動作環境​

現在のギミックは、次の環境で制作されています。ここに記載したものは動作確認に使用したバージョンです。

項目バージョン
Unity2022.3.22f1
VRChat SDK - Worlds3.10.4
VRChat Package Resolver Tool0.1.29
VRCLightVolumes2.1.3
lilPBR1.0.0

Unityを起動する前にVRChat Package Resolver Toolを確認する​

Mikinel Cigar Systemを導入するUnityプロジェクトを起動する前に、VRChat Creator CompanionのManage Packagesを開き、VRChat Package Resolver Toolが導入されていることを確認してください。

  1. VRChat Creator Companionで導入先のプロジェクトを選択し、Manage Packagesを開きます。
  2. VRChat Package Resolver ToolのInstalled Versionにバージョンが表示されていることを確認します。
  3. 導入されていない場合は、VRChat Creator Companionからパッケージを追加し、追加完了後にUnityを起動します。
VRChat Creator CompanionでVRChat Package Resolver Toolの導入を確認する画面

依存パッケージの追加​

Mikinel Cigar Systemをインポートすると、Unity上にMikinel Cigar SystemのSplash Screenが表示されます。閉じた場合は、UnityのメニューからMikinelTools > Mikinel Cigar System > Splash Screenを選択すると再度表示できます。

Splash Screenの依存パッケージ追加画面

Splash Screenで依存パッケージの状態を確認し、次の順にセットアップします。VRChat Package Resolver Toolが未追加の間は、ほかのパッケージを操作できません。

  1. VRChat Package Resolver Tool（必須） 未追加の場合は「VRChat Package Resolver Toolの導入手順を開く」で手順を確認します。Unityを閉じ、VRChat Creator Companionから追加した後、Unityを再度起動してください。
  2. lilPBR（必須） Resolverの追加後、「lilxyzw Community Repositoryを登録」を押し、登録後に「lilPBRをこのプロジェクトに追加」を押します。
  3. VRC Light Volumes（任意） 使用する場合のみ、RED_SIM Community Repositoryを登録してパッケージを追加します。

必須パッケージの表示がどちらも「プロジェクトに追加されています。」になれば完了です。

すべての依存パッケージを追加した後のSplash Screen

1. ワールドプロジェクトを準備する​

VRChat Creator CompanionでWorldsプロジェクトを作成するか、導入先の既存ワールドを開きます。

2. Cigarをインポートする​

Mikinel Cigar Systemのunitypackageをプロジェクトへインポートします。インポート後、Projectウィンドウで次のフォルダーが確認できれば完了です。

Assets/mikinel/Cigar/
├─ Prefabs/
├─ Scripts/
├─ Shaders/
└─ DataStore/
インポート後のCigarアセットのフォルダー構成

3. Prefabの配置​

以下のPrefabをProjectウィンドウのAssets/mikinel/Cigar/Prefabsからシーン上に配置します。

  • Cigar.prefab—葉巻本体
  • Lighter.prefab—着火用ターボライター
  • AshTray.prefab—灰皿
  • Cutter.prefabまたはPunchCutter.prefab—葉巻の吸い口をカットするための道具
  • CigarBox.prefab—複数の葉巻を収納可能なシガーボックス
  • Resetter.prefab—葉巻を初期状態へ戻すためのリセット用オブジェクト
葉巻の配置数について

動作検証では、葉巻を12本配置して確認を行いました。配置できる葉巻の数に上限はありませんが、本数が多くなるほど負荷が大きくなるため、必要な本数のみ配置することを推奨します。

Cigar関連Prefabの配置例

4. アップロードと動作確認​

配置後、ワールドをアップロードし動作を確認してください。