Installation Guide: Unity & Development Environment
This page documents the setup process for the project. Strict adherence to the versions listed below is required to avoid compatibility issues.
1. Prerequisites: Unity Hub
Before installing the editor, you must install the Unity Hub. This tool manages your Unity versions and project files.
- Go to the Unity Download Page.
- Download and install Unity Hub.
- Launch the application and sign in with your Unity ID.
2. Installing Unity Editor
[!IMPORTANT] Required Version:
Unity 6000.3.8f1Please do not install a newer or older version unless explicitly instructed, as this may break project dependencies.
Method A: Direct Install via Hub (If available)
- Open Unity Hub.
- Go to Installs > Install Editor.
- Check the "Official Releases" tab.
- If version
6000.3.8f1is listed, select it and proceed to Section 3.
Method B: Via Download Archive (Recommended)
If the version is not proposed by default in the Hub, you must use the archive link.
- Visit the Unity Download Archive.
- Select the Unity 6 tab and ensure you are looking at LTS releases.
- Scroll down to find Unity 6000.3.8f1.
- Click the blue Install button next to that version and accept to open it with Unity Hub
- This will trigger the installation wizard inside your Unity Hub.
3. Module Configuration
During the installation window (or by clicking the ⚙️ gear icon on an existing install -> Add Modules), you must select the following components:
📱 Android Build Support
You must expand the arrow next to "Android Build Support" and check the sub-tools:
- Android Build Support
- OpenJDK
- Android SDK & NDK Tools
💻 Development Tools
- Visual Studio Code
[!NOTE] If Visual Studio Code is not listed in the "Dev Tools" section, install it manually from code.visualstudio.com.
4. Troubleshooting
⚠️ "Android SDK/NDK path not found"
If Unity complains about missing Android tools despite having installed the modules:
- Open the project in Unity.
- Go to Edit > Preferences (Windows) or Unity > Settings (Mac).
- Navigate to External Tools.
- Scroll to the Android section.
- Uncheck and then Recheck the boxes for:
- "JDK Installed with Unity"
- "Android SDK Tools Installed with Unity"
- "Android NDK Installed with Unity"
- This forces Unity to refresh the internal file paths.
⚠️ VS Code IntelliSense not working
If code autocompletion is missing:
- In Unity, go to Edit > Preferences > External Tools.
- Set "External Script Editor" to Visual Studio Code.
- Click Regenerate project files.
- Inside VS Code, ensure you have the C# Dev Kit extension installed.