> For the complete documentation index, see [llms.txt](https://kb.criticalscripts.shop/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://kb.criticalscripts.shop/paid-resources/fivem-hall/installation-instructions.md).

# Installation Instructions

{% stepper %}
{% step %}

### Download the resource

Download `cs-hall` from your keymaster and place it in your `resources` folder.
{% endstep %}

{% step %}

### [Install `cs-stream`](#user-content-fn-1)[^1]

Download `cs-stream` from: <https://github.com/criticalscripts-shop/cs-stream>

Place it in your `resources` folder and add the following to your server configuration file:

{% code title="server.cfg" %}

```txt
ensure cs-stream
```

{% endcode %}

{% hint style="warning" %}
If you choose not to use it you will have to change the default configuration as the default spotlight object is an addon and the default screen for some locations is from **The Cayo Perico Heist** DLC which your server may not be on.
{% endhint %}
{% endstep %}

{% step %}

### Ensure the resource

Add the following to your server configuration file:

{% code title="server.cfg" %}

```txt
ensure cs-hall
```

{% endcode %}
{% endstep %}

{% step %}

### Setup Ace permission

Add this to your server configuration so Ace admins can access the `/hall` command:

{% code title="server.cfg" %}

```txt
add_ace group.admin cs-hall.control allow
```

{% endcode %}

{% hint style="info" %}
This check can be changed by modifying **`cs-hall/lntegration/server.lua`**.
{% endhint %}

Alternatively, read more about permissions [here](/paid-resources/fivem-hall/permissions.md).
{% endstep %}

{% step %}

### Configure locations

Open `config.lua` inside `cs-hall` and enable the entries for the locations you want the hall to be available.&#x20;

{% hint style="info" %}
You can find more locations in our [`extra-hac` GitHub](https://github.com/criticalscripts-shop/extra-hac/tree/main/cs-hall/entries) and in our [Discord](https://criticalscripts.shop/discord) community.
{% endhint %}
{% endstep %}

{% step %}

### Start the resource

Run the following commands on the server console:

{% code title="FiveM Server Console" %}

```txt
refresh
ensure cs-hall
```

{% endcode %}
{% endstep %}
{% endstepper %}

[^1]: This step is optional but recommended.
