Installation & Setup
Complete step-by-step installation guide for UltraGameCore.

System Requirements

Unity Requirements


Unity Version: 2022.3 LTS or later (recommended: 2023.2 LTS)

Platform: Windows 10+, macOS 10.15+, or Linux Ubuntu 18.04+

Graphics: DirectX 11, OpenGL 3.2, or Vulkan compatible


Required Packages


Netcode for GameObjects: 1.5.0 or later

Input System: 1.4.4 or later

TextMeshPro: 3.0.6 or later (usually included)


Hardware Requirements


RAM: 4GB minimum, 8GB recommended

Storage: 2GB free space for Unity project

Network: Stable internet connection for multiplayer testing


Step 1: Unity Installation

Download Unity Hub

Visit unity.com

Click "Download Unity Hub"

Install Unity Hub for your platform


Install Unity Editor

Open Unity Hub
Go to "Installs" tab
Click "Install Editor"

Select Unity 2022.3 LTS or later
Choose "3D (URP)" modules
Click "Install"



Step 2: Create New Project

Project Setup

Open Unity Hub
Click "New Project"

Select "3D (URP)" template
Configure project:


Project Name: Your game name

Location: Choose your preferred directory

Template: 3D (URP)


Click "Create Project"



Project Structure
Your project should have:

MyProject/
├── Assets/
├── Library/
├── Logs/
├── Packages/
├── ProjectSettings/
└── UserSettings/



Step 3: Install Required Packages

Netcode for GameObjects

In Unity, go to Window > Package Manager

Change dropdown to "Unity Registry"

Search for "Netcode for GameObjects"

Select version 1.5.0 or later
Click "Install"



Input System

In Package Manager, search for "Input System"

Select version 1.4.4 or later
Click "Install"

When prompted, click "Yes" to enable the new Input System


TextMeshPro (if needed)

In Package Manager, search for "TextMeshPro"

Select the latest version
Click "Install"



Step 4: Import UltraGameCore

Download Package

Download UltraGameCore.unitypackage from your source
Save to a known location on your computer


Import Package

In Unity, go to Assets > Import Package > Custom Package

Navigate to and select UltraGameCore.unitypackage

Click "Open"

In the import dialog, ensure all items are checked
Click "Import"

Wait for import to complete (may take a few minutes)


Verify Import
After import, you should see:

Assets/
└── FastSkillTeam/
    ├── UltraGameCore/
    │   ├── CharacterController/
    │   ├── Scripts/
    │   ├── Scenes/
    │   └── ...
    └── Shared/
        ├── Configuration/
        ├── Utilities/
        └── ...



Step 5: Configure Unity Settings

Input System Configuration

Go to File > Build Settings > Player Settings

In Player settings, find "Active Input Handling"

Set to "Both" (Input Manager + Input System)
Click "Apply"



Graphics Settings

Go to Edit > Project Settings > Graphics

Ensure "Scriptable Render Pipeline Settings" is set to URP
If not, assign your URP asset


Physics Settings

Go to Edit > Project Settings > Physics

Set "Default Material" if needed
Configure "Gravity" (default: -9.81)


Step 6: Configure Input Actions

Set Project-Wide Actions

Go to File > Build Settings > Player Settings

In Input System Package section, find "Project-Wide Actions"

Click the dropdown and select "InputSystem_Actions"

This should be located at:
Assets/FastSkillTeam/UltraGameCore/CharacterController/InputSystem_Actions



Verify Input Actions

Navigate to the InputSystem_Actions asset
Double-click to open the Input Actions editor
Verify the following actions exist:


Move (Vector2)

Look (Vector2)

Jump (Button)

Crouch (Button)

Fire (Button)




Step 7: Test Installation

Open Demo Scene

Navigate to Assets/FastSkillTeam/UltraGameCore/Scenes/

Open "Online Staging (BASE ONLY).unity"

Wait for the scene to load


Verify Scene Setup
The scene should contain:


NetworkManager object

GameManager script

Player prefabs in the scene

UI Canvas with network buttons


Test in Editor

Click Play button
Click "Host" button in the game view
You should see "Mode: Host" and be able to move around


Troubleshooting

Common Issues

Import Errors


Solution: Ensure all required packages are installed first

Solution: Try importing packages one by one


Input Not Working


Solution: Verify Input System is set to "Both"

Solution: Check Project-Wide Actions is set correctly

Solution: Restart Unity after configuration changes


Network Connection Issues


Solution: Ensure Netcode for GameObjects is properly installed

Solution: Check that NetworkManager exists in the scene

Solution: Verify firewall settings


Build Errors


Solution: Ensure all required packages are included in build

Solution: Check that the scene is added to Build Settings

Solution: Try building for a different platform


Getting Help
If you encounter issues:

Check the Troubleshooting Guide

Visit our Discord Community

Search the API Reference for technical details


Next Steps
Once installation is complete:


Project Configuration - Advanced settings

First Multiplayer Test - Test multiplayer functionality

Core Systems - Learn about character controller features


Installation complete! You're ready to start building with UltraGameCore!