# 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.


---

# 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://kb.criticalscripts.shop/paid-resources/fivem-hall/installation-instructions.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.