diff --git a/content/docs/vrchat/unity.md b/content/docs/vrchat/unity.md index f27b31c..26a3f07 100644 --- a/content/docs/vrchat/unity.md +++ b/content/docs/vrchat/unity.md @@ -57,6 +57,39 @@ exec flatpak run com.unity.UnityHub "$@" --> +## World & Avatar test builds + +1. Symlink the VRCSDK's output folder on Linux into the VRChat wine prefix. + +If VRChat is installed in the default location: + +```bash +cd ~/.local/share/Steam/steamapps/compatdata/438100/pfx/drive_c/users/steamuser/AppData/LocalLow/VRChat/VRChat/ + +mkdir -p ~/.local/share/VRChat/VRChat/{Worlds,Avatars} + +ln -s ~/.local/share/VRChat/VRChat/Worlds . +ln -s ~/.local/share/VRChat/VRChat/Avatars . +``` + +2. Add `--watch-worlds` and/or `--watch-avatars` to the VRChat launch options in Steam. +3. Launch VRC +4. Test build your world or avatar. VRChat will switch to it automatically. + +### Advanced: Testing with more than 1 client + +**Warning: Do NOT run this with system Wine.** It may re-initialize your wine prefix, causing data loss. + +Check `~/.steam/root/steamapps/compatdata/438100/config_info` for the specific proton version's `bin` folder and use the `wine` from inside there. + +This is an example to start VRChat in local test mode, while using `GE-Proton9-11-rtsp15` and the default VRChat install location. Change the `scene-standalonewindows64-samplescene.vrcw` part to match your vrcw filename. + +```bash +WINEPREFIX=~/.steam/root/steamapps/compatdata/438100/pfx + +~/.steam/root/compatibilitytools.d/GE-Proton9-11-rtsp15/files/bin/wine VRChat.exe '--url=create?roomId=2988384194&hidden=true&name=BuildAndRun&url=file:///C%3A%5Cusers%5Csteamuser%5CAppData%5CLocalLow%5CVRChat%5CVRChat%5CWorlds%5Cscene-standalonewindows64-samplescene.vrcw' --watch-worlds +``` + ## Troubleshooting ### Worlds: AssetBundle was not built