みなさんこんにちは、キリカです。
ブログ更新がなんと8ヶ月ぶり。
というのも、VRChatにドはまりしてしまっていたから。
VRChatでは何をするにもUnityが必要。
購入したアバターを利用するためにも、自分で作成したワールドを投稿してみんなに楽しんでもらうにもUnityが必要です。
![友達](https://nekosakamiti.com/wp-content/uploads/2021/02/icon2.png)
非専門家が当然のようにUnity使ってるんだからすごい世界
ですが、ここに多くの罠が仕掛けられています。
- UnityのバージョンがVRChatの指定と異なる
- SDKのバージョンが異なる
- いつのまにかSDKのバージョンが時代遅れに
- UdonSharpのバージョンが異なる
- 間違ってプロジェクトのフォルダを消してしまう
- なんか分からないけどプロジェクトが壊れる
といった、Unity周りでのトラブルがとても多い!!!
こんなのと戦っていたら、もう
「Unityなんていやだ!!!ぶいちゃに帰る!!!!!」
と言ってワールド作成が何も進みませんね。(n敗)
今回は、Creator Companionというツールを利用してこれらの適切な管理を行う方法についてご紹介していきたいと思います。
Creator Companionとは
公式さんの説明によると、Creator Companionは、
「VRChatで何かを作りたい方への新しいエントリーポイント」
とのことです。分かりづらいですね。
噛み砕いて説明すると、VRChat公式のコンテンツ作成ツール集と言ったところでしょうか。
![管理人](https://nekosakamiti.com/wp-content/uploads/2023/01/icon20230105.png)
公式製のツールなので安心ですね
現在はパッケージマネージャーを主な機能としています。
- 現在のVRChatの要求に合わせたバージョンのUnityと、最新のUnityHubの自動取得
- アバター、ワールドの指定に応じたプロジェクトの自動作成
- それらへの適切なバージョンのSDKやUdonSharpの導入
などが可能です。
具体的に見てみましょう。
従来の手順としては、例えば新しいワールドを作成する際、
- Unity Hubからプロジェクトを作成
- VRCSDKの最新版を取得してくる
- VRCSDKを導入
- UdonSharpの最新版を取得してくる
- UdonSharpを導入
と、言う手順が必要でした。これだと、どうしても適切に管理するのが面倒でした。
Creator Companionを使うと、
- Creator Companionからワールドかアバターを選択
- Creatorをクリック
という手順だけでVRChatの要求する最新状態のプロジェクトを作成することができます。
![友達](https://nekosakamiti.com/wp-content/uploads/2021/02/icon2.png)
この”始めるまでの準備”が面倒だったから、ここ簡単になるの嬉しいね!
![管理人](https://nekosakamiti.com/wp-content/uploads/2023/01/icon20230105.png)
UdonSharpやSDKも自動で最新のバージョンが適用されるので楽!
今後の展望として、サンプルやニュース、情報やコミュニティプレハブを追加して文字通りクリエイターのための総合ツールを目指しているようです。今後の展開が楽しみです。
ここまでを3行でまとめるとこんな感じ!
- 現在のVRChatの要求に合わせたバージョンのUnityと、最新のUnityHubの自動取得
- アバター、ワールドの指定に応じたプロジェクトの自動作成
- それらへの適切なバージョンのSDKやUdonSharpの導入
Creator Companionの導入手順
では、早速Creator Companionを導入していきましょう。
まず、普段SDKをダウンロードするページにお進みください。
見慣れた画面ですね。ここの下部にある「Download the Creator Companion」をクリック。
![Creator Companion](https://nekosakamiti.com/wp-content/uploads/2022/08/image-1-1024x566.png)
ダウンロードされたVRChat_CreatorCompanion_Setup_x.x.x.exeを実行します。
![Creator Companion](https://nekosakamiti.com/wp-content/uploads/2022/08/image-2.png)
![管理人](https://nekosakamiti.com/wp-content/uploads/2023/01/icon20230105.png)
ちなみに、管理人の環境はWindows11です。
![友達](https://nekosakamiti.com/wp-content/uploads/2021/02/icon2.png)
公式的には、「Windows10が推奨環境、Windows11は未保証」とのこと
![管理人](https://nekosakamiti.com/wp-content/uploads/2023/01/icon20230105.png)
管理人のWin11環境でもちゃんと動いてるのできっと大丈夫です。
「ライセンスに同意しますか?」と聞かれますので、内容を確認したら「I accept the agreement」を選択して「Next」を押下。
![Creator Companion](https://nekosakamiti.com/wp-content/uploads/2022/08/image-3.png)
しばらくすると自動でインストールされ、起動します。
導入はこれで完了です。お疲れ様でした。
![Creator Companion](https://nekosakamiti.com/wp-content/uploads/2022/08/image-4-1024x577.png)
![管理人](https://nekosakamiti.com/wp-content/uploads/2023/01/icon20230105.png)
Creator Companion起動時、適切なバージョンのUnityがインストールされているかチェックしてくれるみたいです。
![友達](https://nekosakamiti.com/wp-content/uploads/2021/02/icon2.png)
インストールされていないなら、おそらくこのタイミングで導入のためのボタンが出るよ
3行でまとめるとこんな感じ!
- 公式サイトからインストーラーを保存
- インストールを実行すれば完了!
- 立ち上がり時に適切なUnityの有無を確認してくれる!
Creator Companionを利用して新規プロジェクトを作成
実際にCreator Companionでプロジェクトを作成してみましょう。
左側にある「Projects」の「New」を選択してください。
![Creator Companion](https://nekosakamiti.com/wp-content/uploads/2022/08/image-4-1024x577.png)
以下の画面に遷移します。左側に「Official Templates」として、「Avatar」、「World」、「UdonSharp」の3つが表示されます。必要なものをクリック。
ここで、「World」「UdonSharp」の違いはUdonSharpが含まれているか否っぽいです。後で追加、削除できるためどっちでも良さそうです。
今回は「World」を選択。
![Creator Companion](https://nekosakamiti.com/wp-content/uploads/2022/08/image-5-1024x577.png)
次の画面では、プロジェクトの名前と保存先を指定してあげてください。
今回は「NEWWORLD」とでもしておきます。
![Creator Companion](https://nekosakamiti.com/wp-content/uploads/2022/08/image-6-1024x577.png)
![管理人](https://nekosakamiti.com/wp-content/uploads/2023/01/icon20230105.png)
スクショのオレンジ部分は自分のユーザ名なので隠しております。あしからず
すると、「Please Wait」と表示され、しばらく微動だにしなくなります。
少し時間がかかるので水でも飲みに行ってください。
![Creator Companion](https://nekosakamiti.com/wp-content/uploads/2022/08/image-7-1024x577.png)
次の瞬間、「バックアップができました」のメッセージが表示されます。初回は自動で作成されるのかな、OKを押して進めてください。
![Creator Companion](https://nekosakamiti.com/wp-content/uploads/2022/08/image-8-1024x577.png)
これでプロジェクトが作成されました。
![Creator Companion](https://nekosakamiti.com/wp-content/uploads/2022/08/image-9-1024x577.jpg)
ちなみに、画面左部の「Projects」をクリックすると、作ったプロジェクトの一覧が見れます。
ここに、先程作ったNEWWORLDが追加されているのがわかります。
![Creator Companion](https://nekosakamiti.com/wp-content/uploads/2022/08/image-9-1024x577.png)
ここのプロジェクト名をクリックすると、先程の画面に戻ってくることができます。
![Creator Companion](https://nekosakamiti.com/wp-content/uploads/2022/08/image-9-1024x577.jpg)
画面の右半分に書かれているのが、現在利用できるパッケージです。基本的にすべての項目に最新版が設定されています。
プルダウンメニューから、好きなバージョンを指定することが可能です。
![Creator Companion](https://nekosakamiti.com/wp-content/uploads/2022/08/image-10.png)
現在は3.1.5が最新ですが、プルダウンメニューから3.1.4を選択してみました。すると、右側に「Downgrade」の項目が表示されました。
![Creator Companion](https://nekosakamiti.com/wp-content/uploads/2022/08/image-11.png)
Downgladeを押すと、少しのローディング後、バージョンが3.1.4に下がりました。
また、同時に、最新の3.1.5へのUpdateを促すボタンが追加されました。
![Creator Companion](https://nekosakamiti.com/wp-content/uploads/2022/08/image-12.png)
あー、やっぱりUdonSharp入れたくなったなぁ、と思った際は、右側を一番下までスクロールすると「UdonSharp」の項目がありますので、Addを押して追加してください。
![Creator Companion](https://nekosakamiti.com/wp-content/uploads/2022/08/image-13-1024x433.png)
右側の設定が完了したら、中央の項目を見ていきましょう。
![Creator Companion](https://nekosakamiti.com/wp-content/uploads/2022/08/image-14-1024x398.png)
「Refresh」は更新、「Open Folder」は保存先を開く機能です。
「Make Backup」は、プロジェクト全体を自動でバックアップしてくれる機能です。
ワンクリックで、保存先を指定する必要さえなく即座にバックアップしてくれます。
![友達](https://nekosakamiti.com/wp-content/uploads/2021/02/icon2.png)
面倒だとバックアップしなくなるから、とにかくシンプル簡単にしてくれたのサイコー
![Creator Companion](https://nekosakamiti.com/wp-content/uploads/2022/08/image-15-1024x576.png)
![Creator Companion](https://nekosakamiti.com/wp-content/uploads/2022/08/image-16-1024x576.png)
「Show Me」を押すと、バックアップの保存先が開かれます。
![Creator Companion](https://nekosakamiti.com/wp-content/uploads/2022/08/image-17-1024x318.png)
バックアップを一つ解凍してみました。解凍時に少しエラーが出たためちょっと信頼度がビミョーですが、きちんとバックアップできているようです。
![Creator Companion](https://nekosakamiti.com/wp-content/uploads/2022/08/image-18-1024x327.png)
話を戻します。最後に、「Open Project」を押すと、作成したプロジェクトをUnityで開くことができます。初回起動時はインポートでたっぷり時間がかかります。カップ麺でも作りながら待ってあげてください。
![Creator Companion](https://nekosakamiti.com/wp-content/uploads/2022/08/image-14-1024x398.png)
しばらくすると、プロジェクトが開かれました。
このプロジェクトは、従来の作成方法と変わった点がいくつかあります。そこは後述します。
![Creator Companion](https://nekosakamiti.com/wp-content/uploads/2022/08/image-19-1024x557.jpg)
3行でまとめるとこんな感じ!
- アバターかワールドを選択したらワンクリックでプロジェクトが完成!
- プルダウンメニューでSDKやUdonSharpのバージョン変更が簡単!
- ワンクリックでプロジェクトのバックアップも可能!
Creator Companionに既存プロジェクトを追加しよう
続いて、Creator Companionに既存のプロジェクトを追加してみましょう。
くれぐれも、実施の際はバックアップを取ってからやってください。
今回は昔作ってたアバターの名残である「TVヘッド」を使ってみます。
![Creator Companion](https://nekosakamiti.com/wp-content/uploads/2022/08/image-20-1024x353.png)
![管理人](https://nekosakamiti.com/wp-content/uploads/2023/01/icon20230105.png)
このプロジェクトなら破損しても諦めがつくので
![友達](https://nekosakamiti.com/wp-content/uploads/2021/02/icon2.png)
成功のための犠牲はやむなし
Creator Companionを起動し、左部の「Projects」から「Add」を選択。
![Creator Companion](https://nekosakamiti.com/wp-content/uploads/2022/08/image-21-1024x577.png)
「フォルダの選択」画面が出てくるため、プロジェクトのあるフォルダを選択してください。
![Creator Companion](https://nekosakamiti.com/wp-content/uploads/2022/08/image-22-1024x380.png)
「TVヘッド」が追加されました。それを選択してください。
![Creator Companion](https://nekosakamiti.com/wp-content/uploads/2022/08/image-23-1024x573.png)
先程新規作成した際と異なり、画面右半分のSDKバージョンなどが表示されていません。
画面中央を見ると、Legacy SDK3 Avatar Projectと書いています。Creator Companionで扱うには、Migrate(移住、移転)してあげる必要があります。
![Creator Companion](https://nekosakamiti.com/wp-content/uploads/2022/08/image-24-1024x577.png)
Migrateの方法は簡単です。「Migrate」のボタンをクリックしてください。
以下のようなメッセージが出てきます。
![Creator Companion](https://nekosakamiti.com/wp-content/uploads/2022/08/image-25-1024x386.png)
バックアップを取っていないなら「Migrate a copy」(複製したものを変換)、バックアップなんていらねえ!!!という方は「Migrate in place」(これをそのまま変換)をお選びください。
今回はバックアップを作成済みですが、その上で慎重に「Migrate a copy」を選びます。
変換画面がザザザっと走ります。
今回対象としたプロジェクトは小さかったため20秒程度で完了しました。大きいと時間がかかると思います。
![Creator Companion](https://nekosakamiti.com/wp-content/uploads/2022/08/image-26-1024x563.png)
変換が完了しました。Legacyの表記が消え、右画面にSDKパッケージ等が表示されました。
もし使っているパッケージが古かった場合、この画面からアップグレードしてあげてください。
![Creator Companion](https://nekosakamiti.com/wp-content/uploads/2022/08/image-27-1024x577.jpg)
初回起動時はやっぱり時間がかかります。2分くらい待ちました。
![Creator Companion](https://nekosakamiti.com/wp-content/uploads/2022/08/image-27-1024x308.png)
そして無事、プロジェクトが開かれました。移行完了です!
![Creator Companion](https://nekosakamiti.com/wp-content/uploads/2022/08/image-28-1024x557.jpg)
プロジェクトがあったフォルダに、TVヘッド(マイグレーション前)、TVヘッド-Migrated(マイグレーション後)の両方があることが確認できます。
![Creator Companion](https://nekosakamiti.com/wp-content/uploads/2022/08/image-28-1024x431.png)
UnityHubの方にも自動でマイグレーション後のプロジェクトが追加されていました。
ここ連携してくれるのすごく便利!
![Creator Companion](https://nekosakamiti.com/wp-content/uploads/2022/08/image-29-1024x413.png)
ここまでを3行でまとめるとこんな感じ!
- 既存プロジェクトは「追加」→「Migrate」
- MigrateすることでCreator Companionにて管理できるようになる
- Migrate時は複製して変換か、そのまま変換か選択できる!
従来と変わった点
さて、とても便利なCreator Companionですが、従来と使用感が変わった要素もあります。
ここを確実に押さえておくとより便利に利用できるでしょう。
サンプルの場所が変化
以前まではアセットフォルダの中に自動で展開されていたサンプルですが、Creator Companionによるプロジェクト作成ではそれがなくなり、必要に応じて自身で追加するという流れになりました。
方法は簡単です。上部のメニュー内に「VRChat SDK」があります。その中に「サンプル」というメニューが追加されました。サンプルから、「UdonExampleScene」をクリック。
![Creator Companion](https://nekosakamiti.com/wp-content/uploads/2022/08/image-19.png)
すると、サンプルのシーンが開かれます。
![Creator Companion](https://nekosakamiti.com/wp-content/uploads/2022/08/image-20-1024x557.jpg)
ClientSimlatorを使ってUnity上でワールドテスト
ClientSimlatorとは
さて、さっきからパッケージの中に含まれているこれ↓の説明が必要ですね。
ワールド系のプロジェクトを作ると、こちらのClientSimlatorが追加されています。
![ClientSimlator](https://nekosakamiti.com/wp-content/uploads/2022/08/image-30.png)
この、ClientSimlatorですが、なんと
Unity上でVRChatワールドの動作テストが可能!!!
![友達](https://nekosakamiti.com/wp-content/uploads/2021/02/icon2.png)
すげえええええええ!!!!!!!!
今までは「テストビルドしてVRChatを立ち上げて実験」という手間がかかりましたが、Unity上でさくっと動かすことが可能になりました。
ClientSimlatorを使ってみよう
実際に動かすための手順をご紹介します。
まず、プロジェクトにClientSimlatorが入っているか確認してください。
入ってない場合は「Add」で追加してください。
![ClientSimlator](https://nekosakamiti.com/wp-content/uploads/2022/08/image-32-1024x394.png)
プロジェクトを開きます。先程のサンプルシーンを使ってみます。
![ClientSimlator](https://nekosakamiti.com/wp-content/uploads/2022/08/image-31-1024x557.jpg)
(スクリーンショットでのレイアウトでは)画面中央にある「再生」を押してください。
![ClientSimlator](https://nekosakamiti.com/wp-content/uploads/2022/08/image-31-1024x238.png)
すると、以下のようなメッセージが表示されます。
ざっくりと、「実際の挙動とはちょっと異なるかもしれません。Build&Test機能での動作確認もしてね」とのことです。OKをクリックして進んでください。
![ClientSimlator](https://nekosakamiti.com/wp-content/uploads/2022/08/image-33-1024x856.jpg)
すると、そこには見慣れた景色が!!!!
はい、これでもう完了です。デスクトップモードのVRChatと同じ操作感で動作確認ができます。
![ClientSimlator](https://nekosakamiti.com/wp-content/uploads/2022/08/image-33-3-1024x943.jpg)
アクションも動作確認できます。
例えば、ミラーのオンオフ切り替えも以下のように動かせました。
![ClientSimlator](https://nekosakamiti.com/wp-content/uploads/2022/08/image-33-1-1024x771.jpg)
![ClientSimlator](https://nekosakamiti.com/wp-content/uploads/2022/08/image-33-2-1024x690.jpg)
通常のVRChatと異なる点は、Escキーで開くことのできるメニュー。
ここでは、デバッグのための様々な機能が利用できます。
![ClientSimlator](https://nekosakamiti.com/wp-content/uploads/2022/08/image-33-4-1024x812.jpg)
![友達](https://nekosakamiti.com/wp-content/uploads/2021/02/icon2.png)
さくっと身長を変更できるのとか地味に便利
「Spawn Remote Player」からは、仮のプレイヤーをjoinさせることができます。
ワールドに人数が増えた際の挙動確認に便利です。
![ClientSimlator](https://nekosakamiti.com/wp-content/uploads/2022/08/image-33-5-1024x830.jpg)
後述する「Setting Window」からプレイヤーを追加することも可能です。
こちらから追加すると、追加するプレイヤーの名称も設定できます。
![ClientSimlator](https://nekosakamiti.com/wp-content/uploads/2022/08/image-33.png)
複数人追加することもできます。
三人目を追加してみましょう。名前は「さんにんめ」にしました。
「Remote Player Name」に名称を打ち込み、「Spawn Remote Player」を押してください。
![ClientSimlator](https://nekosakamiti.com/wp-content/uploads/2022/08/image-34.png)
「さんにんめ」が追加されました。不要な場合は「Remove Player」で削除できます。
![ClientSimlator](https://nekosakamiti.com/wp-content/uploads/2022/08/image-35.png)
これで追加されたはずですが、全く同じ場所に生成されるようなので見た目は分かりません。
入室音の動作確認、部屋の人数カウンタが正常に動いているかなどを確認するのに重宝しそうです。
![ClientSimlator](https://nekosakamiti.com/wp-content/uploads/2022/08/image-36-1024x954.jpg)
「SettingWindow」を押すと、Unity上にClientSimの設定画面が出ます。
プレイヤー名、自身がインスタンスのオーナーかどうかなど、1人で試すには苦戦しがちな部分が設定として押さえてあります。
![ClientSimlator](https://nekosakamiti.com/wp-content/uploads/2022/08/image-36.png)
![管理人](https://nekosakamiti.com/wp-content/uploads/2023/01/icon20230105.png)
なお、ClientSim実行中は多くの設定が非活性(選べない)になっています
![友達](https://nekosakamiti.com/wp-content/uploads/2021/02/icon2.png)
すべての設定をさわるためにはClientSim外から設定画面を開く必要あり!
Unity上からClientSimの設定画面を開くには
上部メニューの「Utilities」→「ClientSim」と押してください。
![ClientSimlator](https://nekosakamiti.com/wp-content/uploads/2022/08/image-37.png)
終わりに
以上、Creator Companionのご紹介でした。
今まで面倒に思ってたプロジェクトの管理、ワールドテスト、パッケージの更新等がひとつにまとまり、かなり直感的に利用できるようになりました。
![管理人](https://nekosakamiti.com/wp-content/uploads/2023/01/icon20230105.png)
個人的にはClientSimlatorのワールドテスト機能に感動しました。
最後に注意ですが、現状これらはすべてベータ版です。ここにある情報は当記事執筆時のものであり、自身で利用の際は
- 最新の情報をちゃんと調べる
- こまめにバックアップを取る
の2点をお忘れなく!
それでは、よいVRChatライフを~!