Acest ghid acoperă tot ce aveți nevoie pentru a vă pune în funcțiune serverul alt:V pe Legion Hosting, de la pornirea pentru prima dată și configurarea server.toml până la resursele modurilor de joc, configurarea CDN, chat-ul vocal și modul în care jucătorii se conectează prin launcher-ul alt:V. Pentru dezvoltarea resurselor, configurarea bazei de date și gestionarea administrării, consultați Configurarea administratorilor și a resurselor alt:V.

Ce este alt:V?

alt:V este o modificare multiplayer gratuită și open-source pentru Grand Theft Auto V. Permite jucătorilor să se conecteze la servere personalizate care rulează moduri de joc unice precum roleplay (RP), deathmatch, racing, freeroam și altele. Serverul rulează resurse personalizate scrise în JavaScript, TypeScript sau C#, oferind proprietarilor de servere control complet asupra logicii jocului. Jucătorii se conectează prin launcher-ul alt:V, care modifică GTA V pentru conectivitate multiplayer.

Prima pornire

Când primiți pentru prima dată serverul dumneavoastră alt:V, urmați acești pași pentru a-l pune online:

1. Conectați-vă la GPanel și selectați serverul dumneavoastră alt:V.
2. Navigați la fila Startup și configurați numele serverului, numărul maxim de jucători și alte variabile de pornire.
3. Accesați fila Console și faceți clic pe Start.
4. Serverul va descărca fișierele serverului alt:V la prima pornire. Acest lucru poate dura câteva minute.
5. Odată ce consola afișează că serverul ascultă și este pregătit pentru conexiuni, serverul dumneavoastră este online.
6. În mod implicit, serverul pornește fără resurse de mod de joc. Va trebui să adăugați resurse pentru a crea jocul. Consultați Configurarea administratorilor și a resurselor alt:V pentru detalii.

Variabile de pornire GPanel

alt:V expune mai multe opțiuni de configurare ca variabile de pornire în GPanel. Navigați la fila Startup pentru a le modifica. Modificările necesită o repornire a serverului.

Configurarea serverului (server.toml)

Fișierul principal de configurare pentru serverele alt:V este server.toml, situat în directorul rădăcină al serverului. Puteți edita acest fișier prin fila Files din GPanel sau prin SFTP.

Exemplu server.toml

name = "My alt:V Server"
host = "0.0.0.0"
port = 7788
players = 128
password = ""
announce = true
token = ""
gamemode = "Freeroam"
website = ""
language = "en"
description = "A custom GTA V multiplayer server"
modules = ["js-module"]
resources = ["myresource"]
tags = ["freeroam", "fun"]

Setări cheie: name (numele afișat în browser), host (păstrați 0.0.0.0), port (trebuie să se potrivească cu GPanel), players (numărul maxim), password (gol pentru public), announce (true pentru a apărea în browser), token (token-ul de anunțare de pe site-ul alt:V, necesar pentru listarea în browser), gamemode (etichetă din browser precum „Roleplay”), modules (module de script: js-module sau csharp-module), resources (matrice de foldere de resurse de încărcat) și tags (etichete de filtrare din browser).

Token-ul de anunțare

Pentru ca serverul dumneavoastră să apară în browserul de servere alt:V, aveți nevoie de un token de anunțare de la serverul principal alt:V:

1. Vizitați site-ul alt:V și conectați-vă sau creați un cont.
2. Navigați la secțiunea de gestionare a serverului și generați un nou token de server.
3. Copiați token-ul și lipiți-l în câmpul token din server.toml.
4. Asigurați-vă că announce = true în configurația dumneavoastră.
5. Reporniți serverul. Acum ar trebui să apară în browserul public.

Resurse de mod de joc

Serverele alt:V sunt alimentate de resurse — scripturi care definesc toată logica jocului. Fără resurse, un server nu are funcționalitate personalizată. Resursele sunt plasate în directorul resources/.

Structura resursei

resources/
  myresource/
    resource.toml       <-- Resource configuration
    server/
      index.js          <-- Server-side script
    client/
      index.js          <-- Client-side script (runs on the player's GTA V)

Încărcarea resurselor

Adăugați numele resurselor în matricea resources din server.toml pentru a le încărca la pornire:

resources = ["chat", "freeroam", "spawn"]

Fiecare resursă trebuie să aibă un fișier resource.toml în directorul său care îi definește tipul, dependențele și punctele de intrare ale scripturilor. Pentru detalii despre crearea și gestionarea resurselor, consultați Configurarea administratorilor și a resurselor alt:V.

Configurarea CDN

alt:V folosește un mecanism CDN pentru a livra fișiere pe partea de client (modele, texturi, scripturi) către jucătorii care se conectează. CDN-ul încorporat livrează fișierele direct de pe server fără configurare suplimentară — aceasta este opțiunea implicită și funcționează bine pentru majoritatea serverelor. Pentru serverele la scară largă cu multe active personalizate, puteți configura opțional un CDN extern încărcând fișierele clientului pe un server web și setând URL-ul CDN în configurația resursei, reducând utilizarea lățimii de bandă a serverului de joc.

Chat vocal

alt:V include un sistem de chat vocal încorporat care permite comunicarea vocală pozițională (3D) între jucători. Chat-ul vocal este activat și configurat în server.toml.

Configurarea vocii

[voice]
bitrate = 64000
externalSecret = ""
externalHost = ""
externalPort = 0

Câmpul bitrate controlează calitatea vocii (64000 este standard). Câmpurile external* configurează un server de voce extern — lăsați-le goale/zero pentru a folosi serverul de voce încorporat, care este recomandat pentru majoritatea configurațiilor. Opțiunea serverului de voce extern este necesară doar pentru configurații avansate în care procesarea vocii este transferată pe o mașină separată.

Cum se conectează jucătorii

Jucătorii se conectează la serverele alt:V prin launcher-ul alt:V, nu direct prin GTA V.

Prin browserul de servere

1. Descărcați și instalați launcher-ul alt:V de la altvmp.com.
2. Lansați launcher-ul alt:V. Acesta va detecta și verifica instalarea GTA V.
3. Din launcher, navigați prin Server Browser.
4. Căutați serverul dumneavoastră după nume sau folosiți filtre (mod de joc, etichete, număr de jucători).
5. Faceți clic pe serverul dumneavoastră și selectați Connect.
6. Dacă serverul are o parolă, jucătorul va fi solicitat să o introducă.
7. GTA V se va lansa cu modul multiplayer alt:V și se va conecta la serverul dumneavoastră.

Prin conectare directă

1. În launcher-ul alt:V, selectați Direct Connect.
2. Introduceți adresa IP și portul serverului dumneavoastră în formatul IP:PORT (de exemplu, 192.168.1.1:7788).
3. Faceți clic pe Connect.

Pentru a găsi adresa IP și portul serverului dumneavoastră, consultați Cum să găsiți IP-ul și portul serverului.

Numărul maxim de jucători și performanța

Serverele alt:V pot suporta un număr mare de jucători, dar performanța depinde în mare măsură de resursele și planul serverului dumneavoastră:

• 32–128 jucători: Un interval comun pentru majoritatea serverelor. Modurile de joc simple rulează fără probleme la un număr mai mare.
• 128–512+ jucători: Posibil pentru serverele optimizate cu resurse eficiente. Necesită mai mult CPU și RAM.
• Eficiența resurselor: Scripturile slab optimizate sunt cauza principală a problemelor de performanță. Scripturile pe partea de server care rulează operațiuni grele la fiecare tick sau mențin structuri mari de date în memorie pot crea blocaje pe server.
• Interogări la baza de date: Modurile de joc care folosesc baze de date (MySQL, MongoDB) ar trebui să folosească interogări asincrone pentru a evita blocarea firului principal.

Articole conexe

• Configurarea administratorilor și a resurselor alt:V — Dezvoltarea resurselor, configurarea bazei de date, instrumente de administrare și depanare
• 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ă și o descriere a problemei.