# Музыка MVP на заказ

**Ваши игроки сами выбирают гимн для MVP. Его слышат все пользователи сервера. Этот выбор останется в памяти навсегда.**

Раунд заканчивается, на экране появляется панель с результатами MVP — и вместо того, чтобы в тысячный раз показывать одну и ту же стандартную заставку
В этот момент сервер воспроизводит песню, выбранную игроком. Собственная музыка MVP в игре на это время приглушается
раунд, чтобы ничего не перебивало его. В чате сообщается, кто стал MVP, какая песня звучит и как
Этот игрок не раз становился MVP.

Игроки выбирают с помощью `!mvp`. Их выбор сохраняется в MySQL, поэтому он сохраняется даже при изменении карты, переподключении и
перезапуск сервера.

---

## Прежде чем купить — прочтите этот раздел

**Песни взяты из дополнения для Steam Workshop, которое вы создаете и публикуете самостоятельно.** Этот плагин
не передаёт музыку и не может самостоятельно добавлять музыку на сервер — CS2 воспроизводит только аудиофайлы, которые
уже установлен на клиентском компьютере.

На практике это означает: вы помещаете свои файлы`.mp3` в дополнение CS2 Workshop Tools, компилируете его,
опубликуйте его в «Workshop», и пусть MultiAddonManager предоставит его игрокам при подключении. Это
включает пошаговые инструкции с рабочим примером`.vsndevts`, и это —
Одноразовая настройка — после этого песни можно добавлять, редактируя один конфигурационный файл.

Если на вашем сервере уже установлено дополнение «Мастерская», то вы уже почти достигли цели. Если у вас
Если вы ещё ни разу не открывали «Инструменты мастерской», запланируйте на установку первого дополнения целый день.

Обо всём остальном — меню, правах доступа, базе данных, объявлениях — позаботятся за вас.

---

## Для чего это нужно

**Каждый игрок выбирает свой гимн.** Это меню создано на основе MenuManager, поэтому оно наследует все свойства меню
стиль, который уже используется на вашем сервере. По одному выбору на игрока, сохраняемому по SteamID.

**Категории с собственными правами доступа.** Сгруппируйте песни в подменю — хип-хоп, чалга, премиум,
что угодно. Пометьте категорию флажком — и все песни в ней будут привязаны к этому флажку. Здорово!
для зон, предназначенных исключительно для VIP-гостей.

**Случайный выбор.** Игрок может выбрать «случайную песню» вместо конкретной — либо из всего списка, либо
из одной категории. Каждый раз, когда они становятся MVP, звучит новый гимн.

**Бесплатный тариф для пользователей, не являющихся VIP-пользователями.** Дайте всем возможность прослушивать первые N песен и разблокировать полный список за
флаг по вашему выбору. Один параметр, отдельный VIP-плагин не требуется — любой плагин, который предоставляет
Поддерживаются флаги CounterStrikeSharp, в `admins.json`том числе SimpleAdmin и все распространенные VIP-плагины.

**Игроки, которые не хотят слышать музыку других игроков**, **могут отключить её. Настройки** сохраняются для каждого игрока в файле
база данных. Их гимн по-прежнему звучит.

**Объявления, которые имеют значение.** В строке чата отображаются имя игрока, название песни и
счетчик — «Иллюзия» в 23-й раз признана самым ценным игроком. Полностью перезаписываемый, с цветными фишками, и он
также может мигать в центре экрана.

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

**Музыкальные наборы тоже отключаются. И** не только стандартный гимн — если у MVP есть свой музыкальный набор, то именно он
также будет отключена, поэтому будет воспроизводиться только ваша песня.

**Каждая строка принадлежит вам.** Названия пунктов меню, ответы в чате, объявления, префикс — всё это в
config, все с использованием цветовых маркеров. Ничто не записано напрямую на английском языке.

---

## Создан, чтобы выдержать работу на рабочем сервере

Вот те вещи, которые замечаешь только тогда, когда их нет:

- **Сбой базы данных не приводит к сбою работы плагина.** Выбранные элементы продолжают работать в памяти в течение
сессии каждый вызов повторяется самостоятельно, и система восстанавливается без перезагрузки. Ошибки регистрируются в
не чаще, чем раз в минуту, чтобы не заваливать консоль сообщениями.
- **Сообщения никогда не блокируют игровую ветку.** Они проходят через упорядоченную фоновую очередь, поэтому два быстрых
Хватки одного и того же игрока никогда не могут выполняться в неправильном порядке, и в конце раунда не возникает никаких заминок.
- **Права доступа проверяются заново, а не считаются достоверными один раз и навсегда.** По истечении срока действия VIP-статуса игрок возвращается к
музыка по умолчанию, и ему объясняют, почему — а ведь плагины администрирования, опирающиеся на базу данных, дают возможность на мгновение активировать флаги
После подключения выбор никогда не сбрасывается по ошибке в первые секунды сеанса.
- **В подходе MVP не используется хеширование и не происходит выделение памяти.** Состояние игрока индексируется по слоту.
- **Настройки перезагружаются в режиме реального времени.** Происходит `css_mvp_reload`повторное считывание списка песен и даже названий команд в чате.
без перезапуска сервера.
- **Боты, HLTV и игроки, у которых включена музыка по умолчанию, остаются в полном покое** — плагин их не затрагивает
в таком случае вообще не проводить это мероприятие.

---

## Требования

| | |
|---|---|
| CounterStrikeSharp | `1.0.368` или более поздней версии |
| [MenuManagerCS2](https://github.com/NickFox007/MenuManagerCS2) | для меню песен |
| [MultiAddonManager](https://github.com/Source2ZE/MultiAddonManager) | устанавливает ваше дополнение «Мастерская» на сервере и на клиентах |
| MySQL / MariaDB | сохраняет выбранные позиции |
| Дополнение для Steam Workshop с вашими песнями | см. раздел выше |

---

## Команды

| Команда | Кто |
|---|---|
| `!mvp` `/mvp` `!music` `/music` | players — открывает меню. Названия команд можно настраивать, а само меню можно заблокировать с помощью флага. |
| `css_mvp_test` | admin — выводит список песен или воспроизводит одну из них, чтобы вы могли проверить название звукового события |
| `css_mvp_stop` | admin — останавливает все еще выполняемый предварительный просмотр |
| `css_mvp_reload` | admin — перезагрузка конфигурации с диска |

---

## Что вы получите

- Скомпилированный плагин, готовый к установке в папку `addons/counterstrikesharp/plugins/`.
- Подробное руководство: подробное описание всех ключей конфигурации, пошаговая инструкция по сборке аддона «Workshop»
(включая практический пример`.vsndevts`) и таблицу по устранению неисправностей.
- Таблицы базы данных создаются автоматически при первом подключении. Импортировать SQL-запросы не требуется.

Исходный код не прилагается.

---

## По желанию: подключите его к веб-сайту

Плагин является самостоятельным продуктом. Если вы также используете отдельный **веб-сайт MVP Music**, укажите оба
в той же базе данных, и вашим игрокам открывается страница входа в Steam, где они могут просматривать песни и прослушивать их фрагменты
в браузере и выбрать там свой гимн — а также панель администратора для песен и категорий, с
история игр и таблицы лидеров. Изменения, внесенные в браузере, применяются в игре без необходимости повторного подключения, и
наоборот.

Продается отдельно. Плагин не требует от него ничего.

---

## Версия

**1.3.1** — текущая версия.

Недавние обновления: категории в виде подменю с собственными настройками случайного воспроизведения и правами доступа, настройки для каждого пользователя
отключение звука во время исполнения гимнов других игроков, ограничения бесплатного тарифа для не-VIP-пользователей, счетчики MVP в
объявление и дополнительная синхронизация с веб-сайтом.

---

## Лицензия и поддержка
- Запрещается распространять, перепродавать, передавать или публиковать эти файлы, как целиком, так и частично.
- Обновления для этой основной версии предоставляются бесплатно.
- Возврат средств не производится после передачи файлов — выше приведен полный перечень требований, поэтому
Перед покупкой убедитесь, что ваши технические характеристики соответствуют требованиям.

Приветствуются вопросы перед покупкой. Для получения поддержки после покупки свяжитесь со мной по **[ добавить Discord / профиль ]**
с выводом консоли вашего сервера.

---

*Музыка для MVP на заказ — автор: illusion @ CodeStrike*