# Intro

Looking to push your players' realistic audiovisual experience?\
Give them nightclubs, theaters, cinemas and more to enjoy!

{% embed url="<https://www.youtube.com/watch?v=eZtYWaDabuY>" %}
Promotional Video
{% endembed %}

#### About CS-HALL

**The resource is using** [**Asset Escrow**](https://forum.cfx.re/t/introducing-asset-escrow-for-your-resources/4777151) **system.**\
**Your server needs to be in an artifacts version that supports it.**

The resource comes with an **extensive configuration**, events, exports and **some client / server source files** to allow you to customize it to your liking.

It is a **standalone resource** and **works with any framework**. The UI is accessed via the ***/hall*** command while inside an enabled hall location for players with Ace permission "***cs-hall.control***". This check and how the UI is accessed can be changed by modifying ***integration/client.lua*** and ***integration/server.lua*** files. There is also an identifier-based check in parallel to Ace permission which can also be edited in ***integration/server.lua*** file to add any player identifiers you want. **You may also find some ready-to-use framework-related integrations** [**here**](https://github.com/criticalscripts-shop/extra-hac/tree/main/cs-hall/integration)**.**

Out of the box we provide you with configuration for the following locations (some of them are disabled by default, you can enable them in the configuration file).

* **Vanilla Unicorn**
* **Beach Party**
* [**Gabz's Vanilla Unicorn**](https://www.youtube.com/watch?v=o9UV9tdLU30)
* [**Breze's Medusa Nightclub**](https://www.youtube.com/watch?v=WkSDHNS9UDY)
* [**UncleJust's Vinewood Nightclub**](https://www.youtube.com/watch?v=bwcH_KODvPI)
* [**UncleJust's Vinewood Cinema**](https://www.youtube.com/watch?v=ozpJeC7wv7k)

**Make sure to** [**join our Discord**](https://criticalscripts.shop/discord) where people may choose to **share their configurations** for **other locations** or even share your own if you create one!\
**You may also find some more public configurations** [**here**](https://github.com/criticalscripts-shop/extra-hac/tree/main/cs-hall/entries)**.**

#### FEATURES

* **YouTube** (live or video) and **Twitch** (live, video or clip) supported.
* Player position and camera-based 3D audio.
* Lights for five frequency groups, synced with whatever is playing.
* Static monitors and moving screens to create more realistic setups.
* Replacers to actually see what’s playing.
* Colored sparklers and smoke machines with bass triggers.
* Dynamic video-based colors for a seamless lights & effects experience.
* Scenes support, a programmable interface to create interactive experiences.
* Minimal UI for full and easy control of what’s happening alongside a queue system with server persistence per each configured location.
* Realistic dynamic gain, low-pass filter, polygon mapping and virtual remote control for key bindings and media keys with default animations.
* Unlimited number of places with their own setup given you can create them.
* Range synchronization and considerate optimization for a good balance between performance and features.
* Real-time state synchronization between players for both UI and currently playing media.
* A wide array of events and exports to check and control the resource.
* Extensive configuration to change almost all aspects of the resource to your liking.
* Lua-based integration for permissions and access control to limit usage of the resource to whoever you like (job-based, permission-based and so on).


---

# 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://fivem-docs.gitbook.io/critical-scripts/intro.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.