fresh unity instructions

This commit is contained in:
galister 2023-12-23 12:13:37 +00:00
parent 323c1a3513
commit 1b61d8f5cf

View file

@ -7,13 +7,13 @@ title: Unity
For the best experience, we found that running Unity from [Flatpak](https://flathub.org/apps/com.unity.UnityHub) is usually preferred. For the best experience, we found that running Unity from [Flatpak](https://flathub.org/apps/com.unity.UnityHub) is usually preferred.
## Setting up a VRChat avatar project ## Setting up a VRChat avatar/world project
First, take a look at this page from [the official VRChat docs](https://creators.vrchat.com/sdk/upgrade/unity-2022/#using-the-unity-website) about the Unity 2022 upgrade. We'll do something similar. First, take a look at this page from [the official VRChat docs](https://creators.vrchat.com/sdk/upgrade/unity-2022/#using-the-unity-website) about the Unity 2022 upgrade. We'll do something similar.
1. Install Unity Hub from Flatpak. 1. Install Unity Hub from Flatpak.
1. Install the 3rd party VRChat package manager [`vrc-get`](https://github.com/anatawa12/vrc-get). 1. Install the 3rd party VRChat package manager [`vrc-get`](https://github.com/anatawa12/vrc-get).
- **NOTE**: the version you can install via `cargo` is out of date, so a better option would be to build from source and add the executable to your `$PATH`. - **NOTE**: while the version you can install via `cargo` works fine, it is actually out of date, so a better option would be to build from source and add the executable to your `$PATH`.
1. Open Unity Hub and sign in with your Unity account. 1. Open Unity Hub and sign in with your Unity account.
1. Install **2022.3.6f1** (the current supported Unity version, at the time of writing) by running `xdg-open unityhub://2022.3.6f1/b9e6e7e9fa2d`. 1. Install **2022.3.6f1** (the current supported Unity version, at the time of writing) by running `xdg-open unityhub://2022.3.6f1/b9e6e7e9fa2d`.
1. When prompted, select *Android Build Support* and *Windows Build Support (Mono)*. 1. When prompted, select *Android Build Support* and *Windows Build Support (Mono)*.
@ -21,14 +21,15 @@ First, take a look at this page from [the official VRChat docs](https://creators
1. If it opens a window partially offscreen like it did for me (KWin Wayland), press ALT+F3 -> More Actions -> Move. 1. If it opens a window partially offscreen like it did for me (KWin Wayland), press ALT+F3 -> More Actions -> Move.
1. Close the Unity project (will probably crash later if you don't, no big deal but still). 1. Close the Unity project (will probably crash later if you don't, no big deal but still).
1. Open terminal and `cd` to the project dir. 1. Open terminal and `cd` to the project dir.
1. Run `vrc-get install com.vrchat.avatars 3.5.0-beta.1`, the first (and only, at the time of writing) VRC SDK version that works with 2022. 1. Run either `vrc-get install com.vrchat.avatars` or `vrc-get install com.vrchat.worlds` depending on what you will be making.
1. Reopen the Unity project and it will import the new packages. 1. Reopen the Unity project and it will import the new packages.
1. Go to VRChat SDK -> Show Control Panel and dock it to the main window. 1. Go to VRChat SDK -> Show Control Panel and dock it to the main window.
Now you should be able to create and upload avatars like you normally would. Now you should be able to create and upload avatars and worlds like you normally would.
If you're having issues, consult the [Troubleshooting](#troubleshooting) section. If you're having issues, consult the [Troubleshooting](#troubleshooting) section.
## Troubleshooting ## Troubleshooting
### NullReferenceException when uploading ### NullReferenceException when uploading