# Reality Loader

Reality Loader is an agent for Reality Hub where you enable communication between Reality Hub and your Engine(s). 

{% hint style="warning" %}
Reality Loader must be installed on every Reality Engine & Unreal Engine Vanilla.
{% endhint %}

{% hint style="warning" %}
[Upgrading or downgrading Reality Hub](https://zerodensitydocumentation.gitbook.io/docs/reality-5.3-sp3/reality-5.3-sp3/installations/installations/installing-reality-hub/upgrading-and-downgrading) requires you to do the same with Reality Loader, you must keep Reality Hub and Reality Loader versions identical.
{% endhint %}

### Downloading <a href="#realityloader-downloading" id="realityloader-downloading"></a>

Reality Hub UI should be open to download Reality Loader. To initiate the process:

<div align="left"><figure><img src="https://content.gitbook.com/content/bn9QNJikRLdiYumFEboj/blobs/CZlDz365zaBebN63shhb/image.png" alt=""><figcaption><p>Reality Hub Login Screen</p></figcaption></figure></div>

* Login to Reality Hub
* Open the **Main Menu** and select **Configuration**
* Go to **General** > **Configuration** on the left panel.

<div align="left"><figure><img src="https://content.gitbook.com/content/bn9QNJikRLdiYumFEboj/blobs/EGFWFgOchxZair5OxuLA/image.png" alt=""><figcaption><p>Maintenance</p></figcaption></figure></div>

* Under the **Maintenance** section, click the **Download** link next to **Reality Loader**, as illustrated above.

{% hint style="info" %}
**80** is the default port used by the Reality Hub Server. If you change the **default port** during the installation, your login address should be `http://<Reality Hub Server IP Address>:<Reality Hub Server Port>`
{% endhint %}

### Installation <a href="#realityloader-installation" id="realityloader-installation"></a>

After downloading Reality Loader, start the installation by launching the setup file.

<div align="left"><figure><img src="https://content.gitbook.com/content/bn9QNJikRLdiYumFEboj/blobs/hORmwPjrLNKprmnQO2f9/image.png" alt=""><figcaption><p>Installation Folder</p></figcaption></figure></div>

* Click **Next** after accepting the terms and conditions.

<div align="left"><figure><img src="https://content.gitbook.com/content/bn9QNJikRLdiYumFEboj/blobs/2pSRHuxVPSJJzMyQoxbL/image.png" alt=""><figcaption><p>Installation Path</p></figcaption></figure></div>

* Choose the installation destination and click **Next.**

<div align="left"><figure><img src="https://content.gitbook.com/content/bn9QNJikRLdiYumFEboj/blobs/BFewtrDRQmfZ3PrvtV9i/image.png" alt=""><figcaption><p>Reality Hub URL</p></figcaption></figure></div>

* Specify a Reality Hub URL and logging target or accept the default settings and click **Install.**

{% hint style="info" %}
**Reality Hub URL**: HTTP IP Address and Port for communication with Reality Hub Server. This IP must be the same as the computer that you installed Reality Hub Server.
{% endhint %}

{% hint style="info" %}
Let's assume that your Reality Hub Server is located on a server configuration with the IP number 192.168. 0.1, your Engine's IP Address is 192.168. 0.2, and Reality Hub client is located on 192.168. 0.3.

In such a scenario, your Reality Hub Client will be controlling the Engine host by connecting to the Reality Hub Server, therefore, your **Reality Hub URL** must be looking at the Reality Hub Server, in other word it is 192.168. 0.1.
{% endhint %}

* **Logging IP**: Multicast address to broadcast logs.
* **Logging Port**: This is the Port you can set for broadcast logs.

{% hint style="info" %}
Please keep that in mind; the **6001** is the **fixed port** for the **Reality Hub Server and the Reality Loader communication**.
{% endhint %}

<div align="left"><figure><img src="https://content.gitbook.com/content/bn9QNJikRLdiYumFEboj/blobs/2GIcaotQoZz1vRSNfpf4/image.png" alt=""><figcaption><p>Installation</p></figcaption></figure></div>

* Click **Finish** to complete the installation and make sure that the **Launch Reality Loader** checkbox is selected.

![Reality Loader Command Panel](https://content.gitbook.com/content/bn9QNJikRLdiYumFEboj/blobs/Zvc0VkKCLWI2Qb93nbaE/image.png)

The **Reality Loader Command Panel** will appear when your installation is successful, as shown in the image above.

{% hint style="warning" %}
Keeping **the Reality Loader window open** (it can be minimized) is **indispensable** for enabling communication between the Reality Hub Server and the Engine(s).
{% endhint %}

<div align="left"><figure><img src="https://content.gitbook.com/content/bn9QNJikRLdiYumFEboj/blobs/uUGN4mWB3bjWctKBU1Ho/image.png" alt=""><figcaption><p>Connected Loaders Window</p></figcaption></figure></div>

When you click on the Reality Hub version number, **Connected Loaders** are listed in the popup menu, shown in the image above.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://zerodensitydocumentation.gitbook.io/docs/reality-5.3-sp3/reality-5.3-sp3/configurations/configuring-reality-hub/reality-loader.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.