> For the complete documentation index, see [llms.txt](https://gamelauncher.gitbook.io/documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gamelauncher.gitbook.io/documentation/getting-started/installation.md).

# Installation

{% hint style="warning" %}

### Requirements

* [**Visual Studio Community**](https://visualstudio.microsoft.com/es/downloads/) **(2026)**

### Install required Visual Studio 2026 Components

**`Enable`` `***<mark style="color:orange;">**`.NET Desktop Development`**</mark>*

![](/files/M6XO99tOgo5Y7bexd1Jf)

**Add these Visual Studio Individual components:**

`.NET 8.0 Runtime`

`.NET 10.0 Runtime`

`.NET Core Runtime 3.1`

`.NET Framework 4.8 SDK`

`.NET Framework 4.8 Targeting Pack`

![](/files/3yFKiOfgE7P5Psi38UBi)
{% endhint %}

## Need assistance? Join our [Discord](https://discord.gg/rJq6cEresy) or contact to <carlosarturors@gmail.com>

## Installation

{% hint style="success" %}
Game Launcher is a standalone application. It works separated from Unity.
{% endhint %}

Select where you downloaded the Launcher:

{% tabs %}
{% tab title="From Asset Store" %} <mark style="color:yellow;">Request the Github Repository access by joining</mark> [Discord](https://discord.gg/rJq6cEresy)<mark style="color:yellow;">.</mark>\
\
Follow these steps if you own **Game Launche**r from **Unity Asset Store**

1. Create a new empty project
2. Download and Import ***Game Launcher Unity Package*** in Unity
3. Locate the *<mark style="color:red;">**GameLauncher.zip**</mark>* in ***GameLauncher/Installation*** in the Unity Package\
   (The zip name varies by the version)

![](/files/WyJyh8Y5oEirz5X72jek)

4. Move and Decompress *<mark style="color:red;">**zip**</mark>* **OUTSIDE THE UNITY PROJECT FOLDER**

<figure><img src="/files/WxRaZmc6SKk5Ua4sOXh2" alt=""><figcaption><p>GameLauncher zip decompressed (PRO Version - Contains GameLauncherCore folder)</p></figcaption></figure>

5. **Game Launcher doesn't run in Unity.** You can safely remove the Unity package from Game Launcher, as it is no longer in use.
   {% endtab %}

{% tab title="From Github Repository" %}

1. **Download the lastest&#x20;*****Source code zip*****&#x20;from the Github Repository**\
   Link: <https://github.com/GameLauncherUnity/GameLauncher-PRO/releases>\
   \
   (Example)\
   ![](/files/k4xLvIuDiV8hemcO7hwJ)\
   \
   2\. **Decompress** the zip in your preferred directory.\
   \
   **Recommendation of root directory name:**\
   \- Directory name: *<mark style="color:yellow;">**GameLauncherContent**</mark>*\
   \- Also create a *<mark style="color:yellow;">**Manager**</mark>* folder here too to place the [Patch Manager App](/documentation/game-launcher/patch-manager-app.md)\
   ![](/files/IyiTZAlxbyblJwAbQKNN)&#x20;
   {% endtab %}
   {% endtabs %}

2. Open *<mark style="color:purple;">**GameLauncher.sln**</mark>* in Visual Studio

<figure><img src="/files/JasFVcTCIj4ffWXNp50R" alt=""><figcaption></figcaption></figure>

2. Right Click in *<mark style="color:purple;">**GameLauncher**</mark>* solution -> Click on ***Rebuild Solution***

![](/files/T4AjgMdWklAZrz4WapHG)

3. Open *<mark style="color:green;">**MainWindow\.xaml**</mark>* and *<mark style="color:green;">**MainWindow\.xaml.cs**</mark>* files

![](/files/wWZZhb7oZd3b7yHKp8Qk)

![](/files/iMcbzqI0SeLUf5NKmFMI)

> **At this point you will see the brand new Game Launcher UI!**

<figure><img src="/files/HHp7QhGosjyZpzVBIlUb" alt=""><figcaption><p>Game Launcher Project in Visual Studio</p></figcaption></figure>

> Now continue creating the Self Patcher...

#### ll. Building the Self Patcher

The <mark style="color:orange;">SelfPatcher</mark> is the program that updates the **Launcher.**\
If it's not set, the Launcher will not be able to update itself.

1. **Switch** the **Visual Studio Environment** to ***Release***

<figure><img src="/files/3uzZF4yHml48EEYlfuZz" alt=""><figcaption><p>Switching Visual Studio Environment</p></figcaption></figure>

2. Right click in **SelfPatcherWinForms** -> **Build**

![](/files/gVF9LJaLnmax3oQQF7Ou)

3. Again, **Right Click** on **SelfPatcherWinForms** -> **Open Folder in File Explorer** and Navigate to *<mark style="color:yellow;">**.../Build/Release**</mark>* folder and Copy the <mark style="color:red;">**SelfPatcher.exe**</mark> and <mark style="color:red;">**SelfPatcherCore.dll**</mark>
4. Open the [**Patch Manager**](/documentation/game-launcher/patch-manager-app.md)**:**

{% tabs %}
{% tab title="Patch Manager (New)" %}
Download [Patch Manager App](/documentation/game-launcher/patch-manager-app.md)\
The Manager requires the [**GameLauncherCore.dll**](#user-content-fn-1)[^1] to work. Let's create the DLL.

1. In Visual Studio, right click on the **GameLauncherCore** project -> **Build**
2. Again, right click on the **GameLauncherCore** project -> **Open Folder in File Explorer** and Navigate to *<mark style="color:yellow;">**.../Build/Release**</mark>* folder&#x20;
3. **Copy** the <mark style="color:red;">**GameLauncherCore.dll**</mark> in the same folder as the <mark style="color:red;">**PatchManager.exe**</mark>

**It must look like this**\
\
![](/files/rpNNxLMCyAq8QXnLlzbg)

After this, **Open** the <mark style="color:red;">**PatchManager.exe**</mark>
{% endtab %}

{% tab title="Unity Manager (Deprecated)" %}

<figure><img src="/files/ry0sjlT5tiokFsKF7RlH" alt=""><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

5\. In the **Patch Manager -> Make sure to be in** [*<mark style="color:purple;">**Launcher Workspace**</mark>*](#user-content-fn-2)[^2]\
-> **Open Self Patcher Folder** -> **Paste here the files&#x20;**<mark style="color:red;">**SelfPatcher.exe**</mark> and <mark style="color:red;">**SelfPatcherCore.dll**</mark>

<figure><img src="/files/nT1uuAXO9BsgkOzQngpH" alt=""><figcaption></figcaption></figure>

lll. Upload the content of *<mark style="color:yellow;">**"Upload my content"**</mark>* folder to your [**Host**](#user-content-fn-3)[^3]

{% hint style="success" %}
N**eed a** [**Host**](#user-content-fn-3)[^3]**?**\
We recommend **Hostinger as Host provider**

**Use this code to get a discount**

<https://hostinger.com/?REFERRALCODE=GAMELAUNCHER>
{% endhint %}

{% tabs %}
{% tab title="Setup your host" %}

1. Create a folder called *<mark style="color:yellow;">**GameLauncher**</mark>* inside your *<mark style="color:yellow;">**public\_html**</mark>* folder in Host (this will be your Host URL)
2. Upload the content of *<mark style="color:yellow;">**Upload my content**</mark>* folder to *<mark style="color:yellow;">**GameLauncher**</mark>* folder

> The *<mark style="color:yellow;">**Upload my content**</mark>* folder is located in the [*<mark style="color:red;">**GameLauncher.zip**</mark>*](#user-content-fn-4)[^4] content

*To upload your files use a File Manager like* [*WinSCP*](https://winscp.net/eng/download.php)

3\. In Visual Studio in **GameLauncher** project locate -> *<mark style="color:green;">**Models/Patcher/LauncherConfig.cs**</mark>*

And place your **HOST URL in the** HOST\_URL variable

{% hint style="info" %}
Example:

<https://game-launcher.net/GameLauncher/>
{% endhint %}

<figure><img src="/files/OU4X0xxXmbWvWmZH2Si9" alt=""><figcaption><p>Placing the HOST URL in LauncherConfig.cs</p></figcaption></figure>

4. Also, place the **HOST URL** in the **Patch Manager**

   <figure><img src="/files/xisT72rYBg9HDjXABClx" alt=""><figcaption><p>HOST URL in the Patch Manager</p></figcaption></figure>

<br>

4. Set your custom MAINAPP\_EXECUTABLE name

**This will be the app that will be executed by the Launcher**

<figure><img src="/files/XGEoDjT2CaYV3NXk70Lg" alt=""><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

### **Installation finished!**

[\[TIP\] Make your host files visible](/documentation/getting-started/installation/tip-make-your-host-files-visible.md)

### **Next steps**

**Proceed creating your Launcher!**

[Deploy your Launcher](/documentation/creating-launcher-version/1.-deploy-your-launcher.md)

[^1]: Core Library to create the patches. You can create this .dll in Visual Studio.

[^2]: The Patch Manager works with two workspaces:\
    \
    (Purple) Launcher Workspace: For Launcher patches\
    (Cyan) App Workspace: For App/Game patches\
    \
    Switch between environments by using the Switch to App/Launcher button

[^3]: A file host, also known as a cloud-storage service, online file-storage provider, or cyberlocker, is a service that hosts user files on the internet

[^4]: The folder that you downloaded from Unity or from the Github Repository.
