# Intro

Looking to push your players' realistic experience? \
Give them a vehicle entertainment system!

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

#### About CS-VES

**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 ***/ves*** command while inside an enabled vehicle model for players with Ace permission "***cs-ves.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-ves/integration)**.**

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

* [**Festival Bus**](https://www.gtabase.com/grand-theft-auto-v/vehicles/festival-bus)**\***
* [**Declasse Moonbeam Custom**](https://www.gtabase.com/grand-theft-auto-v/vehicles/declasse-moonbeam-custom)
* [**Obey 9F**](https://www.gtabase.com/grand-theft-auto-v/vehicles/obey-9f)
* [**Sultan**](https://www.gtabase.com/grand-theft-auto-v/vehicles/karin-sultan)
* [**BMW X6M F16 Breitbau**](https://www.gta5-mods.com/vehicles/bmw-x6m-f16-rmod-customs)
* [**2015 Honda Civic Type R (FK2)**](https://www.gta5-mods.com/vehicles/2015-honda-civic-type-r-fk2-add-on-rhd)

There is also a catch-all configuration option that allows you to effectively put the system in every vehicle with ease, however while this is heavily optimized it still has a bigger performance impact compared to introducing ***cs-ves*** in a more unique one-to-one basis which is recommended. **This resource was not made to be a public car radio resource** for all of your players, but rather **something that shall be provided exclusively** to people you trust, content creators, staff members and so on.

**Make sure to** [**join our Discord**](https://criticalscripts.shop/discord) where people may choose to **share their configurations** for **other vehicle models** 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-ves/entries)**.**

**\*** The Festival Bus configuration uses screens from **The Cayo Perico Heist** DLC.\
If your server is on an earlier game build and screens do not spawn for you, [***download cs-stream***](https://github.com/criticalscripts-shop/cs-stream), put it in your resources and **ensure** it.

#### FEATURES

* **YouTube** (live or video) and **Twitch** (live, video or clip) supported.
* Player position and camera-based 3D audio.
* Static monitors to create more realistic setups.
* Replacers to actually see what’s playing.
* Minimal UI for full and easy control of what’s happening alongside a queue system.
* Realistic dynamic gain and low-pass filter.
* Unlimited number of vehicle models 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/cs-ves/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.
