<p><img src="https://res.cloudinary.com/zenn/image/fetch/s--p-j_WI_6--/c_limit%2Cf_auto%2Cfl_progressive%2Cq_auto%2Cw_1200/https://global.discourse-cdn.com/business5/uploads/vrchat/original/2X/3/30bee33466c88e3da2d8ea36aea32eb9389584e8.jpeg" alt loading="lazy" class="md-img"></p>
<h1 id="%E3%81%BE%E3%81%88%E3%81%8C%E3%81%8D">
<a class="header-anchor-link" href="#%E3%81%BE%E3%81%88%E3%81%8C%E3%81%8D" aria-hidden="true"></a> まえがき</h1>
<p>VRChat公式がVRChat Creator Companion(通称VCC)とかいうのを作ったらしい。<br>
なんでも、VRChatでのアバターとかワールド制作用で使える色々をまとめて管理できる便利な子だとか。</p>
<p>なるほど、では早速入れてみ</p>
<p><img src="https://storage.googleapis.com/zenn-user-upload/ef6fd4ac3088-20220924.png" alt loading="lazy" class="md-img"></p>
<p><img src="https://storage.googleapis.com/zenn-user-upload/4ca2a5cc0bdb-20220924.png" alt loading="lazy" class="md-img"></p>
<p><img src="https://storage.googleapis.com/zenn-user-upload/5bee3ed0f832-20220924.png" alt loading="lazy" class="md-img"></p>
<p><img src="https://res.cloudinary.com/zenn/image/fetch/s--7gfu6nT3--/https://thumbs.gfycat.com/AmbitiousFluidKrill.webp" alt loading="lazy" class="md-img"></p>
<p>はい、どうやらWindowsでしか動かないらしいです。</p>
<p>と思ったら、<a href="https://vcc.docs.vrchat.com/vpm/cli/#mac-and-linux-support" target="_blank" rel="nofollow noopener noreferrer">ドキュメント</a>にこんなことが書いてありました</p>
<blockquote>
<p>The only fully-supported platform at the moment is Windows 10. However, we are working to make the vpm tool available to Mac and Linux users.</p>
</blockquote>
<p>ざっくり要約。</p>
<blockquote>
<p>完全なサポートはWin10しかできてないけど、vpm(VCC扱うためのパッケージマネージャー、要はVRChat専用のaptみたいなやつ)はMacとかLinuxでも動きまっせ。</p>
</blockquote>
<p>だそうです。<br>
しかしながら、どこ探しても日本語の解説記事がなかったのでざっくりドキュメントに書いてある導入方法だけここに記しておきます。<br>
みんなGUI好きなんすね。</p>
<h1 id="%E5%89%8D%E6%8F%90%E6%9D%A1%E4%BB%B6">
<a class="header-anchor-link" href="#%E5%89%8D%E6%8F%90%E6%9D%A1%E4%BB%B6" aria-hidden="true"></a> 前提条件</h1>
<ul>
<li>UnityHubがインストール済み</li>
<li>VRChatに対応するバージョンのUnityが<strong>UnityHubを介して</strong>インストール済み</li>
<li>ある程度のコマンド操作は可能</li>
</ul>
<h1 id="%E3%82%A4%E3%83%B3%E3%82%B9%E3%83%88%E3%83%BC%E3%83%AB">
<a class="header-anchor-link" href="#%E3%82%A4%E3%83%B3%E3%82%B9%E3%83%88%E3%83%BC%E3%83%AB" aria-hidden="true"></a> インストール</h1>
<h2 id=".net-6-sdk%E3%81%AE%E3%82%A4%E3%83%B3%E3%82%B9%E3%83%88%E3%83%BC%E3%83%AB">
<a class="header-anchor-link" href="#.net-6-sdk%E3%81%AE%E3%82%A4%E3%83%B3%E3%82%B9%E3%83%88%E3%83%BC%E3%83%AB" aria-hidden="true"></a> .NET 6 SDKのインストール</h2>
<p>まず、VCCを使うにあたって、前述のvpmとかいうパッケージマネージャーをインストールする必要があります。<br>
で、そのvpmを使うためには.NET 6 SDKが必要らしいので、インストールします。<br>
(2022/12/15追記 : Arch Linuxの<code>dotnet-sdk</code>は7.0なので、VPMを使う場合、別途6.0もインストールする必要があります)</p>
<div class="code-block-container">
<div class="code-block-filename-container"><span class="code-block-filename">Arch Linux (pacman)</span></div>
<pre class="language-shell"><code class="language-shell">$ <span class="token function">sudo</span> pacman <span class="token parameter variable">-S</span> dotnet-sdk-6.0
</code></pre>
</div><p>最近どうもUbuntuでも標準リポジトリに入ったらしい</p>
<div class="code-block-container">
<div class="code-block-filename-container"><span class="code-block-filename">Ubuntu (apt)</span></div>
<pre class="language-shell"><code class="language-shell">$ <span class="token function">sudo</span> <span class="token function">apt-get</span> <span class="token function">install</span> <span class="token parameter variable">-y</span> dotnet6
</code></pre>
</div><p>その他のディストリビューションとかmacOSはググってください。</p>
<h2 id="vpm%E3%81%AE%E3%82%A4%E3%83%B3%E3%82%B9%E3%83%88%E3%83%BC%E3%83%AB">
<a class="header-anchor-link" href="#vpm%E3%81%AE%E3%82%A4%E3%83%B3%E3%82%B9%E3%83%88%E3%83%BC%E3%83%AB" aria-hidden="true"></a> vpmのインストール</h2>
<p>下準備が整ったので、dotnetコマンドでvpmをインストールしていきます。</p>
<div class="code-block-container"><pre class="language-shell"><code class="language-shell">$ dotnet tool <span class="token function">install</span> <span class="token parameter variable">--global</span> vrchat.vpm.cli
</code></pre></div><p>正常にインストールできていれば</p>
<div class="code-block-container"><pre class="language-shell"><code class="language-shell">$ vpm <span class="token parameter variable">--version</span>
</code></pre></div><p>で現在のvpmバージョンが出るはずです。<br>
これでコマンドが存在しない趣旨のメッセージが表示された場合は、おそらくPATHが通っていないので、.bashrcを編集するなりexportコマンドを使うなりしてPATHを通してください。</p>
<p>既にインストール済みのvpmをアップデートする場合は</p>
<div class="code-block-container"><pre class="language-shell"><code class="language-shell">$ dotnet tool update <span class="token parameter variable">--global</span> vrchat.vpm.cli
</code></pre></div><p>アンインストールは</p>
<div class="code-block-container"><pre class="language-shell"><code class="language-shell">$ dotnet tool uninstall <span class="token parameter variable">--global</span> vrchat.vpm.cli
</code></pre></div><p>でできます。</p>
<h2 id="%E3%83%86%E3%83%B3%E3%83%97%E3%83%AC%E3%83%BC%E3%83%88%E3%81%AE%E3%82%A4%E3%83%B3%E3%82%B9%E3%83%88%E3%83%BC%E3%83%AB">
<a class="header-anchor-link" href="#%E3%83%86%E3%83%B3%E3%83%97%E3%83%AC%E3%83%BC%E3%83%88%E3%81%AE%E3%82%A4%E3%83%B3%E3%82%B9%E3%83%88%E3%83%BC%E3%83%AB" aria-hidden="true"></a> テンプレートのインストール</h2>
<p>vpmのインストールはできましたが、パッケージマネージャー部分しかインストールされていないので、テンプレート(俗に言うVCCの部分)をインストールしていきます。</p>
<div class="code-block-container"><pre class="language-shell"><code class="language-shell">$ vpm <span class="token function">install</span> templates
</code></pre></div><p>でテンプレートがインストールできます。<br>
インストール済みのテンプレートは</p>
<div class="code-block-container"><pre class="language-shell"><code class="language-shell">$ vpm list templates
</code></pre></div><p>で確認できます。<br>
デフォルトでは、<code>Base</code>、<code>World</code>、<code>Avatar</code>、<code>UdonSharp</code>、の4つが入っているはずです。</p>
<h2 id="unity%E3%81%AE%E3%82%A4%E3%83%B3%E3%82%B9%E3%83%88%E3%83%BC%E3%83%AB%E3%83%91%E3%82%B9%E8%A8%AD%E5%AE%9A">
<a class="header-anchor-link" href="#unity%E3%81%AE%E3%82%A4%E3%83%B3%E3%82%B9%E3%83%88%E3%83%BC%E3%83%AB%E3%83%91%E3%82%B9%E8%A8%AD%E5%AE%9A" aria-hidden="true"></a> Unityのインストールパス設定</h2>
<p>さて、続いてUnityHubとUnityのインストール先を指定します。<br>
<code>~/.local/share/VRChatCreatorCompanion/settings.json</code><br>
を開いて、<code>pathToUnityExe</code>にUnity、<code>pathToUnityHub</code>にUnityHubの実行ファイルへのパスを指定します。</p>
<p>UnityHubは、AURからインストールしていれば、<br>
<code>/opt/unityhub/unityhub</code><br>
になるはずです。</p>
<p>Unityのインストール先は、UnityHubを開き、左上の歯車マークから、Installsタブを開けば出てくるので、その中の<br>
<code>[Unityのインストール先]/[Unityのバージョン]/Editor/Unity</code><br>
を指定してあげましょう。</p>
<p><img src="https://storage.googleapis.com/zenn-user-upload/08cd4a0d8ee6-20220924.png" alt loading="lazy" class="md-img"></p>
<p><img src="https://storage.googleapis.com/zenn-user-upload/2ec9d4a18ccc-20220924.png" alt loading="lazy" class="md-img"></p>
<p><code>settings.json</code>にUnityのインストール先を書き込み終えたら</p>
<div class="code-block-container"><pre class="language-shell"><code class="language-shell">$ vpm check hub
</code></pre></div><p>と</p>
<div class="code-block-container"><pre class="language-chell"><code class="language-chell">$ vpm check unity
</code></pre></div><p>でそれぞれちゃんと設定できてるか確認します。<br>
何故か<code>vpm check hub</code>したときにエラーが出てきますが、その下に<code>Found Unity Hub version at [指定したパス]</code>ってでてれば問題ないです。</p>
<p>ちなみに、<code>settings.json</code>には他にも、デフォルトのプロジェクト作成先とか、バックアップ作成先のパスとか、いろいろ設定できるので、各自お好みで変更しておきましょう。</p>
<p>これで基本的な設定は完了しました。</p>
<h1 id="%E6%96%B0%E8%A6%8F%E3%83%97%E3%83%AD%E3%82%B8%E3%82%A7%E3%82%AF%E3%83%88%E3%81%AE%E4%BD%9C%E6%88%90">
<a class="header-anchor-link" href="#%E6%96%B0%E8%A6%8F%E3%83%97%E3%83%AD%E3%82%B8%E3%82%A7%E3%82%AF%E3%83%88%E3%81%AE%E4%BD%9C%E6%88%90" aria-hidden="true"></a> 新規プロジェクトの作成</h1>
<p>さて、VCCで新規プロジェクトを作成していきます。</p>
<div class="code-block-container"><pre class="language-shell"><code class="language-shell">$ vpm new <span class="token operator">&lt;</span>プロジェクト名<span class="token operator">&gt;</span> <span class="token punctuation">[</span>テンプレート<span class="token punctuation">]</span> <span class="token punctuation">[</span>-p プロジェクト作成先パス<span class="token punctuation">]</span>
</code></pre></div><p>で新規プロジェクトの作成ができます。<br>
プロジェクト名は必須、テンプレートは未指定の場合は<code>Base</code>が使われます。<br>
プロジェクト作成パスが未指定の場合、前述の<code>settings.json</code>の<code>"defaultProjectPath"</code>に記載されているパスが使われます。</p>
<p>テンプレートはデフォルトで、<code>Base</code>、<code>World</code>、<code>Avatar</code>、<code>UdonSharp</code>の3つが入っており、それぞれ</p>
<table>
<thead>
<tr>
<th style="text-align:center">テンプレート</th>
<th style="text-align:center">内容</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align:center">Base</td>
<td style="text-align:center">アバター、ワールド共に必要な必須パッケージ群</td>
</tr>
<tr>
<td style="text-align:center">World</td>
<td style="text-align:center">Base + ワールドアップロードに必要なパッケージ群(SDK3 - Worldsに該当)</td>
</tr>
<tr>
<td style="text-align:center">Avatar</td>
<td style="text-align:center">Base + アバターアップロードに必要なパッケージ群(SDK3 - Avatarsに該当)</td>
</tr>
<tr>
<td style="text-align:center">UdonSharp</td>
<td style="text-align:center">Base + World + UdonSharp</td>
</tr>
</tbody>
</table>
<p>ちなみに、従来のSDK3 - Worldsに含まれない内容として、Worldsには一緒にClientSimも入ってきます。<br>
(が、正直言ってあまり使い物にならない)</p>
<p>ちなみに、自分でテンプレートを作ることもできるらしいです。</p>
<p>プロジェクトを作成したら、UnityHubを開き、Openを押して、作成したプロジェクトのディレクトリを指定してあげれば、あとは大体今まで通りのVRCSDKです。</p>
<h1 id="%E3%83%97%E3%83%AD%E3%82%B8%E3%82%A7%E3%82%AF%E3%83%88%E3%81%AE%E7%B5%B1%E5%90%88">
<a class="header-anchor-link" href="#%E3%83%97%E3%83%AD%E3%82%B8%E3%82%A7%E3%82%AF%E3%83%88%E3%81%AE%E7%B5%B1%E5%90%88" aria-hidden="true"></a> プロジェクトの統合</h1>
<p>従来のSDKで作成したワールドを、VCCに移行する方法です。<br>
ただし、<strong>SDK2には対応していません</strong>。<br>
一応、公式曰くUnity 2017, 2018, 2019で作成されたプロジェクトであれば統合可能で、UdonSharpとかCyanEmuは自動でVCC対応版にアップデートされるそうです。</p>
<p><s>なんですが、Unity 2017時代のプロジェクトを統合しようとしてみたら、見事に大量のエラーを吐かれたので、最新版SDKにしてから統合した方が良いでしょう。</s></p>
<p><strong>2022/11/13追記</strong><br>
どうも統合後に、古いVRCSDKが消されずエラーになるらしいです。<br>
とりあえず、統合後に、<code>プロジェクトフォルダ/Assets</code>直下の<br>
アバターの場合は</p>
<ul>
<li>VRCSDK<br>
ワールドの場合は</li>
<li>VRCSDK</li>
<li>VRChat Examples</li>
<li>Udon</li>
<li>UdonSharp<br>
と、それらの.metaファイルを削除すれば動くようになります。</li>
</ul>
<p>既存プロジェクトが何で作られているかは</p>
<div class="code-block-container"><pre class="language-shell"><code class="language-shell">$ vpm check <span class="token punctuation">[</span>プロジェクト名<span class="token punctuation">]</span>
</code></pre></div><p>で確認できます。<br>
一応、確認した限りだと</p>
<table>
<thead>
<tr>
<th style="text-align:center">出力</th>
<th style="text-align:center">内容</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align:center">AvatarVPM</td>
<td style="text-align:center">VPMで作成or統合したアバター用プロジェクト</td>
</tr>
<tr>
<td style="text-align:center">WorldVPM</td>
<td style="text-align:center">VPMで作成or統合したワールド用プロジェクト</td>
</tr>
<tr>
<td style="text-align:center">LegacySDK3Avatar</td>
<td style="text-align:center">SDK3 - Avatarで作成されたプロジェクト</td>
</tr>
<tr>
<td style="text-align:center">LegacySDK3World</td>
<td style="text-align:center">SDK3 - Worldで作成されたプロジェクト</td>
</tr>
<tr>
<td style="text-align:center">LegacySDK2</td>
<td style="text-align:center">SDK2で作成されたプロジェクト</td>
</tr>
</tbody>
</table>
<p>って感じの出力になるっぽいです。</p>
<p>ということで、パッケージの統合を行います</p>
<div class="code-block-container"><pre class="language-shell"><code class="language-shell">$ vpm migrate project <span class="token punctuation">[</span>プロジェクト名<span class="token punctuation">]</span>
</code></pre></div><p>で統合が始まります。</p>
<p><code>LegacyProject</code>という名前のプロジェクトを統合した場合、<br>
<code>LegacyProject-Migrated</code>って感じで統合したプロジェクトが出てきます。<br>
しかもこの<code>vpm migrate</code>、どういうわけか<strong>統合先ディレクトリの明示的な指定ができません</strong>。<br>
というか他のコマンドだと<code>-p</code>オプションで出力先を明示的に指定できるんですけど、なんでこれだけできないんですかね。<br>
わけがわからないよ。<br>
ということで、</p>
<div class="code-block-container"><pre class="language-shell"><code class="language-shell">$ vpm migrate project <span class="token punctuation">[</span>プロジェクト名<span class="token punctuation">]</span><span class="token operator">&amp;&amp;</span><span class="token function">mv</span> <span class="token punctuation">[</span>プロジェクト名<span class="token punctuation">]</span>/<span class="token punctuation">[</span>プロジェクト名<span class="token punctuation">]</span>-Migrated ./
</code></pre></div><p>って感じにしないといけないわけです。<br>
<strong>クソ面倒。</strong></p>
<h1 id="%E3%83%AA%E3%83%9D%E3%82%B8%E3%83%88%E3%83%AA%E3%81%AE%E3%82%A4%E3%83%B3%E3%82%B9%E3%83%88%E3%83%BC%E3%83%AB">
<a class="header-anchor-link" href="#%E3%83%AA%E3%83%9D%E3%82%B8%E3%83%88%E3%83%AA%E3%81%AE%E3%82%A4%E3%83%B3%E3%82%B9%E3%83%88%E3%83%BC%E3%83%AB" aria-hidden="true"></a> リポジトリのインストール</h1>
<p>VPMでリポジトリの更新とかそこら辺が管理できるようになったっぽいんですが。<br>
<strong>調べる限り対応させてるアセットがどこにもない</strong>ので実際に確認できてません。</p>
<p>とりあえず動作未確認ですがやり方だけ置いときます。</p>
<p>現在インストールされているリポジトリ一覧は</p>
<div class="code-block-container"><pre class="language-shell"><code class="language-shell">$ vpm list repos
</code></pre></div><p>リポジトリの追加は</p>
<div class="code-block-container"><pre class="language-shell"><code class="language-shell">$ vpm <span class="token function">add</span> repo <span class="token operator">&lt;</span>リポジトリのパス<span class="token operator">&gt;</span>
</code></pre></div><p>リポジトリの新規作成は</p>
<div class="code-block-container"><pre class="language-shell"><code class="language-shell">$ vpm new repo <span class="token punctuation">[</span>パス<span class="token punctuation">]</span> <span class="token punctuation">[</span>--name 名前<span class="token punctuation">]</span> <span class="token punctuation">[</span>--author メアド<span class="token punctuation">]</span>
</code></pre></div><p>でできるらしいです。</p>
<h1 id="%E3%81%BE%E3%81%A8%E3%82%81">
<a class="header-anchor-link" href="#%E3%81%BE%E3%81%A8%E3%82%81" aria-hidden="true"></a> まとめ</h1>
<p>VCC、もといvpm、対応アセットが増えれば色々便利なのかもしれませんが、今の所しょうじきイマイチな感じかなっていうのが率直な感想です。<br>
CUIしかないっていうのも、まあGUIしかないより幾分かマシではありますが、正直なんかなぁって感じですし、ついでに言えばWorldアセットに至っては、MacとかLinuxとかのUNIX互換環境だと<strong>プロジェクトの作成はできてもアップロードができない</strong>とかいう不具合が相変わらず残ってます。<br>
まあ、GUIに関しては多分誰かがそのうちフロントエンド作ってくれるでしょう。</p>
<h1 id="%E5%8F%82%E8%80%83%E6%96%87%E7%8C%AE%E3%81%A8%E3%81%8B">
<a class="header-anchor-link" href="#%E5%8F%82%E8%80%83%E6%96%87%E7%8C%AE%E3%81%A8%E3%81%8B" aria-hidden="true"></a> 参考文献とか</h1>
<ul>
<li><a href="https://wiki.archlinux.jp/index.php/.NET" target="_blank" rel="nofollow noopener noreferrer">.NET - ArchWiki</a></li>
<li><a href="https://learn.microsoft.com/ja-jp/dotnet/core/install/linux-ubuntu" target="_blank" rel="nofollow noopener noreferrer">Ubuntu に .NET をインストールする - .NET | Microsoft Learn</a></li>
<li><a href="https://vcc.docs.vrchat.com/vpm/cli/" target="_blank" rel="nofollow noopener noreferrer">CLI | VRChat Creator Companion</a></li>
<li><a href="https://vcc.docs.vrchat.com/vpm/templates/" target="_blank" rel="nofollow noopener noreferrer">Templates | VRChat Creator Companion</a></li>
</ul>


【VRChat】VCCをCLIで使う。

cleemy desu wayo

<div class="code-block-container"><pre><code>$ vpm check [プロジェクト名]
</code></pre></div><p>の箇所は、正確には以下ではないでしょうか。</p>
<div class="code-block-container"><pre><code>$ vpm check project [プロジェクト名]
</code></pre></div><p>わたくしは2024年7月になってからバージョン0.1.25の vrchat.vpm.cli を試しただけなので、実は2022年当時は前者でもいけた、とかだったらすいません。</p>


Discussion