MacでVRChatワールドを作る方法 〜Unity環境構築からパッケージ導入まで〜

MacでVRChatワールドの制作に挑戦してみましたが、つまづいたポイントがいくつかあるので、環境構築手順を記事にまとめてみました。

:::note warn
以下の情報は、あくまで個人の技術メモであり、この手順を実行したことによる損害について一切の責任を負いません。あらかじめご了承ください。
:::


# 既存のUnityプロジェクトを開きたい

説明を簡単にするため、VRChatワールド制作用のUnityプロジェクトが既に存在しているものとします。
例えば、他のメンバーがWindows PCで作成したUnityプロジェクトを受け取ったが、自分のPCがMacだった、という状況を想定しています。

ただ、Unityプロジェクトを新規作成する場合でも、そこまで大きく手順は変わらないと思います。


# 大まかな流れ

1. Unity Hubをインストールする。
2. Unity 2022.3.22f1をインストールする。
3. ALCOMをインストールする。
4. ALCOMに既存のプロジェクトを追加する。
5. プロジェクトに必要なパッケージをインストールする。

これでVRChatワールド制作環境がMacで動作するはずです。
以下、詳しく説明していきます。


# 手順

## 1. Unity Hubをインストールする

Unity Hubは以下の公式サイトからダウンロードしてインストールします。

https://unity.com/download

インストール時にUnityアカウントの入力が求められたら入力します。

このあたりは、以下の記事がわかりやすいです！

https://cad-kenkyujo.com/unity-mac/

必要に応じて、メニューの日本語化も行うと良いかもしれません。


## 2. Unity 2022.3.22f1をインストールする

:::note warn
Unityのインストールには大容量データのダウンロードが必要になるため、自宅やオフィス等の高速なインターネット環境で作業を始めてください。
カフェWiFiやスマホテザリング等で作業を始めてしまうと、数時間経ってもダウンロードが終わらないといったことがありますので、ご注意ください。
:::

以下の `Unity ダウンロードアーカイブ` をブラウザで開きます。

https://unity.com/ja/releases/editor/archive

Unity 2022.3.22f1を探して、右側の `INSTALL` をクリックします。

![unity download archive](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/221845/0a93a7b4-e407-60e4-b5b9-995b0596add1.png)

Unity Hubが表示されるはずです。

:::note warn
このタイミングでUnity Hubが表示されないことがまれにあります。
私の場合は、PCを再起動することで症状が改善しました。
:::

以下の２つの選択肢が表示されることがあります。

- Apple Silicon版
- Intel版

その場合はIntel版を選択してください。
Apple Silicon版ではVRChat SDKの一部機能が動作しないためです。

:::note info 
Intel版を選ぶのはあくまでVRChatワールド制作時の話であり、一般的にはApple Silicon版を選ぶ方が多いと思います。
:::

また、モジュール選択画面では以下の２つにチェックを入れます。

- Android Build Support
- Windows Build Support (Mono)

右下の `Continue` をクリックすれば、インストールが始まります。

通信環境によっては15分ほどかかるかもしれません。


## 3. ALCOMをインストールする

ALCOMは以下の公式サイトからダウンロードできます。

https://vrc-get.anatawa12.com/ja/alcom/

VRChat Creator CompanionはmacOSに対応していないため、代替ツールとしてALCOMを使用します。
ALCOMはVRChat非公式のツールですが、オープンソースプロジェクトとして開発されており、10名以上の貢献による信頼性があります。

インストールする際に、Unity Hubのインストール先などを指定する必要があります。


## 4. ALCOMに既存のプロジェクトを追加する

ALCOMを起動します。

![Add Project to ALCOM](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/221845/f6f1ee5d-e81c-4cd5-7e93-cdc630c6a2ce.png)

左側の `プロジェクト` > 右上の `∨` > `既存のプロジェクトを追加` をクリックします。
フォルダ指定ダイアログが表示されるので、追加したいUnityプロジェクトのフォルダを選択します。
`Assets` フォルダの親フォルダを指定してください。
プロジェクトの一覧に1行追加されていれば成功です。

![Project](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/221845/999e8e6f-8099-32d3-c28e-e4b0d94545e6.png)


## 5. プロジェクトに必要なパッケージをインストールする

追加されたプロジェクトの右側にある `管理` をクリックします。
パッケージ一覧が表示されます。

![パッケージ一覧](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/221845/3d85e0c9-a111-6f21-5b08-43670077c9c7.png)

VRChatワールド制作の場合は、以下の3つのパッケージをインストールします。

- VRChat SDK - Base
- VRChat SDK - Worlds
- VRWorld Toolkit

::: note warn
共有されたUnityプロジェクトの場合は、メンバーとパッケージバージョンを揃えるよう注意してください。
バージョンについては、READMEファイルに記載されていることが多いので確認してください。
:::

パッケージのインストールが完了したら、 `UNITYを開く` をクリックします。
Unityが起動します。
初回起動時には10分ほど待つ必要があるかもしれません。


Unityが無事に開けば、VRChatワールド制作環境の構築は完了です！

これでMacでVRChatワールドを制作する準備が整いました！


# Macだとできないこと

MacとWindowsではグラフィックスAPIが異なるため、一部の機能が使えませんのでご注意ください。
具体的には、MacがMetalで、WindowsはDirectXです。

詳しいことはUnity公式の以下のページに記載があります。

https://docs.unity3d.com/ja/2018.4/Manual/SL-PlatformDifferences.html


# さいごに

本記事作成にあたり、以下のページを参考にさせていただきました。ありがとうございました。

- https://cad-kenkyujo.com/unity-mac/
- https://vrc-get.anatawa12.com/ja/alcom/

皆さんの制作活動がスムーズに進むことを願っています！