# Custom MVP Music — Site web

**Un site web de autentificare pe Steam pentru melodiile tale preferate din MVP. Jucătorii pot răsfoi melodiile și le pot asculta în
browser și să-l selecteze cu un singur clic. Catalogul se gestionează dintr-un panou de administrare, în loc să fie editat
un fișier de configurare prin FTP.**

Site-ul și pluginul utilizează aceeași bază de date MySQL, așa că nu este nevoie să sincronizați nimic manual. Adăugați un
melodie de pe site și aceasta apare în `!mvp`meniul din joc în câteva secunde. Un jucător care alege o
imnul de pe site se va auzi data viitoare când vor fi MVP, fără a fi nevoie să se reconecteze — iar o alegere făcută în
jocul apare imediat în profilul lor.

---

## Înainte de a cumpăra — citiți această secțiune

**Acesta este site-ul web asociat pluginului Custom MVP Music, nu un produs de sine stătător.** Acesta
modifică baza de date a pluginului. Dacă pluginul nu este instalat pe serverul tău CS2, nimic nu funcționează în joc.

Două cerințe practice:

- **Site-ul web trebuie să aibă acces la baza de date MySQL a pluginului.** Dacă site-ul și serverul de joc se află pe
pe calculatoare diferite — situația obișnuită — trebuie să permiteți adresei IP a furnizorului de găzduire web să se conecteze (în cPanel)
(adică *MySQL la distanță*) sau mutați baza de date lângă site și configurați pluginul să o acceseze.
- **O cheie API web Steam**, oferită gratuit de Steam, pentru numele jucătorilor și avatare.

În plus, funcționează pe o găzduire partajată obișnuită. Nu există nicio etapă de compilare Node, niciun proces de lucru în coadă, niciun
`storage:link`, și fără sarcini cron — sunt suficiente doar PHP 8.3 și MySQL. Un ghid pas cu pas pentru cPanel este
inclus.

---

## Ce primesc jucătorii tăi

**Un catalog care merită răsfoit.** Coperta, etichete de categorie, căutare rapidă și o mențiune de genul „N jucători folosesc acest lucru”
ia în calcul toate melodiile care includ selecții din joc, nu doar cele de pe site.

**Previzualizări în browser.** Încarcă un clip scurt pentru fiecare melodie, iar utilizatorii îl pot asculta înainte de a se decide,
în loc să aleagă un nume la întâmplare și să aștepte următoarea rundă de MVP.

**Un singur clic pentru a-și seta melodia preferată** — o melodie anume, redare aleatorie din toate melodiile sau redare aleatorie
în cadrul unei singure categorii. Aceleași trei opțiuni pe care le oferă meniul din joc.

**Noutățile săptămânii și o transmisiune în direct.** Cele cinci melodii cele mai ascultate din ultimele șapte zile, precum și ultima
opt MVP-uri pe măsură ce apar. Acest lucru conferă paginii un aspect dinamic și promovează discret serverul tău.

**Un profil personal** (`/me`): imnul lor actual, istoricul titlurilor de MVP, melodiile pe care le ascultă cel mai des și
un buton pentru a dezactiva imnurile celorlalți jucători, care se activează în timpul jocului.

**Melodiile VIP sunt marcate.** Site-ul respectă limita de melodii gratuite impusă de plugin și marchează tot ce depășește această limită
acesta, astfel încât jucătorii să poată vedea ce beneficii oferă un rang VIP. Pluginul se ocupă de aplicarea efectivă a regulilor.

---

## Ce beneficii ai în calitate de administrator

**Melodii.** Adăugare, editare, ascundere sau ștergere. Încărcare copertă, încărcare clip de previzualizare, categorie, în joc
permisiune, ordinea de afișare. Ascunderea unei melodii o elimină din meniu fără a șterge selecția nimănui — aceasta
revine exact așa cum era.

**Un indicator „nu a fost redată niciodată”.** Pluginul marchează fiecare melodie pe care o redă cu succes. Orice melodie care are
„nu a fost niciodată marcat” este evidențiat pentru tine; astfel poți identifica un nume de eveniment sonor care a fost tastat greșit
acum câteva luni și, de atunci, a început să se defecteze treptat, fără să se observe.

**Categorii.** Creați genuri, atribuiți fiecăruia o culoare, setați o permisiune opțională în joc care blochează
întregul gen, reordonează-le — totul direct pe pagină, fără a părăsi pagina.

**Jucători.** Toți cei care au ales un imn, ce au ales și un buton de resetare.

**Un panou de control** cu numărul de redări pe zi pe parcursul a două săptămâni, cele mai ascultate melodii din ultimele 30 de zile, cele mai recente
autentificări și o listă de jucători care indică melodiile ascunse în prezent.

---

## Autentificare și acces

Autentificarea se face **exclusiv** prin **Steam OpenID** — site-ul nu vede și nu stochează niciodată parola. Steam returnează
SteamID; API-ul web furnizează numele și avatarul.

Accesul de administrator constă într-o listă de SteamID64-uri din `.env`fișier, și **nu** într-un indicator de bază de date, așa cum s-a intenționat.
Nimic din ceea ce se întâmplă în baza de date sau în panoul de administrare nu poate promova pe cineva la statutul de administrator.

Imaginile încărcate sunt recodificate pe server în imagini WebP pătrate. O fotografie de pe telefon de 5 MB devine o
O imagine de aproximativ 40 KB, iar în directorul rădăcină al site-ului ajung doar pixeli, indiferent de ce s-a pretins că ar fi fișierul încărcat.

---

## Cum comunică cu pluginul

Ambele părți utilizează aceleași tabele`mvp_music_*`. Pluginul preia modificările din catalog la un interval de timp pe care îl setezi tu
(implicit: la fiecare 10 secunde) și citește alegerile atunci când un jucător se conectează; site-ul web citește și scrie
aceleași rânduri.

- Melodiile adăugate, editate sau ascunse pe site ajung pe server în câteva secunde. Evenimentul audio încă
trebuie să existe în addon-ul tău pentru atelier — site-ul web îl înregistrează, dar nu încarcă fișiere audio în CS2.
- Butonul de selecție și comutatorul de dezactivare a sunetului se pot deplasa în ambele direcții, fără a fi necesară reconectarea.
- Fiecare imn redat în timpul jocului contribuie la istoricul site-ului, la clasamente și la indicatorul „niciodată redat”.
- Redenumirea unui eveniment sonor sau a unui slug de categorie păstrează selecțiile și istoricul. Nimeni nu pierde nimic.

Dacă dezactivezi integrarea cu site-ul web din setările pluginului, tabelele site-ului nu vor fi niciodată modificate.

---

## Cerințe

| | |
|---|---|
| Pluginul Custom MVP Music | se vinde separat — obligatoriu |
| PHP | 8.3 sau o versiune mai recentă, cu extensia GD pentru coperți |
| MySQL / MariaDB | aceeași bază de date pe care o folosește pluginul |
| Un domeniu cu HTTPS | Steam redirecționează doar către aceeași adresă URL publică |
| Cheia API-ului web Steam | gratuit, de pe Steam |

Laravel 13, Tailwind CSS v4 și Alpine.js. Foaia de stil este inclusă gata configurată, iar Alpine este furnizat de la
propriul tău server, așa că nu sunt implicate nici Node, nici CDN.

---

## Ce primiți

- Site-ul complet, gata de încărcare.
- `DEPLOY.md`: un ghid pas cu pas pentru implementarea cPanel, inclusiv configurarea directorului rădăcină pentru documente,
`.env` cheile și nota privind MySQL la distanță.
- Un program de testare care populează site-ul cu melodii de exemplu, utilizatori și un istoric de redare de două săptămâni, astfel încât
puteți vedea rezultatul final înainte de a-l conecta la date reale.
- Tabelele bazei de date sunt create de partea care se execută prima. Nu există nicio instrucțiune SQL de importat.

---

## Versiune

**1.0** — versiunea actuală.

---

## Licență și asistență

- Folosește-l pentru câte servere și comunități proprii dorești, pentru cât timp dorești.
- Nu redistribuiți, nu revindeți, nu partajați și nu publicați fișierele, nici integral, nici parțial.
- Actualizările pentru această versiune principală sunt gratuite.
- Nu se acordă rambursări după livrarea fișierelor — cerințele de mai sus sunt enumerate în întregime, așa că
Vă rugăm să vă asigurați că specificațiile corespund înainte de a efectua achiziția.

Întrebările înainte de cumpărare sunt binevenite.

---

*Custom MVP Music — Site web · realizat de illusion @ CodeStrike*