Ez az útmutató mindent tartalmaz, amire szükséged van az alt:V szervered elindításához a Legion Hosting-on, az első indítástól és server.toml konfigurációtól a játékmód resource-okon, CDN beállításon, hangos csevegésen át a játékosok csatlakozásáig az alt:V launcher-en keresztül. A resource fejlesztéshez, adatbázis beállításhoz és admin kezeléshez lásd az alt:V Admin és Resource beállítás cikket.

Mi az alt:V?

Az alt:V egy ingyenes, nyílt forráskódú többjátékos módosítás a Grand Theft Auto V-höz. Lehetővé teszi a játékosok számára, hogy egyedi játékmódokat futtató szerverekhez csatlakozzanak, mint például roleplay (RP), deathmatch, versenyzés, freeroam és még sok más. A szerver egyedi resource-okat futtat JavaScript, TypeScript vagy C# nyelven, teljes kontrollt biztosítva a szerver tulajdonosoknak a játékmenet logikája felett. A játékosok az alt:V launcher-en keresztül csatlakoznak, amely módosítja a GTA V-t a többjátékos kapcsolódáshoz.

Első indítás

Amikor először kapod meg az alt:V szerveredet, kövesd ezeket a lépéseket az online állapotba hozáshoz:

1. Jelentkezz be a GPanel-be és válaszd ki az alt:V szerveredet.
2. Navigálj a Startup fülre és konfiguráld a szerver nevét, maximális játékosszámot és egyéb indítási változókat.
3. Menj a Console fülre és kattints a Start gombra.
4. A szerver az első indításkor letölti az alt:V szerver fájlokat. Ez néhány percig tarthat.
5. Amint a konzol megjeleníti, hogy a szerver figyel és kész a csatlakozásokra, a szervered online.
6. Alapértelmezetten a szerver játékmód resource-ok nélkül indul. Resource-okat kell hozzáadnod a játékmenet létrehozásához. Részletekért lásd az alt:V Admin és Resource beállítás cikket.

GPanel indítási változók

Az alt:V több konfigurációs beállítást tesz elérhetővé indítási változóként a GPanel-ben. Navigálj a Startup fülre a módosításukhoz. A változtatások szerver újraindítást igényelnek.

Szerver konfiguráció (server.toml)

Az alt:V szerverek elsődleges konfigurációs fájlja a server.toml, amely a szerver gyökérkönyvtárában található. Ezt a fájlt a GPanel Files fülén vagy SFTP-n keresztül szerkesztheted.

Példa 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"]

Főbb beállítások: name (böngészőben megjelenő név), host (tartsd 0.0.0.0 értéken), port (meg kell egyeznie a GPanel-lel), players (maximális szám), password (üres a nyilvánoshoz), announce (true a böngészőben való megjelenéshez), token (hirdetési token az alt:V weboldalról, szükséges a böngészőben való listázáshoz), gamemode (böngésző címke, mint "Roleplay"), modules (szkript modulok: js-module vagy csharp-module), resources (betöltendő resource mappák tömbje), és tags (böngésző szűrő címkék).

Hirdetési token

Ahhoz, hogy a szervered megjelenjen az alt:V szerver böngészőben, szükséged van egy hirdetési tokenre az alt:V mester szerverről:

1. Látogass el az alt:V weboldalra és jelentkezz be vagy hozz létre egy fiókot.
2. Navigálj a szerver kezelés szekcióba és generálj egy új szerver tokent.
3. Másold ki a tokent és illeszd be a token mezőbe a server.toml fájlban.
4. Győződj meg róla, hogy announce = true van beállítva a konfigurációban.
5. Indítsd újra a szervert. Ezután meg kell jelennie a nyilvános böngészőben.

Játékmód resource-ok

Az alt:V szervereket resource-ok hajtják — szkriptek, amelyek meghatározzák az összes játékmenet logikát. Resource-ok nélkül a szerver nem rendelkezik egyedi funkciókkal. A resource-ok a resources/ könyvtárba kerülnek.

Resource felépítés

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)

Resource-ok betöltése

Add hozzá a resource neveket a resources tömbhöz a server.toml fájlban az indításkori betöltésükhöz:

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

Minden resource-nak rendelkeznie kell egy resource.toml fájllal a könyvtárában, amely meghatározza a típusát, függőségeit és szkript belépési pontjait. A resource-ok létrehozásának és kezelésének részleteiért lásd az alt:V Admin és Resource beállítás cikket.

CDN beállítás

Az alt:V CDN mechanizmust használ a kliens oldali fájlok (modellek, textúrák, szkriptek) kiszolgálásához a csatlakozó játékosok számára. A beépített CDN közvetlenül a szerverről szolgálja ki a fájlokat, nincs szükség extra konfigurációra — ez az alapértelmezett és a legtöbb szerver számára jól működik. Nagy méretű szerverek esetén sok egyedi eszközzel opcionálisan konfigurálhatsz egy külső CDN-t úgy, hogy feltöltöd a kliens fájlokat egy webszerverre és beállítod a CDN URL-t a resource konfigurációban, csökkentve a játékszerver sávszélesség-használatát.

Hangos csevegés

Az alt:V beépített hangos csevegés rendszerrel rendelkezik, amely lehetővé teszi a pozicionális (3D) hangkommunikációt a játékosok között. A hangos csevegés a server.toml-ban engedélyezhető és konfigurálható.

Hang konfiguráció

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

A bitrate a hang minőségét szabályozza (64000 a szabványos). Az external* mezők egy külső hangszervert konfigurálnak — hagyd őket üresen/nullán a beépített hangszerver használatához, amely a legtöbb beállításhoz ajánlott. A külső hangszerver opció csak haladó konfigurációkhoz szükséges, ahol a hang feldolgozás egy külön gépre van kihelyezve.

Hogyan csatlakoznak a játékosok

A játékosok az alt:V launcher-en keresztül csatlakoznak az alt:V szerverekhez, nem közvetlenül a GTA V-n keresztül.

Szerver böngészőn keresztül

1. Töltsd le és telepítsd az alt:V launcher-t az altvmp.com oldalról.
2. Indítsd el az alt:V launcher-t. Automatikusan felismeri és ellenőrzi a GTA V telepítést.
3. A launcher-ből böngészd a Server Browser-t.
4. Keress rá a szerveredre név alapján vagy használd a szűrőket (játékmód, címkék, játékosszám).
5. Kattints a szerveredre és válaszd a Connect opciót.
6. Ha a szerver jelszóval védett, a játékosnak meg kell adnia a jelszót.
7. A GTA V elindul az alt:V többjátékos moddal és csatlakozik a szerveredhez.

Közvetlen csatlakozással

1. Az alt:V launcher-ben válaszd a Direct Connect opciót.
2. Add meg a szervered IP címét és portját IP:PORT formátumban (pl. 192.168.1.1:7788).
3. Kattints a Connect gombra.

A szervered IP címének és portjának megkereséséhez lásd: Szerver IP és port megkeresése.

Maximális játékosszám és teljesítmény

Az alt:V szerverek magas játékosszámot támogatnak, de a teljesítmény nagymértékben függ a resource-aidtól és a szerver csomagtól:

• 32–128 játékos: A legtöbb szerver számára általános tartomány. Egyszerű játékmódok magasabb számnál is zökkenőmentesen futnak.
• 128–512+ játékos: Lehetséges optimalizált szervereken hatékony resource-okkal. Több CPU-t és RAM-ot igényel.
• Resource hatékonyság: A rosszul optimalizált szkriptek a teljesítmény problémák elsődleges okai. Szerver oldali szkriptek, amelyek tick-enként nehéz műveleteket futtatnak vagy nagy adatstruktúrákat tartanak a memóriában, szűk keresztmetszetet okozhatnak a szerveren.
• Adatbázis lekérdezések: Az adatbázisokat (MySQL, MongoDB) használó játékmódoknak aszinkron lekérdezéseket kell használniuk a fő szál blokkolásának elkerülésére.

Kapcsolódó cikkek

• alt:V Admin és Resource beállítás — Resource fejlesztés, adatbázis beállítás, admin eszközök és hibaelhárítás
• Szerver IP és port megkeresése
• Fájlok feltöltése SFTP-n keresztül
• Szerver indítási útmutató — Általános útmutató bármely játékszerver indításához a Legion Hosting-on

További segítségre van szükséged?

Ha olyan problémákat tapasztalsz, amelyeket ez az útmutató nem tárgyal, támogatói csapatunk készséggel segít. Nyiss egy jegyet a legionhosting.net/submitticket.php címen a szerver adataiddal és a probléma leírásával.