2026-11-20 公開

VRChat の SDK でビルドやアップロードが途中で止まるとき

VRChat SDK でビルドやアップロードを始めたのに、途中で止まって進まない。ここでは、VRChat 公式のヘルプが挙げる原因と、Unity のコンソールでエラーを探す手順をまとめます。対象は、パソコンの Unity と VRChat SDK です。公式のページは 2026-11-20 に確かめました。

まず見る所

先に、Unity のコンソールに赤いエラーが出ていないかを見ます。すぐ見られるからです。エラーが無いのに止まるときは、回線を疑います。

公式のヘルプが挙げる 3 つの原因

  • 回線の経路。使っている回線から VRChat の置き場までの経路が悪い、または回線が遮られたり、絞られたりしていることがあります。公式のヘルプは、今のところ Cloudflare WARP を試すことを勧めています
  • ビルドのエラー。Unity のコンソールにエラーが出ています
  • 接続の問題。ふだんの接続の問題でも、アップロードに響くことがあります。公式のヘルプには、接続の問題の別の記事へのつなぎがあります

この記事では、Cloudflare WARP の入れ方は扱いません。ほかのアプリを入れる話になるためです。

始める前に、控えを取る

公式のヘルプは、直す手順を試す前に、プロジェクトの控え(バックアップ)を取ることを勧めています。手で取るか、Creator Companion(VCC)でプロジェクトを選んで Make Backup を選びます。

コンソールでエラーを探す

公式のヘルプにある手順です。

  • Unity で、Ctrl と Shift と C を同時に押して、コンソールを開きます
  • コンソールの右上で、エラー(Error)だけを出すようにします。いくつエラーがあるかも出ます
  • 探すのは赤いエラーです。黄色の警告(Warning)は、ほとんどの場合は気にしなくてかまいません
  • エラーが、入れた素材を指していたら、まずその素材を外し、作った人が新しい版を出していないかを確かめます

原因が分からないときは、新しいプロジェクトを作り、ほかの素材を入れる前に同じことが起きるかを見ます。入れた unitypackage の書き出し方や、今の VRChat SDK とぶつかっていないかを切り分けられる、と公式のヘルプにあります。

よくある原因

公式のヘルプによると、SDK の困りごとでいちばん多いのは、次の 2 つです。

  • 古い、または対応の終わったエディター用の素材を入れていて、今の VRChat SDK とぶつかっている
  • 正しく書き出されていない unitypackage から、アバターを入れた(ぶつかるスクリプトが入っていた)

ほかに、VCC と、プロジェクトに入れたパッケージが新しいかも確かめます。VCC を使わずに SDK を入れたときは、Unity の版が、VRChat の説明にある版(2026-11-20 に見たときは 2022.3.22f1)かを確かめます。

ほかの人の unitypackage を入れるとき

公式のヘルプによると、ほかの人が作った unitypackage を入れるときは、入れるファイルの一覧を下まで見て、VRChat SDK に関係するフォルダーの印を外すのがよい、とされています。VCC より前に作られた古い unitypackage で起きやすい、と書かれています。

アバターを上げるときのこつ

公式のヘルプにある、アバターのときのこつです。

  • 上げるシーンに、ほかのアバターも出ているなら、上げたいアバター以外は無効にします
  • 買ったアバターなら、作った人が入れ方の説明を出していないかを確かめます
  • SDK の見本のアバターが、VRChat SDK のメニューの Samples にあります

まとめ

  • まず Unity のコンソールで、赤いエラーを探します(Ctrl と Shift と C)
  • エラーが入れた素材を指していたら、外して新しい版を確かめます。直す前に控えを取ります
  • エラーが無いのに止まるときは、回線の経路や接続を疑います

直らないとき

SDK の不具合だと思ったら、VRChat の feedback board(不具合の報告の場所)に報告できる、と公式のヘルプにあります。原因が分からないときは、VRChat のサポートに問い合わせます。

公式のヘルプでは、問い合わせには Unity の記録(Editor.log。C:\Users\(ユーザー名)\AppData\Local\Unity\Editor\Editor.log)を添えるよう書かれています。この記録は今の Unity の回の分だけなので、Unity を開き直す前に取ります。送る前に、中身を一度開いて見てください。

確かめていないこと

  • この記事は、VRChat 公式のヘルプに書いてあることをまとめたものです。作者がビルドの止まる場面を起こして確かめたものではありません
  • 「まず見る所」の順(コンソールを先に見る)は、すぐ見られる物から見るための書き手の順で、公式のヘルプが決めた順ではありません
  • メニューやボタンの名前は英語の表示のものです。日本語の表示での名前は確かめていません

出どころ

どれも 2026-11-20 にページを開いて確かめました。

同じ分野の読みもの

こんなツールが欲しい、を送る

困っていることを、ひとことでも。良いアイデアは作って、サイトと X でお知らせします。

どの分野ですかえらばなくてもかまいません

名前やメールは聞きません。送った人を見分けるものは残しません。いただいた声は、作者が読んで、次に作るツールの参考にします。