Package Description

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

You can check out a promotional video here.


The resource is using Asset Escrow 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.

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

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

* 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, 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).
  • Out-of-the-box support for player buckets.

Installation Instructions

  1. Download cs-ves and place it in your resources folder.
  2. Add ensure cs-ves to your server's configuration file.
  3. Add add_ace group.admin cs-ves.control allow to your server's configuration file so Ace admins can access /ves command. This check can be changed by modifying integration/server.lua file.
  4. Check the config.lua file inside cs-ves for further configuration and enable the vehicle models you want to be available.
  5. Run the command refresh followed by the command ensure cs-ves.

Important Information

  • The resource is optimized with range synchronization and assets are loaded only when the player is around an active vehicle.
  • Very low-spec computers may experience a more downgraded experience.
  • If you want to ensure the resource, you are advised to stop the playback in all active vehicles first to avoid crashes.
  • Colliding replacers will prioritize the ones that are closer to the player and may also replace objects nearby if they happen to have the same texture, this is not something that can be changed and you can avoid it by not having the same vehicles in the same area and use vehicle-specific texture replacements instead of generic objects.
  • The resource works by using a vehicle's plate as an identifier. When two or more vehicles have the same plates, only one of them will work. This is true even for vehicles that are on different buckets.
  • In the default configured entries, adjusting the content time for buffering and syncing is turned off as it is not mandatory for a great experience. This feature is complicated and may not always work as intended, therefore it is advised to enable it only in time-critical content.
  • Some triangle / black textures may appear in monitors when there are a lot of players around, that seems to be a game texture bug.
  • Minor crackling may be audible on certain songs when the camera is moved due to limitations imposed upon spatial audio.
  • Only YouTube and Twitch content is allowed at this time.
  • Captions and advertisements may appear when playing YouTube videos.
  • Twitch may throw alerts in live streams about third-party viewing experience and sync may not be optimal. Mature content warning and audio muted warning will be clicked away automatically.
  • The resource is loading content in every client by using APIs, embeds and inline frames therefore, does not directly violate any copyright laws.
  • If content fails to load or play for any reason for the player who is controlling the UI, it will stop for everyone. If content fails to load or play for any reason for a player who is only viewing / listening, it may attempt to reload for them.
  • There are checks in place in an attempt to verify that the transmitted data (titles, thumbnail URL, icon, etc.) are legitimate and are coming from the within resource itself, however since the client sends it, they cannot be fully trusted.