Acest ghid acoperă dezvoltarea resurselor, configurarea bazei de date, instrumentele de administrare, gestionarea jucătorilor, gestionarea vehiculelor și a armelor, precum și depanarea pentru serverul dumneavoastră alt:V pe Legion Hosting. Pentru configurarea inițială a serverului, configurarea server.toml și instrucțiunile de conectare, consultați Ghidul de configurare a serverului alt:V.

---

Configurarea administratorilor

alt:V nu are un sistem de administrare încorporat. Funcționalitatea de administrare este implementată prin resurse (scripturi) pe care le creați sau le instalați. Majoritatea modurilor de joc își implementează propriul sistem de administrare cu niveluri de permisiune, roluri și comenzi de administrator.

Abordări comune de administrare

• Roluri bazate pe bază de date: Majoritatea cadrelor de roleplay și de mod de joc stochează rolurile de administrator într-o bază de date. Administratorilor li se atribuie roluri (de exemplu, moderator, admin, superadmin) care acordă niveluri diferite de permisiune.
• Administratori bazați pe configurare: Configurațiile mai simple pot folosi un fișier de configurare care listează ID-urile Steam ale administratorilor sau ID-urile alt:V cu nivelurile lor de permisiune.
• Comenzi de consolă: Consola serverului GPanel are întotdeauna acces complet. Puteți scrie scripturi pe partea de server care acceptă intrarea din consolă pentru operațiuni de administrare.

Configurarea unei resurse de administrare

1. Alegeți sau dezvoltați o resursă de administrare care se potrivește modului dumneavoastră de joc.
2. Încărcați resursa în directorul resources/ prin fila Files sau SFTP.
3. Adăugați numele resursei în matricea resources din server.toml.
4. Configurați resursa de administrare (setați ID-urile Steam/alt:V de administrator, nivelurile de permisiune etc.).
5. Reporniți serverul.

---

Sistemul de resurse

Resursele sunt blocurile de construcție de bază ale serverelor alt:V. Fiecare resursă este un modul autonom care poate conține cod pe partea de server, cod pe partea de client sau ambele. Resursele sunt scrise în JavaScript, TypeScript sau C#.

Structura resursei

resources/
  my-resource/
    resource.toml         <-- Resource configuration (required)
    server/
      index.js            <-- Server-side entry point
      utils.js            <-- Additional server-side files
    client/
      index.js            <-- Client-side entry point (runs in player's GTA V)
    shared/
      config.js           <-- Shared code accessible by both server and client

Configurarea resource.toml

type = "js"
main = "server/index.js"
client-main = "client/index.js"
client-files = ["client/*"]
deps = ["chat"]

Câmpuri: type (js sau csharp), main (punctul de intrare pe partea de server), client-main (punctul de intrare pe partea de client, rulează în GTA V al jucătorului), client-files (fișiere de trimis către client, acceptă glob-uri), deps (alte resurse de încărcat mai întâi).

---

Instalarea resurselor

Pentru a instala o resursă predefinită pe serverul dumneavoastră:

1. Descărcați fișierele resursei (de obicei un folder care conține resource.toml și fișiere de script).
2. Opriți serverul în GPanel.
3. Încărcați folderul resursei în resources/ prin fila Files sau SFTP.
4. Adăugați numele folderului resursei în matricea resources din server.toml:

resources = ["existing-resource", "new-resource"]

5. Dacă resursa are dependențe, asigurați-vă că și acestea sunt instalate și listate.
6. Configurați resursa conform documentației sale (fișiere de configurare, configurarea bazei de date etc.).
7. Porniți serverul. Verificați consola pentru mesajele de încărcare a resurselor și orice erori.

Eliminarea unei resurse

1. Opriți serverul.
2. Eliminați numele resursei din matricea resources din server.toml.
3. Opțional, ștergeți folderul resursei din resources/.
4. Porniți serverul.

---

Configurarea bazei de date

Majoritatea modurilor de joc alt:V necesită o bază de date pentru a stoca datele jucătorilor, vehiculele, inventarele și alte informații persistente. Cele mai comune două sisteme de baze de date pentru alt:V sunt MongoDB și MySQL/MariaDB.

MongoDB

MongoDB este o bază de date de documente NoSQL utilizată frecvent cu resurse JavaScript/TypeScript. Folosiți un serviciu gestionat precum MongoDB Atlas (nivel gratuit disponibil) sau o instanță auto-găzduită. Obțineți șirul de conexiune (de exemplu, mongodb+srv://user:[email protected]/mydb) și configurați-l în fișierul de configurare al resursei. Resursele Node.js folosesc pachetul npm mongodb.

MySQL / MariaDB

MySQL este utilizat frecvent cu resurse C# și unele cadre JavaScript. Obțineți o bază de date de la un serviciu gestionat sau o instanță auto-găzduită, configurați-vă resursele cu detaliile conexiunii (gazdă, port, nume de utilizator, parolă, nume bază de date) și rulați orice scripturi de migrare SQL necesare.

---

Gestionarea jucătorilor

Gestionarea jucătorilor în alt:V este realizată prin resursele dumneavoastră. Operațiunile comune includ:

Identificarea jucătorilor

alt:V oferă mai mulți identificatori pentru fiecare jucător conectat:

Eliminarea și interzicerea

Implementați funcționalitatea de eliminare și interzicere în resursele dumneavoastră:

import alt from "alt-server";

// Kick a player
player.kick("Reason for kick");

// Ban check on connect (store bans in database)
alt.on("playerConnect", (player) => {
    if (isPlayerBanned(player.socialID)) {
        player.kick("You are banned from this server.");
    }
});

---

Gestionarea vehiculelor și a armelor

Vehiculele și armele sunt gestionate prin scripturi pe partea de server. alt:V vă oferă control complet asupra apariției, modificării și eliminării vehiculelor și armelor.

Apariția vehiculelor

import alt from "alt-server";

// Spawn a vehicle at a position
const vehicle = new alt.Vehicle(
    "sultan",            // Vehicle model name
    0, 0, 72,           // Position (x, y, z)
    0, 0, 0             // Rotation (rx, ry, rz)
);
vehicle.numberPlateText = "LEGION";

Acordarea armelor

// Give a weapon to a player
player.giveWeapon(alt.hash("weapon_pistol"), 100, true);

// Remove all weapons
player.removeAllWeapons();

Persistența vehiculelor

În mod implicit, vehiculele există doar în memoria serverului și se pierd la repornire. Pentru a păstra vehiculele între reporniri, stocați datele lor (model, poziție, modificări, proprietar) într-o bază de date și recreați-le la pornirea serverului.

---

Depanare

Resursele nu se încarcă

• Verificați dacă numele resursei din server.toml se potrivește exact cu numele folderului din resources/.
• Verificați dacă resursa are un fișier resource.toml valid cu câmpurile type și main corecte.
• Verificați consola pentru mesaje de eroare în timpul încărcării resursei. Erorile de sintaxă din scripturi vor împiedica pornirea resursei.
• Asigurați-vă că toate dependențele listate în deps sunt instalate și încărcate.
• Verificați dacă modulul corect este încărcat în server.toml (js-module pentru JavaScript, csharp-module pentru C#).

Jucătorii nu se pot conecta

• Verificați dacă serverul rulează și apare ca online în GPanel.
• Verificați dacă jucătorii folosesc launcher-ul alt:V, nu launcher-ul obișnuit GTA V.
• Asigurați-vă că ramura serverului alt:V se potrivește cu cea pe care o au jucătorii (release, rc sau dev). Ramurile nepotrivite împiedică conexiunile.
• Dacă este protejat cu parolă, verificați dacă jucătorii introduc parola corectă.
• Cereți jucătorilor să încerce conectarea directă cu IP-ul și portul. Consultați Cum să găsiți IP-ul și portul serverului.

Blocările serverului

• Verificați consola pentru mesaje de eroare înainte de blocare.
• Resursele defecte sunt cea mai comună cauză a blocărilor. Dezactivați resursele adăugate recent pentru a izola problema.
• Asigurați-vă că fișierele serverului dumneavoastră sunt actualizate. Declanșați o reinstalare din fila Startup dacă este necesar.
• Scurgerile de memorie din resurse pot face ca serverul să rămână fără RAM în timp. Monitorizați graficele de resurse GPanel pentru creșterea constantă a utilizării memoriei.

Probleme de bază de date și voce

• Verificați acreditările bazei de date și șirurile de conexiune. Pentru MongoDB Atlas, adăugați IP-ul serverului dumneavoastră pe lista albă din setările de acces la rețea.
• Verificați consola pentru mesaje de eroare de conexiune la baza de date.
• Chat-ul vocal necesită secțiunea [voice] din server.toml plus resurse care implementează logica canalelor de voce. Configurația singură doar setează infrastructura.

Probleme de performanță

• Profilați resursele dumneavoastră pentru operațiuni costisitoare (bucle grele, apeluri sincrone la baza de date, creare excesivă de entități).
• Folosiți alt.setInterval și alt.setTimeout cu moderație. Operațiunile grele pe fiecare tick sunt cel mai comun ucigaș de performanță.
• Monitorizați graficele de resurse GPanel pentru utilizarea CPU și RAM.
• Luați în considerare actualizarea planului serverului dumneavoastră pentru un număr mare de jucători. Deschideți un tichet de asistență pentru a discuta opțiunile.

---

Articole conexe

• Ghidul de configurare a serverului alt:V — Configurarea inițială, configurarea server.toml, chat-ul vocal și instrucțiunile de conectare
• Cum să găsiți IP-ul și portul serverului
• Cum să încărcați fișiere prin SFTP
• Ghidul de pornire a serverului — Ghid general pentru pornirea oricărui server de joc pe Legion Hosting

---

Aveți nevoie de mai mult ajutor?

Dacă întâmpinați probleme care nu sunt acoperite în acest ghid, echipa noastră de asistență este disponibilă pentru a vă ajuta. Deschideți un tichet la legionhosting.net/submitticket.php cu detaliile serverului dumneavoastră, o descriere a problemei și orice mesaje de eroare relevante din consola GPanel.