> For the complete documentation index, see [llms.txt](https://docs.vanillasquad.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.vanillasquad.com/igrovoi-kontent/vklyuchenie-svoei-muzyki.md).

# Включение своей музыки

{% hint style="success" %}
Для доступа к функционалу требуется подписка [Union](https://chatgpt.com/podderzhka-servera/podpiska-union-i-union+.md). Рекомендуется ознакомиться с её условиями.
{% endhint %}

***

### Команды

#### Создание кастомной пластинки

* **Команда**: `/disc burn <url> [name]`
* **Описание**: создаёт музыкальную пластинку с кастомным аудио по указанной ссылке. Для использования команды нужно держать музыкальную пластинку в руке.
* **Пример**:
  * `/disc burn <ссылка на трек> MyMusic`

После выполнения команды пластинка получит указанное название и будет проигрывать музыку по добавленной ссылке.

***

#### Возврат пластинки в обычное состояние

* **Команда**: `/disc erase`
* **Описание**: возвращает кастомную пластинку в обычное состояние.
* **Пример**:
  * Возьмите кастомную пластинку в руку и используйте команду `/disc erase`.

***

#### Поиск треков

Вы можете искать музыку прямо в игре через поддерживаемые источники.

**Поиск во ВК Музыке**

* **Команда**: `/disc search vk <запрос>`
* **Описание**: ищет трек во ВК Музыке по указанному названию.
* **Пример**:
  * `/disc search vk Never Gonna Give You Up`

**Поиск в Яндекс Музыке**

* **Команда**: `/disc search yandex <запрос>`
* **Описание**: ищет трек в Яндекс Музыке по указанному названию.
* **Пример**:
  * `/disc search yandex Never Gonna Give You Up`

***

### Поддерживаемые источники

Аддон может загружать аудио из следующих источников:

* ВК Музыка
* Яндекс Музыка
* SoundCloud
* Bandcamp
* Vimeo
* Twitch live streams
* Direct HTTP URLs

{% hint style="danger" %}
YouTube больше не поддерживается. Он был убран из-за нестабильной работы: треки могли не запускаться, ломаться или требовать постоянных исправлений.
{% endhint %}

***

### Поддерживаемые форматы файлов

Если вы используете прямую ссылку на аудиофайл, поддерживаются следующие форматы:

* MP3
* FLAC
* WAV
* Matroska/WebM с кодеками AAC, Opus или Vorbis
* MP4/M4A с кодеком AAC
* OGG-потоки с кодеками Opus, Vorbis или FLAC
* AAC-потоки
* Плейлисты потоков M3U и PLS
