Ten przewodnik obejmuje wszystko, czego potrzebujesz, aby uruchomić swój serwer alt:V na Legion Hosting, od pierwszego uruchomienia i konfiguracji server.toml po zasoby trybów gry, konfigurację CDN, czat głosowy oraz to, jak gracze łączą się przez launcher alt:V. Aby zapoznać się z rozwojem zasobów, konfiguracją bazy danych i zarządzaniem administracyjnym, zobacz Konfiguracja administratora i zasobów alt:V.

Czym jest alt:V?

alt:V to darmowa, otwartoźródłowa modyfikacja wieloosobowa do Grand Theft Auto V. Pozwala graczom łączyć się z niestandardowymi serwerami uruchamiającymi unikalne tryby gry, takie jak roleplay (RP), deathmatch, wyścigi, freeroam i inne. Serwer uruchamia niestandardowe zasoby napisane w JavaScript, TypeScript lub C#, dając właścicielom serwerów pełną kontrolę nad logiką rozgrywki. Gracze łączą się przez launcher alt:V, który modyfikuje GTA V w celu zapewnienia łączności wieloosobowej.

Pierwsze uruchomienie

Gdy po raz pierwszy otrzymasz swój serwer alt:V, wykonaj te kroki, aby uruchomić go online:

1. Zaloguj się do GPanel i wybierz swój serwer alt:V.
2. Przejdź do zakładki Startup i skonfiguruj nazwę serwera, maksymalną liczbę graczy i inne zmienne startowe.
3. Przejdź do zakładki Console i kliknij Start.
4. Serwer pobierze pliki serwera alt:V przy pierwszym uruchomieniu. Może to potrwać kilka minut.
5. Gdy konsola wyświetli, że serwer nasłuchuje i jest gotowy na połączenia, Twój serwer jest online.
6. Domyślnie serwer uruchamia się bez zasobów trybu gry. Będziesz musiał dodać zasoby, aby utworzyć rozgrywkę. Zobacz Konfiguracja administratora i zasobów alt:V, aby uzyskać szczegóły.

Zmienne startowe GPanel

alt:V udostępnia kilka opcji konfiguracji jako zmienne startowe w GPanel. Przejdź do zakładki Startup, aby je zmodyfikować. Zmiany wymagają restartu serwera.

Konfiguracja serwera (server.toml)

Głównym plikiem konfiguracyjnym serwerów alt:V jest server.toml, znajdujący się w katalogu głównym serwera. Możesz edytować ten plik za pomocą zakładki Files w GPanel lub przez SFTP.

Przykładowy 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"]

Kluczowe ustawienia: name (nazwa wyświetlana w przeglądarce), host (zachowaj 0.0.0.0), port (musi odpowiadać GPanel), players (maksymalna liczba), password (puste dla publicznego), announce (true, aby pojawić się w przeglądarce), token (token ogłoszeniowy ze strony alt:V, wymagany do wpisu w przeglądarce), gamemode (etykieta przeglądarki, np. „Roleplay"), modules (moduły skryptów: js-module lub csharp-module), resources (tablica folderów zasobów do załadowania) oraz tags (tagi filtrowania w przeglądarce).

Token ogłoszeniowy

Aby Twój serwer pojawił się w przeglądarce serwerów alt:V, potrzebujesz tokenu ogłoszeniowego z serwera głównego alt:V:

1. Odwiedź stronę alt:V i zaloguj się lub utwórz konto.
2. Przejdź do sekcji zarządzania serwerem i wygeneruj nowy token serwera.
3. Skopiuj token i wklej go do pola token w swoim server.toml.
4. Upewnij się, że announce = true w Twojej konfiguracji.
5. Zrestartuj serwer. Powinien teraz pojawić się w publicznej przeglądarce.

Zasoby trybów gry

Serwery alt:V są napędzane przez zasoby — skrypty, które definiują całą logikę rozgrywki. Bez zasobów serwer nie ma żadnej niestandardowej funkcjonalności. Zasoby są umieszczane w katalogu resources/.

Struktura zasobu

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)

Ładowanie zasobów

Dodaj nazwy zasobów do tablicy resources w server.toml, aby załadować je przy uruchomieniu:

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

Każdy zasób musi mieć plik resource.toml w swoim katalogu, który definiuje jego typ, zależności i punkty wejścia skryptów. Aby uzyskać szczegóły dotyczące tworzenia i zarządzania zasobami, zobacz Konfiguracja administratora i zasobów alt:V.

Konfiguracja CDN

alt:V używa mechanizmu CDN do dostarczania plików po stronie klienta (modele, tekstury, skrypty) łączącym się graczom. Wbudowany CDN dostarcza pliki bezpośrednio z serwera bez potrzeby dodatkowej konfiguracji — jest to ustawienie domyślne i działa dobrze dla większości serwerów. W przypadku serwerów na dużą skalę z wieloma niestandardowymi zasobami możesz opcjonalnie skonfigurować zewnętrzny CDN, przesyłając pliki klienta na serwer internetowy i ustawiając adres URL CDN w konfiguracji zasobu, zmniejszając zużycie przepustowości serwera gry.

Czat głosowy

alt:V zawiera wbudowany system czatu głosowego, który umożliwia pozycyjną (3D) komunikację głosową między graczami. Czat głosowy jest włączany i konfigurowany w server.toml.

Konfiguracja głosu

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

Wartość bitrate kontroluje jakość głosu (64000 jest standardem). Pola external* konfigurują zewnętrzny serwer głosowy — pozostaw je puste/zerowe, aby używać wbudowanego serwera głosowego, co jest zalecane w przypadku większości konfiguracji. Opcja zewnętrznego serwera głosowego jest potrzebna tylko w zaawansowanych konfiguracjach, gdzie przetwarzanie głosu jest przenoszone na osobną maszynę.

Jak gracze się łączą

Gracze łączą się z serwerami alt:V przez launcher alt:V, a nie bezpośrednio przez GTA V.

Przez przeglądarkę serwerów

1. Pobierz i zainstaluj launcher alt:V ze strony altvmp.com.
2. Uruchom launcher alt:V. Wykryje i zweryfikuje instalację GTA V.
3. Z launchera przeglądaj Server Browser.
4. Wyszukaj swój serwer według nazwy lub użyj filtrów (tryb gry, tagi, liczba graczy).
5. Kliknij swój serwer i wybierz Connect.
6. Jeśli serwer ma hasło, gracz zostanie poproszony o jego wprowadzenie.
7. GTA V uruchomi się z modem wieloosobowym alt:V i połączy z Twoim serwerem.

Przez bezpośrednie połączenie

1. W launcherze alt:V wybierz Direct Connect.
2. Wprowadź adres IP i port swojego serwera w formacie IP:PORT (np. 192.168.1.1:7788).
3. Kliknij Connect.

Aby znaleźć adres IP i port swojego serwera, zobacz Jak znaleźć IP i port swojego serwera.

Maksymalna liczba graczy i wydajność

Serwery alt:V mogą obsługiwać dużą liczbę graczy, ale wydajność zależy w dużej mierze od Twoich zasobów i planu serwera:

• 32–128 graczy: Typowy zakres dla większości serwerów. Proste tryby gry działają płynnie przy wyższej liczbie.
• 128–512+ graczy: Możliwe dla zoptymalizowanych serwerów z wydajnymi zasobami. Wymaga więcej CPU i RAM.
• Wydajność zasobów: Słabo zoptymalizowane skrypty są główną przyczyną problemów z wydajnością. Skrypty po stronie serwera, które uruchamiają ciężkie operacje na każde tyknięcie lub utrzymują duże struktury danych w pamięci, mogą tworzyć wąskie gardło serwera.
• Zapytania do bazy danych: Tryby gry korzystające z baz danych (MySQL, MongoDB) powinny używać zapytań asynchronicznych, aby uniknąć blokowania głównego wątku.

Powiązane artykuły

• Konfiguracja administratora i zasobów alt:V — Rozwój zasobów, konfiguracja bazy danych, narzędzia administracyjne i rozwiązywanie problemów
• Jak znaleźć IP i port swojego serwera
• Jak przesyłać pliki przez SFTP
• Przewodnik uruchamiania serwera — Ogólny przewodnik dotyczący uruchamiania dowolnego serwera gry na Legion Hosting

Potrzebujesz więcej pomocy?

Jeśli doświadczasz problemów nieopisanych w tym przewodniku, nasz zespół pomocy technicznej jest dostępny, aby pomóc. Otwórz zgłoszenie pod adresem legionhosting.net/submitticket.php, podając szczegóły swojego serwera i opis problemu.