# Music System

`Music System` is a FiveM in-game music player that allows players to play YouTube and SoundCloud tracks through vehicle radios, boombox props, and character-based music sources.

It is designed to provide a complete in-game music experience with playlists, profile pages, ranking, history, likes, search, and a floating overlay player. Audio playback is handled through positional sounds, making music feel natural in the world depending on where the source is located.

With support for vehicles, boomboxes, player radios, playlists, social profiles, and track ranking, the system is modern, immersive, and suitable for advanced roleplay servers.

### Features

* Vehicle radio support
* Boombox support
* Character and DJ music playback
* YouTube and SoundCloud support
* Playlist system
* Music ranking
* Player profiles and likes
* Playback history
* Overlay mini-player
* Positional music playback through `msk_sounds`
* Token-protected server actions

### How it works

Players can open the music panel in supported contexts such as vehicles, boomboxes, or character radios.

From there, they can paste a direct music link, search supported platforms, create playlists, manage their profile, and control playback. When music is played, the system creates a positional sound source and synchronizes it to all players.

Depending on the source type, the music is attached to a vehicle, a boombox prop, or a character position.

### Included Pages

* Installation
* Configuration

### Requirements

Before using this resource, make sure all required dependencies are installed and started correctly.

### Notes

* Music playback supports multiple source types
* Audio playback is delegated to `msk_sounds`
* Playlist and profile data are stored in the database
* Sensitive playback actions are protected with token validation
* Both public and personal music features are included


---

# 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://mskscripts.gitbook.io/mskscripts/scripts/music-system.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.
