VRCX/README.jp.md

VRCX

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を実行する。