Tento průvodce pokrývá vše, co potřebujete k zprovoznění vašeho alt:V serveru na Legion Hosting, od prvního spuštění a konfigurace server.toml přes herní režimy, nastavení CDN, hlasový chat až po způsob, jakým se hráči připojují přes alt:V launcher. Pro vývoj resourceů, nastavení databáze a správu administrátorů viz alt:V Správa administrátorů a nastavení resourceů.

Co je alt:V?

alt:V je bezplatná open-source multiplayerová modifikace pro Grand Theft Auto V. Umožňuje hráčům připojit se k vlastním serverům s unikátními herními režimy, jako je roleplay (RP), deathmatch, závodění, freeroam a další. Server spouští vlastní resourcy napsané v JavaScript, TypeScript nebo C#, což dává majitelům serverů plnou kontrolu nad herní logikou. Hráči se připojují přes alt:V launcher, který modifikuje GTA V pro multiplayerové připojení.

První spuštění

Když poprvé obdržíte svůj alt:V server, postupujte podle těchto kroků k jeho zprovoznění:

1. Přihlaste se do GPanel a vyberte svůj alt:V server.
2. Přejděte na záložku Startup a nakonfigurujte název serveru, maximální počet hráčů a další startovací proměnné.
3. Přejděte na záložku Console a klikněte na Start.
4. Server při prvním spuštění stáhne soubory alt:V serveru. To může trvat několik minut.
5. Jakmile konzole zobrazí, že server naslouchá a je připraven pro připojení, váš server je online.
6. Ve výchozím nastavení se server spustí bez herních resourceů. Pro vytvoření hry budete muset přidat resourcy. Podrobnosti viz alt:V Správa administrátorů a nastavení resourceů.

Startovací proměnné v GPanel

alt:V nabízí několik konfiguračních možností jako startovací proměnné v GPanel. Přejděte na záložku Startup pro jejich úpravu. Změny vyžadují restart serveru.

Konfigurace serveru (server.toml)

Hlavní konfigurační soubor pro alt:V servery je server.toml, umístěný v kořenovém adresáři serveru. Tento soubor můžete upravit přes záložku Files v GPanel nebo přes SFTP.

Příklad 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"]

Klíčová nastavení: name (název zobrazený v prohlížeči), host (ponechte 0.0.0.0), port (musí odpovídat GPanel), players (maximální počet), password (prázdné pro veřejný server), announce (true pro zobrazení v prohlížeči), token (oznamovací token z webu alt:V, vyžadován pro zobrazení v prohlížeči), gamemode (štítek v prohlížeči jako "Roleplay"), modules (skriptové moduly: js-module nebo csharp-module), resources (pole složek resourceů k načtení) a tags (filtrovací tagy v prohlížeči).

Oznamovací token

Aby se váš server zobrazil v prohlížeči serverů alt:V, potřebujete oznamovací token z hlavního serveru alt:V:

1. Navštivte web alt:V a přihlaste se nebo si vytvořte účet.
2. Přejděte do sekce správy serverů a vygenerujte nový serverový token.
3. Zkopírujte token a vložte ho do pole token ve vašem server.toml.
4. Ujistěte se, že máte announce = true ve vaší konfiguraci.
5. Restartujte server. Nyní by se měl zobrazit ve veřejném prohlížeči.

Resourcy herních režimů

alt:V servery jsou poháněny resourcy — skripty, které definují veškerou herní logiku. Bez resourceů nemá server žádnou vlastní funkčnost. Resourcy se umisťují do adresáře resources/.

Struktura resourceu

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)

Načítání resourceů

Přidejte názvy resourceů do pole resources v server.toml pro jejich načtení při startu:

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

Každý resource musí mít ve svém adresáři soubor resource.toml, který definuje jeho typ, závislosti a vstupní body skriptů. Podrobnosti o vytváření a správě resourceů viz alt:V Správa administrátorů a nastavení resourceů.

Nastavení CDN

alt:V používá CDN mechanismus pro doručování souborů na straně klienta (modely, textury, skripty) připojujícím se hráčům. Vestavěné CDN doručuje soubory přímo ze serveru bez nutnosti další konfigurace — toto je výchozí nastavení a funguje dobře pro většinu serverů. Pro velké servery s mnoha vlastními assety můžete volitelně nakonfigurovat externí CDN nahráním klientských souborů na webový server a nastavením CDN URL v konfiguraci resourceu, čímž snížíte využití šířky pásma herního serveru.

Hlasový chat

alt:V obsahuje vestavěný systém hlasového chatu, který umožňuje poziční (3D) hlasovou komunikaci mezi hráči. Hlasový chat se povoluje a konfiguruje v server.toml.

Konfigurace hlasu

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

bitrate ovládá kvalitu hlasu (64000 je standardní). Pole external* konfigurují externí hlasový server — ponechte je prázdná/nulové pro použití vestavěného hlasového serveru, což je doporučeno pro většinu nastavení. Možnost externího hlasového serveru je potřeba pouze pro pokročilé konfigurace, kde je zpracování hlasu přesunuto na samostatný stroj.

Jak se hráči připojují

Hráči se připojují k alt:V serverům přes alt:V launcher, nikoli přímo přes GTA V.

Přes prohlížeč serverů

1. Stáhněte a nainstalujte alt:V launcher z altvmp.com.
2. Spusťte alt:V launcher. Ten detekuje a ověří instalaci GTA V.
3. Z launcheru procházejte Server Browser.
4. Vyhledejte svůj server podle názvu nebo použijte filtry (herní režim, tagy, počet hráčů).
5. Klikněte na svůj server a vyberte Connect.
6. Pokud má server heslo, hráč bude vyzván k jeho zadání.
7. GTA V se spustí s multiplayerovým modem alt:V a připojí se k vašemu serveru.

Přes přímé připojení

1. V alt:V launcheru vyberte Direct Connect.
2. Zadejte IP adresu a port vašeho serveru ve formátu IP:PORT (např. 192.168.1.1:7788).
3. Klikněte na Connect.

Pro zjištění IP adresy a portu vašeho serveru viz Jak zjistit IP adresu a port serveru.

Maximální počet hráčů a výkon

alt:V servery mohou podporovat vysoký počet hráčů, ale výkon závisí značně na vašich resourcích a serverovém plánu:

• 32–128 hráčů: Běžný rozsah pro většinu serverů. Jednoduché herní režimy běží plynule i při vyšších počtech.
• 128–512+ hráčů: Možné pro optimalizované servery s efektivními resourcy. Vyžaduje více CPU a RAM.
• Efektivita resourceů: Špatně optimalizované skripty jsou hlavní příčinou problémů s výkonem. Serverové skripty, které provádějí náročné operace každý tick nebo udržují velké datové struktury v paměti, mohou server zpomalit.
• Databázové dotazy: Herní režimy využívající databáze (MySQL, MongoDB) by měly používat asynchronní dotazy, aby neblokovaly hlavní vlákno.

Související články

• alt:V Správa administrátorů a nastavení resourceů — Vývoj resourceů, nastavení databáze, nástroje pro správu a řešení problémů
• Jak zjistit IP adresu a port serveru
• Jak nahrávat soubory přes SFTP
• Průvodce spuštěním serveru — Obecný průvodce pro spuštění jakéhokoli herního serveru na Legion Hosting

Potřebujete další pomoc?

Pokud máte problémy, které tento průvodce nepokrývá, náš tým podpory je připraven vám pomoci. Otevřete tiket na legionhosting.net/submitticket.php s údaji o vašem serveru a popisem problému.