# Музика по поръчка от MVP Music

**Играчите ти сами избират своя химн за MVP. Целият сървър го чува. Изборът остава завинаги в паметта.**

Кръгът приключва, появява се панелът за MVP – и вместо същия стандартен звуков ефект за хиляден път
В този момент сървърът възпроизвежда песента, която играчът е избрал. Музиката на MVP в самата игра се изключва за това
кръг, така че нищо да не се чува отгоре му. В чата се съобщава кой е спечелил титлата „MVP“, коя песен се възпроизвежда и как
Този играч е бил MVP много пъти.

Играчите правят избор с `!mvp`. Изборът им се съхранява в MySQL, така че се запазва при промени в картата, при повторно свързване и
презареждане на сървъра.

---

## Преди да купите – прочетете тази част

**Песните са от добавка в Steam Workshop, която сами създавате и публикувате.** Този плъгин
не изпраща музика и не може самостоятелно да добавя музика към сървър – CS2 възпроизвежда само аудио, което е
вече инсталиран на клиентския компютър.

На практика това означава: поставяте `.mp3`файловете си в добавката „CS2 Workshop Tools“, компилирате я,
публикувайте го в „Workshop“ и оставете MultiAddonManager да го предостави на играчите, когато се свържат. Това
включва подробни инструкции за работа стъпка по стъпка, с работещ пример`.vsndevts`, и това е
еднократна задача – след това добавяте песни чрез редактиране на един конфигурационен файл.

Ако вече използвате добавка за работилница на сървъра си, сте почти готови. Ако имате
Ако никога не сте отваряли „Workshop Tools“, предвидете едно следобед за първото разширение.

Всичко останало – менюто, правата за достъп, базата данни, съобщенията – се управлява автоматично за вас.

---

## Какво прави

**Всеки играч избира своя химн.** Менюто е създадено с MenuManager, така че наследява всички характеристики на менюто
стил, който сървърът ви вече използва. По един избор на играч, съхраняван по SteamID.

**Категории със собствени права за достъп.** Групиране на песните в подменюта – Хип-хоп, Чалга, Премиум,
каквото искаш. Постави маркер върху дадена категория и всяка песен в нея ще бъде обвързана с този маркер. Страхотно!
за зони, предназначени само за VIP гости.

**Случайно възпроизвеждане.** Играчът може да избере „случайна песен“ вместо конкретна, като изборът може да бъде от целия списък или
от една и съща категория. Всеки път, когато станат MVP, им се избира различен химн.

**Безплатен план за потребители, които не са VIP.** Нека всеки да може да ползва първите N песни и да отключи пълния списък за
знаме по ваш избор. Една настройка, не се изисква отделен VIP плъгин – всеки плъгин, който предоставя
CounterStrikeSharp поддържа флагове, включително SimpleAdmin `admins.json`и всички разпространени VIP плъгини.

**Играчите, които не искат да чуват музиката на другите, могат да я изключат.** За всеки играч, запазено в
база данни. Техният химн все още звучи.

**Съобщения, които имат значение.** В чат-линията се показва името на изпълнителя, песента и
брояч – „Илюзията е MVP за 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*