Files
VRCX/README.jp.md
あさると 1bc28e2443 Add japanese localization (#522)
* 1

* update ja.json

* translate to side_panel

* translate to notifications

* translate to Discord RPC

* translate to sqlite_table_size

* update when_to_play

* translate to user

* translate to world actions

* translate to world info

* translate to avatar actions

* translate to group tags

* translate to world_import and several changes

* clear, 削除→消去

* 書き出す→エクスポート

* translate to friend_import

* finally

* add readme.jp

* translate to screenshots

* translate to launch parameter

* translate to repair db

* fix

* translate to how to build

* fix

* fix translation

* change screenshots (en to ja

* some fix

* update translation

* update translation
2023-04-27 13:23:10 +12:00

252 lines
14 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# VRCX
[![GitHub Workflow Status](https://github.com/vrcx-team/VRCX/actions/workflows/github_actions.yml/badge.svg)](https://github.com/vrcx-team/VRCX/actions/workflows/github_actions.yml)
[![VRCX Discord Invite](https://img.shields.io/discord/854071236363550763?color=%237289DA&logo=discord&logoColor=white)](https://vrcx.pypy.moe/discord)
VRCXはVRChatのアシスタント用アプリケーションで、フレンドに関する情報の提供や管理を行うツールです。本アプリケーションは非公式の「VRChat API SDK」を使用しています。
VRCXはVRChatによって承認されておらず、VRChatまたはVRChatの公式に関与する者の意見や見解を反映していません。VRChat及び関連する全てのプロパティはVRChat株式会社の商標または登録商標です。VRChat © VRChat株式会社
pypyとNatsumiはVRCXの使用によって発生したいかなる問題にも責任を負いません。**_自己責任でご使用ください_**
## インストール方法
- 最新のリリースを[ダウンロード](https://github.com/vrcx-team/VRCX/releases/latest)
- `VRCX_Setup.exe`を実行
## VRChatの利用規約に違反しますか
**一言で言えば:** いいえ。
_VRChat Discordの #faq に記載されている、APIの使用に関する公式声明です。_
![vrchat api](https://user-images.githubusercontent.com/11171153/114227156-b559c400-99c8-11eb-9df6-ee6615b8118e.png)
# スクリーンショット
<details><summary><h2>クリックして展開</h2></summary>
### ログイン
![login](https://cdn.discordapp.com/attachments/1098123459634139167/1098150151471759430/image.png)
![2fa](https://cdn.discordapp.com/attachments/1098123459634139167/1098150435002527794/image.png)
### フィード
![feed](https://cdn.discordapp.com/attachments/1098123459634139167/1098151111963181066/image.png)
### ゲームログ
![gamelog](https://cdn.discordapp.com/attachments/1098123459634139167/1098151427148370010/image.png)
### ユーザー情報
#### 自分
![me](https://cdn.discordapp.com/attachments/1098123459634139167/1098151750277537792/image.png)
#### フレンド
![friend](https://cdn.discordapp.com/attachments/1098123459634139167/1098152156294565949/image.png)
### ワールド
![instance](https://cdn.discordapp.com/attachments/1098123459634139167/1098153504834588782/image.png)
![info](https://cdn.discordapp.com/attachments/1098123459634139167/1098153774377336883/image.png)
### お気に入り
#### フレンド
![friend](https://cdn.discordapp.com/attachments/1098123459634139167/1098157650761490452/image.png)
#### ワールド
![world](https://cdn.discordapp.com/attachments/1098123459634139167/1098158554944376832/image.png)
#### アバター
![avatar](https://cdn.discordapp.com/attachments/1098123459634139167/1098158789254983691/image.png)
### フレンドログ
![friendlog](https://cdn.discordapp.com/attachments/1098123459634139167/1098159999936643113/image.png)
### モデレーション
![moderation](https://cdn.discordapp.com/attachments/1098123459634139167/1098161183229493258/image.png)
### 通知
![notification](https://cdn.discordapp.com/attachments/1098123459634139167/1098161309847134328/image.png)
### プレイヤーリスト
![image](https://cdn.discordapp.com/attachments/1098123459634139167/1098161447348994108/image.png)
### 設定
#### 一般
![general](https://cdn.discordapp.com/attachments/1098123459634139167/1098161646989492264/image.png)
#### 外観
![appearance](https://cdn.discordapp.com/attachments/1098123459634139167/1098161809220960267/image.png)
#### 通知
![notif](https://cdn.discordapp.com/attachments/1098123459634139167/1098162131234472006/image.png)
#### 手首オーバーレイ
![overlay](https://cdn.discordapp.com/attachments/1098123459634139167/1098162284574036008/image.png)
#### Discord Presence
![rpc_setting](https://cdn.discordapp.com/attachments/1098123459634139167/1098162381718302731/image.png)
#### 詳細
![advance_1](https://cdn.discordapp.com/attachments/1098123459634139167/1098162553642811503/image.png)
### その他
#### Join
![join](https://cdn.discordapp.com/attachments/1098123459634139167/1098162833662947388/image.png)
#### インスタンス作成
![create](https://cdn.discordapp.com/attachments/1098123459634139167/1098163388267376700/image.png)
#### Discord Rich Presence
![rpc](https://user-images.githubusercontent.com/82102170/224725991-3fc81a3d-ca15-4dcb-a057-d713803bd666.png)
### VR オーバーレイ (旧バージョン)
![overlay1](https://user-images.githubusercontent.com/82102170/178281800-af4c69da-a0f5-43d8-9515-e960e1a16b39.png)
![overlay2](https://user-images.githubusercontent.com/82102170/178281884-ea1df88c-f16c-4c83-825c-c285f49b1ff1.png)
</details>
## テーマ
テーマをインストールするには `custom.css``%AppData%\VRCX` フォルダーに配置し、 `Shift+Alt+R` を押してください。
[Dark Vanilla](https://github.com/MintLily/Dark-Vanilla/tree/main/VRCX) by [MintLily](https://github.com/MintLily)
![dark-vanilla](https://user-images.githubusercontent.com/11171153/190136499-13ab2fe3-9fed-4b45-a764-e8665993d994.png)
[Pink Theme](https://github.com/kamiya10/VRCX-theme/tree/main/pink) by [Kamiya](https://github.com/kamiya10)
![pink-theme](https://user-images.githubusercontent.com/11171153/190136121-4d6ba6e5-4a04-43b2-8264-0325c858f2d8.png)
[Material 3](https://github.com/kamiya10/VRCX-theme/tree/main/m3) by [Kamiya](https://github.com/kamiya10)
![material-3](https://user-images.githubusercontent.com/11171153/190136730-65268fac-1dab-4528-813c-b4d5e5e86f7d.png)
## 起動オプション
- `--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](https://aka.ms/vs/17/release/vc_redist.x64.exe)をインストールしてみてください。
- PCを再起動してみてください。他のプロセスがデータベースファイルを読もうとしている可能性があります。
- アンチウイルスソフトを無効化してみてください。AvastとAVGはCef/VRCXを削除してしまいます。
- AverMedia AssistCentralをアンイストールしてみてください。原因は不明ですが、VRCXに問題を起こしてしまいます。
- RAMが不安定な可能性があります。もしオーバークロックしているなら定格に戻し、MemTest86を実行してください。
- VRCXを管理者として実行してみてください。理由は不明ですが、まれに直ることがあります。
- データベースを再作成してみてください。VRCXを終了し、 `%AppData%\VRCX` を開いて、 `VRCX.sqlite3``Backup.sqlite3` などにリネームして現在のデータベースをバックアップします。もし以前のデータを保持したい場合は以下の手順に従ってデータベースを修復してください。
### **SteamVR オーバーレイが動かない**
- VRCXを `--gpufix` の起動オプション付きで起動してみてください。
- SteamVRのセーフモードを無効化してください。
- もし内蔵GPUを搭載しているPCを使用しているなら、[こちらの手順](https://www.windowsdigitals.com/force-chrome-firefox-game-to-use-nvidia-gpu-integrated-graphics/)に従ってみてください。
### **データベースを修復する方法**
- VRCXを終了する。
- [DB Browser for SQLite](https://sqlitebrowser.org/)をインストールする。
- ファイル > データベースを開く...
- `%AppData%\VRCX\` に移動し、 `VRCX.sqlite3` を選択する。
- ファイル > エクスポート > データベースをSQLファイルへ...
- 保存ボタンをクリックし、適当な場所にファイルを保存する。
- ファイル > データベースを閉じる
- `%AppData%\VRCX\` にある `VRCX.sqlite3` の名前を `Backup.sqlite3` などに変更する。
- ファイル > インポート > SQLからデータベースへ...
- はいを押して新しいデータベースを作成。
- `%AppData%\VRCX\` に移動し、 `VRCX.sqlite3` と名前を付けて保存。
- ファイル > 変更を書き込み
- DB Browserを閉じ、不要になった `*.sql` ファイルを削除。
## Linuxで実行する方法
[RinLovesYou](https://github.com/RinLovesYou)氏のガイドより。
- Wineをインストール
- Arch Linux: [multilib](https://wiki.archlinux.org/title/Multilib)リポジトリを有効化し、 `sudo pacman -S wine` を実行することでインストールできます。
- Ubuntu: [wiki](https://wiki.winehq.org/Ubuntu)を参照してください。
- 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に強制する必要があります。
![image](https://camo.githubusercontent.com/ed672a01defae989c4bf5963c0cc9db973b42203e1e5e927f3341c6a9115beb8/68747470733a2f2f63646e2e646973636f72646170702e636f6d2f6174746163686d656e74732f3835343037313233363336333535303736362f3933353531333532313839373233343435322f756e6b6e6f776e2e706e67)
## ソースコードからビルドする方法
- ソースコードを入手
- 最新の[zip](https://github.com/vrcx-team/VRCX/archive/master.zip)をダウンロードするか、`git clone`でクローンする。
- .NETでビルド
- [Visual Studio](https://visualstudio.microsoft.com/)をインストールする。
- Visual Studioを起動し、「プロジェクトやソリューションを開く」をクリックし、ソースコード内の[ソリューション ファイル](https://docs.microsoft.com/en-us/visualstudio/extensibility/internals/solution-dot-sln-file)を開く。
- [ビルド構成](https://docs.microsoft.com/en-us/visualstudio/ide/understanding-build-configurations?view=vs-2019)から`Debug``Release`に変更し、プラットフォームを`x64`に変更する。
- [NuGet](https://docs.microsoft.com/en-us/nuget/consume-packages/package-restore#restore-packages-automatically-using-visual-studio)パッケージを復元する。
- ソリューションを[ビルド](https://docs.microsoft.com/en-us/visualstudio/ide/building-and-cleaning-projects-and-solutions-in-visual-studio)する。
- Node.jsでビルド
- [Node.js](https://nodejs.org/en/download/)をダウンロードし、インストールする。
- `build-node.js.cmd`を実行する。
- `make-junction.cmd`を実行する。
- リリース用zipを作成
- [Bandizip](https://www.bandisoft.com/bandizip)用の`make-zip.cmd`または[7-Zip](https://www.7-zip.org)用の`make-zip-7z.cmd`を実行する。