Jak skonfigurować serwer FiveM Enhanced (GTA V Enhanced)

FiveM Enhanced to wczesna wersja FiveM od Cfx.re dla GTA V Enhanced, nowszej edycji gry na PC, a ten poradnik prowadzi nowy serwer FiveM Enhanced w DoomHosting od pierwszego uruchomienia do działającej konfiguracji. Wybierz Enhanced, jeśli Twoja społeczność gra już w GTA V Enhanced, a skrypty mają otwarty kod. Zostań przy FiveM Legacy, jeśli korzystasz z zaszyfrowanych zasobów albo grają u Ciebie osoby ze starszą edycją gry, bo obie wersje nigdy nie dzielą graczy.

Enhanced czy Legacy: która wersja pasuje do Ciebie?

Enhanced i Legacy to osobne produkty z osobnymi klientami i osobnym oprogramowaniem serwera. Na serwer Enhanced wejdą tylko gracze z klientem FiveM for GTAV Enhanced, a na serwer Legacy tylko ci z klasycznym. Zanim się zdecydujesz, zwróć uwagę na ograniczenia wczesnego dostępu:

• Brak Asset Escrow. Zaszyfrowane zasoby kupione przez Tebex nie załadują się na Enhanced. Zasoby z otwartym kodem działają normalnie.
• OneSync jest zawsze włączony, w trybie big, a synchronizacja klient-serwer zastępuje dawny model peer-to-peer.
• Tryb pure jest zawsze włączony, więc w czasie wczesnego dostępu nie użyjesz modów graficznych.
• Obsługiwany jest tylko najnowszy gamebuild.

Jeśli to pasuje do Twojego projektu, zamów serwer FiveM Enhanced. Kosztuje tyle samo co Legacy, a wszystko poniżej robisz w naszym panelu serwera.

Pierwsze uruchomienie: dodaj klucz licencyjny

Enhanced wymaga tego samego darmowego klucza licencyjnego Cfx.re co Legacy. Jeśli jeszcze go nie masz, poradnik o kluczu licencyjnym opisuje, jak go utworzyć na portal.cfx.re.

Kliknij Start na nowym serwerze. Ponieważ klucz nie jest jeszcze zapisany, pojawi się okno Add your FiveM license key. Wklej klucz (zaczyna się od cfxk_ i ma 33 znaki), a potem kliknij Save and start. Panel zapisze go i od razu uruchomi serwer.

Ustawienia w zakładce Startup

Zakładka Startup zawiera wartości, które serwer odczytuje przy starcie:

• fivem license: klucz, który przed chwilą zapisałeś. Jeśli kiedyś wygenerujesz go ponownie, podmień go tutaj.
• Max Players: liczba miejsc dla graczy na serwerze.
• Server Hostname: nazwa widoczna na liście serwerów FiveM.
• Steam Web Api Key: zostaw none, chyba że któryś zasób sprawdza graczy na Steamie.
• Enable txadmin: włącza i wyłącza txAdmin.
• txAdmin Port: tylko do odczytu. Panel sam przydziela ten drugi port dla interfejsu WWW txAdmin.

Zmiany w tej zakładce zadziałają po następnym restarcie.

txAdmin włączony lub wyłączony

Domyślnie serwer startuje prosto z server.cfg. Kliknij Enable txAdmin w nagłówku (albo użyj przełącznika w Startup), zrestartuj serwer, a przejmie go txAdmin: server.cfg przestaje być wykonywany, a ustawienia zmieniasz w interfejsie WWW txAdmin. PIN pierwszego uruchomienia, recipes i zaplanowane restarty działają tak samo jak na Legacy, więc przy nich skorzystaj z naszego poradnika o txAdmin.

Zakładka Network pokazuje oba porty. Główny to port gry, z którym łączą się gracze, a ten z plakietką txAdmin służy do interfejsu WWW.

Zakładka Config i server.cfg

Gdy txAdmin jest wyłączony, zakładka Config pozwala edytować wpis serwera bez otwierania pliku: Project name, Project description, Tags, Locale i Allow ScriptHook. Nazwy serwera i liczby miejsc celowo tu nie ma. Obie wartości pochodzą ze Startup i przy każdym starcie trafiają do server.cfg, więc ręczna zmiana zostałaby nadpisana.

Wszystkie pozostałe ustawienia są w server.cfg w katalogu głównym serwera, który otworzysz w zakładce Files. Menedżer plików pokazuje też folder alpine, w którym leży binarka cfx-server (odpowiednik z Legacy to FXServer), oraz resources, czyli miejsce na skrypty i mapy.

Skrypty zapisujące dane potrzebują bazy MySQL. Utwórz ją w zakładce Databases i podłącz według naszego poradnika o bazie danych; na Enhanced nic się tu nie zmienia.

Przenoszenie zasobów z Legacy

Większość skryptów open source działa bez zmian, ale kilka zmian w Enhanced potrafi zaskoczyć starsze konfiguracje. Przejdź przez tę listę, zanim skopiujesz serwer z Legacy:

• Zaszyfrowane zasoby pozostają zablokowane, dopóki Cfx.re nie wprowadzi Asset Escrow dla Enhanced. Poproś autora o wersję bez szyfrowania albo zostaw ten projekt na Legacy.
• Zasoby streamowane (pojazdy, mapy, ubrania) trzeba przekonwertować narzędziem Alchemist od Cfx.re. Umieść przekonwertowane pliki w folderze stream_enhanced obok istniejącego stream. Enhanced ładuje stream_enhanced zamiast stream, więc jeden zasób może obsłużyć obie wersje.
• Dane KVP trzeba zmigrować przez kvdb-migrator, inaczej zapisane dane klucz-wartość będą puste.
• Server ID graczy są używane ponownie po rozłączeniu gracza. Sprawdź każdy skrypt, który zapamiętuje ID, żeby odróżniać graczy.
• Callbacki NUI domyślnie działają w trybie strict. Zasób, który przez to przestaje działać, może z niego zrezygnować w swoim fxmanifest.lua:

nui_callback_strict_mode 'false'

• Zasoby w C# działają teraz na .NET 10 zamiast Mono, więc przetestuj je przed uruchomieniem dla graczy.
• Endpointy: endpoint_add_tcp i endpoint_add_udp przyjmują po jednym endpoincie.
• Tryb deweloperski wymaga sv_devMode true w server.cfg.
• Podstawowa gra bez DLC: ustaw sv_enforceGameBuild 1.

Aktualizacja serwera

Cfx.re publikuje jeden aktualny build Enhanced, więc nie ma wyboru wersji, jaki mają serwery Legacy. Aby dostać najnowszy build, otwórz zakładkę Settings i kliknij Reinstall server: reinstalacja pobiera oprogramowanie serwera od nowa i zachowuje twoje pliki (resources, server.cfg, txData), o ile nie zaznaczysz pola wipe. Mimo to warto najpierw zrobić kopię w zakładce Backups.

Częste problemy

Command not found (sv_endpointprivacy): ta komenda nie istnieje na Enhanced. Usuń tę linię z server.cfg i zrestartuj serwer.

An escrowed resource fails to load: Asset Escrow nie jest jeszcze dostępny na Enhanced. Zamień zasób na odpowiednik open source albo uruchom go na serwerze Legacy.

Legacy players cannot connect: osoba z klasycznym FiveM nigdy nie wejdzie na serwer Enhanced. Potrzebuje GTA V Enhanced i klienta FiveM for GTAV Enhanced, jak opisano w poradniku jak dołączyć do serwera FiveM Enhanced.

"A valid license check is required to run this server": zapisany klucz jest pusty, źle wpisany albo nieważny. Otwórz Startup, wklej klucz do fivem license bez spacji wokół i uruchom serwer ponownie.

Edits to server.cfg change nothing: txAdmin jest włączony, a on nie wykonuje server.cfg. Zmień ustawienie w txAdmin albo wyłącz txAdmin i zrestartuj serwer.