Skip to content

UnitySetup.md

Latest commit

 

History

History
110 lines (84 loc) · 3.89 KB

UnitySetup.md

File metadata and controls

110 lines (84 loc) · 3.89 KB
Raw

Unity Setup (Linux)

Installing Unity Hub

First, install unityhub (AppImage for any distro, AUR for Arch)

Sign into Unity Hub, then under Settings > License Management, add your serial key (can be found here).

Currently, Steve's Job is built on Unity version 2020.3.6f1. You must install this specific version to work with the project.

Installing Unity Editor...

Note: If you wish to use VS Code as an editor, check this guide to properly set everything up after the Unity Editor is installed.

...the easy way

Clone the steves-job repository:

git clone https://github.com/GooseGirlGames/steves-job

In Unity Hub, under Projects click Add and select the steves-job directory. Unity Hub will inform you that the correct version of the Editor is not installed and offer to let you install it.

That's it! Have fun messing around with Steve's Job!

If you are unable to add the project, continue reading:

...the slightly more convoluted way

To workaround the issue you'll need to create a project before attempting to add the existing steves-job project.

To create a project, you must install the Unity Editor. You could install any version, create a new project and then add steves-job as described above. Then, you'll also get a prompt to install the correct version. You might wish to install the correct version straightaway though:

The usual way of installing the Unity Editor is under the Installs tab. If the correct version is not available, head to the download archive to find the correct version.

If clicking the green Unity Hub button does not launch Unity Hub with an install prompt for you: Right-click the green Unity Hub button and copy the URL. Launch Unity Hub from command line with the URL as a parameter, e.g.:

./UnityHub.AppImage unityhub://2020.3.6f1/338bb68529b2

if using the AppImage, or, if Unity Hub is installed from AUR:

unityhub unityhub://2020.3.6f1/338bb68529b2

The correct version should now install. You might still be unable to add the project. In that case, create a new project with the Unity version you just installed and let the Editor open that project. Close the Editor (perhaps restart Unity Hub too), and now you should be able to add the existing project.

...if Unity Hub just absolutely hates you

If Unity Hub throws a "Not enough space" error during installation, it's most likely due to Unity Hub not liking your /tmp directory.

To work around this, create a directory on your hard drive and use that for installation by passing Unity Hub an environment variable:

mkdir ~/cool_directory
TEMP=$HOME/cool_directory unityhub

Note that the environment variable only needs to be passed for installation. After that, you can launch Unity Hub without it.

Nice to know if Unity just fucking wants to ruin your day:

If Unity just gives you two empty errors, set the envvar DOTNET_SYSTEM_GLOBALIZATION_INVARIANT=1. On most systems, this can be done, by appending the line above to /etc/environment.

some more useful hints:

If Unity Editor just keeps on crashing, esp. when opening Package Manager: If you are on Intel graphics, revert Mesa from 21 to 20, e.g. like this:

pacman -U /var/cache/pacman/pkg/mesa-20.3.4-3-x86_64.pkg.tar.zst /var/cache/pacman/pkg/lib32-mesa-20.3.4-3-x86_64.pkg.tar.zst

There may be a better solution, and the issue might be fixed in the future. See Unity bug tracker for more info.