Documentația GamingCommunitySuite

Tot ce îți trebuie ca să pornești, să configurezi și să întreții comunitatea ta GCS.

Cerințe de sistem

Alege ediția

• VPS: ai un server cu acces root și vrei performanță maximă.
• Lite: ai o găzduire web care rulează aplicații Node.js.
• Găzduit de noi: nu vrei să te ocupi de partea tehnică.

Instalare pe VPS

Instalezi GamingCommunitySuite pe serverul tău Linux cu o singură comandă, apoi finalizezi totul dintr-un ghid în browser.

Ce îți trebuie

• pachetul GCS și cheia de licență, din zona client;
• un domeniu, de exemplu forum.exemplu.ro, și acces la DNS-ul lui;
• acces root la server (direct sau cu sudo);
• porturile 80 și 443 deschise. Certificatul HTTPS se obține automat.

1. Îndreaptă domeniul spre server

La furnizorul domeniului, creează o înregistrare A spre IP-ul serverului:

forum.exemplu.ro.   A   203.0.113.10

2. Rulează instalarea

tar -xzf gcs-<versiune>.tar.gz gcs-<versiune>/install.sh --strip-components=1
sudo bash install.sh --from gcs-<versiune>.tar.gz --domain forum.exemplu.ro

Scriptul verifică sistemul și pachetul, instalează ce lipsește, pornește comunitatea și îți afișează adresa și codul de instalare.

3. Ghidul de instalare

Deschide https://forum.exemplu.ro/install. Pașii apar în stânga, cu starea fiecăruia:

1. Codul de instalare, afișat de script.
2. Verificarea sistemului.
3. Licența și acceptarea termenilor.
4. Aplicațiile pornite și pagina de start.
5. Baza de date: lasă varianta inclusă.
6. Site-ul: nume, adresă, limbă, fus orar.
7. Email: opțional.
8. Administratorul principal.
9. Datele inițiale: cu date demo sau fără.
10. Instalarea, cu progres live.

4. Primul login și 2FA

La prima intrare în panoul de administrare activezi autentificarea în doi pași: scanezi codul QR și păstrezi codurile de rezervă.

Depanare

Instalare pe găzduire (Lite)

Ediția Lite rulează pe o găzduire web obișnuită cu Node.js (cPanel sau Plesk), fără acces root.

1. Creează baza de date

cPanel: MySQL Databases → bază nouă + utilizator nou cu ALL PRIVILEGES. Plesk: Databases → Add Database.

2. Urcă fișierele

1. Încarcă arhiva gcs-lite-<versiune>.zip într-un folder în afara public_html.
2. Dezarhiveaz-o din File Manager.
3. Nu șterge folderul config: acolo stau licența și fișierele încărcate.

3. Creează aplicația Node.js

În cPanel → Setup Node.js App sau Plesk → Node.js: versiunea 22, modul Production și fișierul de pornire app.js. Nu rula „NPM install”.

4. Instalează din browser

Deschide https://domeniul-tau/install, alege baza de date și apasă Testează conexiunea.

5. Adaugă sarcina cron

# exemplu: folosește comanda exactă afișată de ghid
*/5 * * * *  cd "/home/cont/gcs" && node cron.mjs

Ce diferă față de VPS

• Chatul și notificările vin cu câteva secunde întârziere.
• Sarcinile programate rulează la 5 minute.
• Pe MySQL, căutarea găsește cuvintele exacte și începuturile lor.

Cheia de licență

Licența GCS e o cheie care începe cu GCS1.. O găsești în zona client și o introduci în ghidul de instalare.

Ce conține

• titularul licenței;
• domeniile acoperite, cu sau fără www, sau toate subdomeniile;
• pachetul standard și aplicațiile premium incluse;
• data de expirare, dacă e cazul.

Cum se verifică

Comunitatea verifică cheia singură. O dată pe zi confirmă licența și la noi; dacă ai reînnoit sau ai adăugat aplicații, preia automat cheia nouă.

Perioada de grație

Dacă licența expiră, aplicațiile premium merg încă 30 de zile, cu un avertisment în panou. Forumul și aplicațiile standard nu se opresc.

Pornirea aplicațiilor

Aplicațiile se pornesc din Panou → Aplicații. Cele premium neincluse apar blocate, cu un link spre zona client.

Servere de joc

Aplicația premium Servere afișează serverele pe site și, prin pluginul GCS, sincronizează adminii, sancțiunile și VIP-ul.

Jocuri suportate

Pluginul pentru server

1. Descarci pluginul din pagina serverului, deja configurat.
2. Îl copiezi pe serverul de joc și repornești harta.
3. Serverul apare în panou „în așteptare”; îl aprobi.

Legarea contului

Membrul primește un cod pe site și scrie în joc /gcs COD. De atunci, statisticile și VIP-ul lui apar și pe profil.

Actualizări și backup

Versiunile noi apar în zona client. Pe VPS le instalezi cu o comandă; la găzduirea noastră le aplicăm noi.

Actualizarea

sudo bash /opt/gcs/install.sh --upgrade --from gcs-<versiune-nouă>.tar.gz

Actualizarea face întâi un backup, apoi instalează fișierele noi. Datele și setările rămân neatinse.

Backup și restaurare

gcs backup                       # backup în folderul implicit
gcs backup --out /mnt/backup     # backup în alt folder
gcs restore /mnt/backup/gcs-backup-20261005-0300.tar.gz

Comenzi utile