VRCX/README.jp.md

VRCX

| English | 日本語 |

VRCX は VRChat のアシスタント用アプリケーションで、フレンドに関する情報の提供や管理を行うツールです。本アプリケーションは非公式の「VRChat API SDK」を使用しています。

VRCX は VRChat によって承認されておらず、VRChat または VRChat の公式に関与する者の意見や見解を反映していません。VRChat 及び関連する全てのプロパティは VRChat 株式会社の商標または登録商標です。VRChat © VRChat 株式会社

pypy と Natsumi は VRCX の使用によって発生したいかなる問題にも責任を負いません。自己責任でご使用ください！

インストール方法

• 最新のリリースをダウンロード
• VRCX_Setup.exe を実行

これは VRChat の利用規約に違反しますか？

一言で言えば: いいえ。

VRChat Discord の #faq に記載されている、API の使用に関する公式声明です。

スクリーンショット

クリックして展開

ログイン

フィード

ゲームログ

ユーザー情報

自分

フレンド

ワールド

お気に入り

フレンド

ワールド

アバター

フレンドログ

モデレーション

通知

プレイヤーリスト

設定

一般

外観

通知

手首オーバーレイ

Discord Presence

詳細

その他

Join

インスタンス作成

Discord Rich Presence

VR オーバーレイ (旧バージョン)

テーマ

テーマをインストールするには custom.css を %AppData%\VRCX フォルダーに配置し、 Shift+Alt+R を押してください。

Dark Vanilla by MintLily

Pink Theme by Kamiya

Material 3 by Kamiya

起動オプション

• --debug Chromium DevTools 付きで VRCX を起動します。
• --config="C:\VRCX.sqlite3" VRCX で使用するデータベースのカスタムパスを指定します。
• --gpufix VRCX のオーバーレイ描画用 GPU を Index 1 に設定することで、セカンダリ GPU に描画を強制し、また統合 GPU を使用している場合は、専用 GPU に描画を強制します。
• vrcx://user/usr_id ユーザーダイアログを開きます。
• vrcx://avatar/avtr_id アバターダイアログを開きます。
• vrcx://group/grp_id グループダイアログを開きます。
• vrcx://world/wrld_id ワールドダイアログを開きます。
• vrcx://world/wrld_id:12345 インスタンス情報付きのワールドダイアログを開きます。
• vrcx://world/https://vrch.at/0gmbxjpj アンロックされたインスタンス情報付きのワールドダイアログを開きます。
• vrcx://import/avatar/avtr_id,avtr_id... お気に入りアバターのインポートダイアログを開きます。
• vrcx://import/world/wrld_id,wrld_id... お気に入りワールドのインポートダイアログを開きます。
• vrcx://import/friend/usr_id,usr_id... お気に入りフレンドのインポートダイアログを開きます。
• vrcx://addavatardb/https://website/vrcx_search.php リモートアバターデータベースプロバイダーのダイアログを開きます。

ショートカットキー

• Ctrl + Shift + I Chromium DevTools を開きます。
• Ctrl + R VRCX を再起動します。
• Shift + Alt + R カスタム CSS を再読み込みします。

よくある問題

VRCX の動作が重い

• 設定 > 外観 > テーブルの最大数
  • 値を 100 ぐらいまで下げることで、RAM に保存されるエントリの量が減ります。
• 設定 > 詳細 > キャッシュの自動消去
  • 値を 3 ぐらいまで下げることで、RAM に保存される不要なワールド、ユーザー、アバターの量が減ります。

白い画面で固まる

この現象は、さまざまな原因で引き起こされる可能性があります:

• Microsoft Visual C++ Redistributable 2019 をインストールしてみてください。
• PC を再起動してみてください。他のプロセスがデータベースファイルを読もうとしている可能性があります。
• アンチウイルスソフトを無効化してみてください。Avast と AVG は Cef/VRCX を削除してしまいます。
• AverMedia AssistCentral をアンイストールしてみてください。原因は不明ですが、VRCX に問題を起こしてしまいます。
• RAM が不安定な可能性があります。もしオーバークロックしているなら定格に戻し、MemTest86 を実行してください。
• VRCX を管理者として実行してみてください。理由は不明ですが、まれに直ることがあります。
• データベースを再作成してみてください。VRCX を終了し、 %AppData%\VRCX を開いて、 VRCX.sqlite3 を Backup.sqlite3 などにリネームして現在のデータベースをバックアップします。もし以前のデータを保持したい場合は以下の手順に従ってデータベースを修復してください。

SteamVR オーバーレイが動かない

• VRCX を --gpufix の起動オプション付きで起動してみてください。
• SteamVR のセーフモードを無効化してください。
• もし内蔵 GPU を搭載している PC を使用しているなら、こちらの手順に従ってみてください。

データベースを修復する方法

• VRCX を終了する。
• DB Browser for SQLiteをインストールする。
• ファイル > データベースを開く...
• %AppData%\VRCX\ に移動し、 VRCX.sqlite3 を選択する。
• ファイル > エクスポート > データベースを SQL ファイルへ...
• 保存ボタンをクリックし、適当な場所にファイルを保存する。
• ファイル > データベースを閉じる
• %AppData%\VRCX\ にある VRCX.sqlite3 の名前を Backup.sqlite3 などに変更する。
• ファイル > インポート > SQL からデータベースへ...
• はいを押して新しいデータベースを作成。
• %AppData%\VRCX\ に移動し、 VRCX.sqlite3 と名前を付けて保存。
• ファイル > 変更を書き込み
• DB Browser を閉じ、不要になった *.sql ファイルを削除。

Linux で実行する方法

RinLovesYou氏のガイドより。

• Wine をインストール

  • Arch Linux: multilibリポジトリを有効化し、 sudo pacman -S wine を実行することでインストールできます。

  • Ubuntu: wikiを参照してください。

• Winetricks Magic

  Wine 7.0rc5 以降を使用している必要があります！それ以前のバージョンではテストしていません。Wine 7.0 以降では VRCX の動作に必要な「.NET Framework」のフルインストールが可能になりました。

  • クリーンな Wine Prefix で実行します。VRCX 用に新規で作成するか、rm -rf ~/.wine でメインの Prefix を使用します。

  • Prefix 内でも VRCX.exe でも、DXVK を使用していないことを確認してください。VRCX の動作には WineD3D が必要です。

  • winetricks --force -q dotnet472 corefonts 依存関係をインストールするプロセスを静かに、かつ簡単に自動化できます。

  • wine winecfg -v win10 Prefix で使用する Windows のバージョンを指定します。

  • 108 より新しい CEF は、現時点では wine staging 8.4 と互換性がないため、Linux ブランチが必要です。Linux ブランチの Actions タブにある VRCX の Artifact をダウンロードし、展開します。

  • これで wine VRCX.exe が実行できるようになるはずです。CEFSharp に関するエラーが出た場合は wine VRCX.exe -no-cef-sandbox を試してみてください。

• メモ

  • Linux 上での VRCX はメモリリークが発生することが知られています。メモリ使用量に注意するか、あるいはこまめに再起動するようにしてください。

  • Intel iGPU + NVIDIA GPU のノートパソコンを使用している場合は nvidia-settings でグラフィックデバイスを NVIDIA GPU に強制する必要があります。

  

ソースコードからビルドする方法

• ソースコードを入手

  • 最新のzipをダウンロードするか、 git clone でクローンする。

• .NET でビルド

  • Visual Studio をインストールする。
  • Visual Studio を起動し、「プロジェクトやソリューションを開く」をクリックし、ソースコード内のソリューション ファイルを開く。
  • ビルド構成から Debug を Release に変更し、プラットフォームを x64 に変更する。
  • NuGet パッケージを復元する。
  • ソリューションをビルドする。

• Node.js でビルド

  • Node.js をダウンロードし、インストールする。
  • build-node.js.cmd を実行する。
  • make-junction.cmd を実行する。

• リリース用 zip を作成

  • Bandizip 用の make-zip.cmd または 7-Zip 用の make-zip-7z.cmd を実行する。