vrchat: test worlds / avatars

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