# Custom MVP Music — Уебсайт

**Уебсайт за вход чрез Steam, където можете да слушате хитовете си от MVP. Играчите разглеждат песните и ги слушат в
браузъра и да изберат своя с едно кликване. Управлявате каталога от администраторския панел, вместо да редактирате
конфигурационен файл чрез FTP.**

Сайтът и плъгинът използват една и съща база данни MySQL, така че не е необходимо да се извършва ръчна синхронизация. Добавете
песента на уебсайта и тя се появява в менюто`!mvp` в играта за броени секунди. Играч, който избере
химнът на сайта ще се чуе, когато те станат MVP следващия път, без да се налага да се свързват отново — и избор, направен в
играта се появява веднага в профила им.

---

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

**Това е уебсайтът, съпътстващ плъгина „Custom MVP Music“, а не самостоятелен продукт.** Той
редактира базата данни на плъгина. Ако плъгинът не е инсталиран на вашия CS2 сървър, нищо няма да се възпроизвежда в играта.

Две практически изисквания:

- **Уебсайтът трябва да има достъп до MySQL базата данни на плъгина.** Ако сайтът и сървърът на играта се намират на
различни компютри — което е обичайният случай — трябва да разрешите на IP адреса на уеб хоста да се свърже (в cPanel
(т.е. *Remote MySQL*) или преместете базата данни в същата директория като сайта и настройте плъгина да я използва.
- **Ключ за Steam Web API**, предоставен безплатно от Steam, за имена и аватари на играчи.

Освен това работи на обикновен споделен хостинг. Няма етап на компилиране в Node, няма работник за опашката, няма
`storage:link`, и без cron задача — достатъчни са обикновени PHP 8.3 и MySQL. Ръководство за cPanel е
включено.

---

## Какво получават вашите играчи

**Каталог, който си заслужава да се разгледа.** Илюстрация на корицата, етикети за категории, бързо търсене и индикатор „N играчи използват това“
разчитайте на всяка песен, включена в избора в самата игра, а не само на тези от уебсайта.

**Предварително възпроизвеждане в браузъра.** Качете кратък откъс от всяка песен, за да могат слушателите да я чуят, преди да я изтеглят,
вместо да изберат име на сляпо и да чакат следващия кръг за MVP.

**С едно кликване можете да зададете своя химн** — конкретна песен, възпроизвеждане на случаен принцип на всички песни или възпроизвеждане на случаен принцип
в рамките на една категория. Същите три опции, които предлага менюто в играта.

**Хитовете на седмицата и предаване на живо.** Петте най-слушани песни от последните седем дни, както и последната
осем MVP-та в реално време. Това придава динамика на страницата и дискретно рекламира вашия сървър.

**Личен профил** (`/me`): текущият им химн, историята им като MVP, най-често слушаните им песни и
превключвател за заглушаване на химните на другите играчи, който започва да действа по време на играта.

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

---

## Какво получавате като администратор

**Песни.** Добавяне, редактиране, скриване или изтриване. Качване на корица, качване на клип за предварителен преглед, категория, в играта
права за достъп, ред на сортиране. Скриването на песен я премахва от менюто, без да се загуби изборът на никого — това
се връща точно такъв, какъвто беше.

**Маркер „никога не е възпроизвеждана“.** Плъгинът маркира всяка песен, която успешно възпроизвежда. Всяка песен, която има
етикетът „никога не е бил подпечатан“ се отбелязва за вас – така можете да забележите име на звуково събитие, което е въведено погрешно
преди няколко месеца и оттогава насам постепенно престава да работи.

**Категории.** Създайте жанрове, задайте цвят за всеки от тях и настройте (по избор) разрешение в играта, което блокира
целия жанр, пренаредете ги — всичко на място, без да напускате страницата.

**Играчи.** Всички, които са избрали химн, какво са избрали, както и бутон за нулиране.

**Табло** с **броя на** възпроизвежданията на ден за период от две седмици, най-популярните песни от последните 30 дни, най-новите
влизания в системата и списък с играчи, посочващи песни, които в момента са скрити.

---

## Вход и достъп

Входът се извършва **единствено чрез** **Steam OpenID** — сайтът никога не вижда и не съхранява парола. Steam връща
SteamID; уеб-API-то предоставя името и аватара.

Администраторският достъп представлява списък от SteamID64 в `.env`файла, а **не е** флаг в базата данни – това е направено умишлено.
Нищо, което се случва в базата данни или в панела за администратори, не може да повиши никого до администратор.

Качените корици се прекодират от страна на сървъра в квадратни изображения във формат WebP. Снимка от телефон с размер 5 MB се превръща в
~40 KB на плочка, а в кореновата директория на уебсайта се запазват единствено пиксели, независимо от това, какво се твърди, че е било каченото съдържание.

---

## Как комуникира с плъгина

И двете страни използват едни и същи таблици`mvp_music_*`. Плъгинът изтегля промените в каталога според зададения от вас интервал
(по подразбиране: на всеки 10 секунди) и чете изборите, когато даден играч се свърже; уебсайтът чете и записва
едни и същи редове.

- Песните, които са добавени, редактирани или скрити на сайта, се зареждат на сървъра за секунди. Звуковото събитие все още
трябва да присъства във вашето допълнение за работилницата — уебсайтът го регистрира, но не качва аудиофайлове в CS2.
- Превключвателите и бутонът за заглушаване се движат и в двете посоки, без да е необходимо повторно свързване.
- Всеки химн, възпроизведен по време на игра, се отразява в историята на сайта, в класациите и в отметката „никога не е възпроизвеждан“.
- Преименуването на звуково събитие или на скъсяване на категория запазва избраните елементи и историята. Никой не губи нищо.

Деактивирайте интеграцията с уебсайта в настройките на плъгина и таблиците на сайта няма да бъдат засегнати.

---

## Изисквания

| | |
|---|---|
| Плъгинът „Custom MVP Music“ | продава се отделно — задължително |
| PHP | версия 8.3 или по-нова, с разширението GD за корици |
| MySQL / MariaDB | същата база данни, която използва плъгинът |
| Домейн с HTTPS | Steam пренасочва обратно само към точния публичен URL адрес |
| Ключ за Steam Web API | безплатно, от Steam |

Laravel 13, Tailwind CSS v4 и Alpine.js. Стиловият файл се доставя в готово състояние, а Alpine се зарежда от
собствен сървър, така че не се използват нито Node, нито CDN.

---

## Какво получавате

- Цялата уебстраница, готова за качване.
- `DEPLOY.md`: подробно ръководство стъпка по стъпка за инсталиране на cPanel, включващо настройката на document-root, както и
`.env` ключове и бележката за Remote MySQL.
- Демо-генератор, който попълва сайта с примерни песни, изпълнители и история на възпроизвеждането за две седмици, така че
можете да видите крайния резултат, преди да го насочите към реални данни.
- Таблиците в базата данни се създават от тази страна, която се изпълни първа. Няма SQL заявка за импортиране.

---

## Версия

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

---

## Лиценз и поддръжка

- Използвайте го за колкото собствени сървъри и общности пожелаете, колкото дълго пожелаете.
- Забранява се преразпространяването, препродажбата, споделянето или публикуването на файловете, както изцяло, така и частично.
- Актуализациите за тази основна версия са безплатни.
- Не се възстановяват суми след доставката на файловете — горните изисквания са изброени изчерпателно, така че
Моля, преди да купите, се уверете, че конфигурацията ви съответства на изискванията.

Задавайте въпроси преди покупката.

---

*Custom MVP Music — Уебсайт · от illusion @ CodeStrike*