Before starting work on your VR application, you must first setup three things, Unity, Git, and the ViRSE project itself

Unity setup

As ViRSE is Unity-based, you will first need to setup Unity on your machine. You can find system requirements in the Unity documentation.

• Setup Unity Hub
  • Create a Unity account: https://id.unity.com/en/conversations/bd9462bf-cc4b-45f1-850a-996ed8c627db01bf
  • Download Unity Hub https://unity.com/download
  • Open Unity Hub and login with your account
• Download Unity version 2022.3.19 - it must be this exact version!
  • Navigate to the following link https://unity.com/releases/editor/archive
  • Find Unity 2022.3.19 and click the blue ‘Unity Hub’ button to download through Unity Hub
  • A dialogue should open asking you to “Add modules”, there are three you should tick
    • “Microsoft Visual Studio Community 2022”
    • Windows Build Support (IL2CPP) towards the bottom
    • Documentation (Right at the bottom)

<aside> 🎓 NOTE: If you’re taking the Introduction to Unity 3D course, you won’t need to worry about Git or ViRSE, you can progress to Lesson One

Lesson One - The Unity Editor, GameObjects, Transforms and Lighting

</aside>

Git setup

ViRSE applications are managed with Git (an industry-standard version control system), to start work on your application, a git repo must be made for you to download.

• Create a GitHub account https://github.com/join
• Contact the ViRSE development lead ([email protected]), supplying your GitHub email so a repo can be established for you
• Download and setup GitHub Desktop https://desktop.github.com/

ViRSE project setup

Now that you have Unity and Git setup, the last step is to download your ViRSE project and import into Unity!

• In GitHub Desktop, select File > Clone repository, pasting in your repo link supplied by the ViRSE team - Set the local path to an empty folder on your desktop
• Wait for your project to download, this may take some time
• When prompted how you intend to use this repo, select “for my own purposes”
• When prompted, select “initialize git lfs”
• Open Unity Hub, click Open > Add project from disk, navigate to the directory you cloned your repo into, and select the subfolder “ViRSE Framework Application”
• Wait for Unity to import your project, again, this may take a while!