Artefakty to sam program serwera FiveM (FXServer). Stare artefakty przestają być wspierane, a w końcu gracze nie mogą dołączyć do serwera z listy serwerów. Pokażemy, kiedy i jak aktualizować serwer oraz jak wrócić do poprzedniej wersji, gdy nowa nie działa.
Czego potrzebujesz
- Serwer FiveM w StormHost (lub własny serwer FiveM na VPS)
- Wolny slot kopii zapasowej (kopie zapasowe serwerów gier)
- Około 10 minut
Czym są artefakty#
- Artefakt to pakiet plików FXServer z numerem buildu (im wyższy, tym nowszy). Twoich danych (
server.cfg,resources, bazy danych) w nim nie ma, a aktualizacja ich nie zmienia. - txAdmin jest częścią artefaktu. Aktualizacja artefaktu aktualizuje także txAdmin.
- FiveM wydaje artefakty w dwóch kanałach:
| Kanał | Co oznacza | Dla kogo |
|---|---|---|
| Recommended | Przetestowany build, który FiveM zaleca do codziennego użytku. | Większość serwerów. |
| Latest | Najnowszy build z najnowszymi funkcjami i poprawkami, mniej przetestowany. | Gdy skrypt lub framework wymaga nowej funkcji. |
- Klasyczny FiveM (dla GTA V Legacy) i FiveM for GTAV Enhanced mają osobne artefakty. Nie mieszaj ich.
Kiedy aktualizować#
- Regularnie, co najmniej raz w miesiącu. Build z kanału Recommended jest wspierany jeszcze 6 tygodni po wydaniu następnego; build z kanału Latest tylko 2 tygodnie.
- Do artefaktów starszych niż 3 miesiące nie da się dołączyć z listy serwerów. Przy łączeniu gracze widzą szare ostrzeżenie end-of-support (EOS), a przy jeszcze starszych czerwone ostrzeżenie end-of-life (EOL), które blokuje połączenie.
- Gdy skrypt zgłasza
Native … is not supported,Error parsing scriptlubFailed to load script. Skrypt potrzebuje nowszego serwera. - Po wydaniu nowego DLC do GTA V i gdy pojawia się błąd
Client/Server game build revision mismatch.
Jak sprawdzić aktualną wersję#
- Narzędzie CFX Resolver: wpisz adres serwera z zakładki Sieć. Wiersz Artefakt pokazuje build serwera, a Wsparcie wersji jego status.
- W txAdmin: System › Diagnostics.
- Aktualne numery Recommended i Latest są na stronie Server Download (otwiera się w nowym oknie).
Aktualizacja w StormHost#
Artefakty aktualizujesz przez reinstalację serwera: skrypt instalacyjny pobiera wybraną wersję FXServer.
Reinstalacja może nadpisać pliki
Strefa klienta ostrzega przed reinstalacją: „Pliki mogą zostać nadpisane — najpierw zrób kopię zapasową.” Bez kopii zapasowej ryzykujesz utratę swoich zmian. Bazę danych zarchiwizuj osobno (poradnik).
W strefie klienta otwórz Moje usługi, kliknij swój serwer i przejdź do zakładki Kopie zapasowe.
Utwórz kopię zapasową (na przykład o nazwie
before-artifact-update) i poczekaj, aż się zakończy.Przejdź do zakładki Ustawienia.
W sekcji Zmienne znajdź zmienną wersji FiveM i ustaw ją:
Wartość Co zostanie zainstalowane recommendedAktualny build z kanału Recommended. Zalecane. latestAktualny build z kanału Latest. Konkretnego starszego buildu nie da się tu jeszcze ustawić; instalacja użyłaby zamiast tego Recommended. Wybór wersji w strefie klienta pojawi się wkrótce.
Kliknij Zapisz.
W sekcji Reinstalacja serwera kliknij Reinstaluj i potwierdź suwakiem Przesuń, aby reinstalować.
Zobaczysz
Reinstalacja trwa. Śledź ją w zakładce Konsola.Przejdź do zakładki Konsola i poczekaj na zakończenie instalacji. Następnie uruchom serwer przyciskiem Start.
Jeśli nie widzisz zmiennej wersji FiveM, skontaktuj się z nami (kontakt), a aktualizację wykonamy za Ciebie.
Na własnym VPS (Linux)#
Zatrzymaj serwer (przyciskiem stop w txAdmin albo kończąc proces).
Zarchiwizuj folder artefaktów, na przykład
~/FXServer/server, oraz folder danych serwera.Na stronie Server Download (otwiera się w nowym oknie) wybierz platformę, Linux i Recommended, i skopiuj link do pliku
fx.tar.xz.Przejdź do folderu artefaktów, a potem pobierz i rozpakuj pliki:
bash cd ~/FXServer/server wget <FX_TAR_XZ_LINK> tar xf fx.tar.xzcd ~/FXServer/server– przechodzi do folderu artefaktów (nie folderu zserver.cfg).wget <FX_TAR_XZ_LINK>– pobiera archiwum. Zamiast<FX_TAR_XZ_LINK>wstaw skopiowany link.tar xf fx.tar.xz– rozpakowuje archiwum i nadpisuje stare pliki FXServer (x= extract,f= z pliku). Wymaga pakietuxz-utils.
Usuń archiwum (
rm fx.tar.xz) i uruchom serwer tak samo jak wcześniej: z txAdmin poleceniembash ~/FXServer/server/run.sh(bez+exec); bez txAdmin z folderu zserver.cfgpoleceniembash ~/FXServer/server/run.sh +exec server.cfg.
Game build i DLC#
Artefakt (wersja serwera) i game build (wersja gry z DLC, sv_enforceGameBuild w server.cfg) to dwa różne numery. Nowe DLC do GTA V możesz wymusić tylko artefaktem, który je obsługuje. Kolejność: najpierw aktualizacja artefaktów, potem podniesienie sv_enforceGameBuild (server.cfg).
Weryfikacja#
- CFX Resolver pokazuje nowy build w wierszu Artefakt.
- Serwer startuje, txAdmin się otwiera, a zasoby uruchamiają się bez nowych błędów.
- Gracze łączą się bez ostrzeżenia EOS lub EOL.
Rozwiązywanie problemów#
Po aktualizacji serwer lub skrypty się zawieszają#
Jeśli przełączono na latest, ustaw zmienną wersji z powrotem na recommended i reinstaluj serwer. Aby wrócić do starszego buildu, przywróć kopię zapasową z kroku 2 (poradnik).
Po reinstalacji brakuje moich zmian#
Reinstalacja nadpisała pliki. Przywróć kopię zapasową bez opcji Usuń wszystkie obecne pliki przed przywróceniem albo pobierz potrzebne pliki z kopii zapasowej na komputer i prześlij je z powrotem.
Gracze zgłaszają Server artifact version is outdated#
Serwer działa na niewspieranym buildzie. Zaktualizuj do recommended zgodnie z opisem wyżej.
Native … is not supported, Error parsing script, Failed to load script#
Skrypt potrzebuje nowszego serwera. Zaktualizuj do recommended, a jeśli to nie wystarczy, do latest.
Podsumowanie
- Artefakt to program FXServer łącznie z txAdmin. Aktualizacja nie zmienia Twoich danych.
- Aktualizuj co najmniej raz w miesiącu: do artefaktów starszych niż 3 miesiące nie da się dołączyć z listy serwerów.
- W StormHost: kopia zapasowa, zmienna wersji (
recommended), Reinstaluj, obserwacja Konsoli. - Jeśli nowa wersja nie działa, wróć do
recommendedalbo przywróć kopię zapasową.