GameHosting.pl

Notatki operatora

FiveM: Server Artifact Version Is Outdated, jak naprawić błąd

Błąd Server Artifact Version Is Outdated oznacza, że serwer uruchamia stare albo niewspierane pliki FXServer. Zaktualizuj artifacts na maszynie serwera, wybierając właściwą platformę i system. Poniżej są osobne kroki dla Windows i Linux oraz sposób zachowania danych, txAdmin i możliwości rollbacku. Reinstalacja klienta FiveM przez gracza nie aktualizuje serwera.

Opublikowano · około 10 min czytania

Szybka naprawa: zatrzymaj FXServer, pobierz bieżący Recommended artifact dla właściwego systemu, rozpakuj go do osobnego katalogu runtime i uruchom tę wersję. Nie nadpisuj server-data, bazy ani plików txAdmin. Szare EOS zwykle pozwala jeszcze wejść; czerwone EOL może blokować połączenie, więc aktualizacja należy do administratora.

Co znaczy komunikat o outdated artifacts

Artifact to paczka plików binarnych potrzebnych do uruchomienia serwera FiveM albo RedM. To nie jest zasób RP, framework ESX lub QBCore ani plik z konfiguracją twojej społeczności. Gdy w konsoli lub liście serwerów pojawia się informacja, że wersja artifacts jest outdated, problem dotyczy runtime serwera. Najczęściej rozwiązaniem jest pobranie nowszej paczki i aktualizacja jej w instalacji FXServer.

Cfx rozróżnia ostrzeżenie EOS, czyli end of support, oraz EOL, czyli end of life. Szare ostrzeżenie EOS informuje o końcu wsparcia dla aktualnie używanych artifacts, ale samo w sobie nie uniemożliwia wejścia. Czerwone EOL może oznaczać, że połączenie już nie działa i serwer musi zostać zaktualizowany przez właściciela. Nie warto czekać do momentu, w którym gracze zgłaszają, że przestali widzieć serwer.

Okno wsparcia liczy się względem kolejnych wydań, a nie od daty instalacji. Cfx podaje osobne okresy dla Recommended i Latest, a artifacts bez wsparcia starsze niż trzy miesiące mogą przestać być dołączalne przez przeglądarkę serwerów. Sprawdź bieżący komunikat EOS/EOL i numer widoczny przy aktualnym pobraniu, zamiast kopiować build z archiwalnego poradnika.

Jeśli jesteś graczem, a nie administratorem, nie usuwaj cache gry i nie reinstaluj klienta w ciemno. Szara informacja oznacza, że serwer może nadal działać, a czerwony błąd powinien trafić do właściciela. Prześlij administratorowi dokładny tekst komunikatu, nazwę serwera i godzinę próby. To pomaga odróżnić przestarzały artifact od awarii łącza albo problemu z pojedynczym zasobem.

Sprawdź, którą instalację aktualizujesz

Wiele serwerów ma dwa różne katalogi: katalog runtime FXServer oraz katalog danych serwera. Pierwszy zawiera pobrane pliki artifacts i plik uruchomieniowy. Drugi zwykle zawiera server.cfg, resources, zasoby frameworka, klucz licencyjny oraz dane txAdmin. Aktualizacja artifacts dotyka przede wszystkim runtime. Jeśli rozpakujesz nową paczkę do złego folderu albo skasujesz katalog danych, możesz stracić konfigurację lub przerwać start zasobów.

Przed zmianą sprawdź ścieżkę polecenia startowego albo usługi systemowej. W Windowsie może to być plik BAT, zadanie harmonogramu lub panel txAdmin. W Linuksie serwer może być uruchamiany przez skrypt powłoki, usługę systemd lub panel. Zapisz lokalizację bieżącego runtime, lokalizację danych i sposób uruchamiania. Nie polegaj wyłącznie na nazwie folderu, bo kilka testowych instalacji może leżeć obok siebie.

Jeśli używasz txAdmin, sprawdź profil serwera oraz przypisane ścieżki. Panel pomaga zarządzać procesem i danymi, ale nie oznacza, że wolno nadpisywać każdy katalog w jego folderze. Procedura zależy od tego, czy runtime został zainstalowany ręcznie, przez recipe czy przez panel hostingu. Zasada pozostaje taka sama: aktualizuj właściwe pliki FXServer, a dane społeczności pozostaw bez zmian.

Warto mieć prostą notatkę wdrożeniową: system operacyjny, ścieżka runtime, ścieżka server-data, aktualny numer artifacts, wybrana gałąź, godzina ostatniego backupu oraz osoba, która może cofnąć zmianę. Taka karta usuwa zgadywanie przy aktualizacji po kilku miesiącach, gdy pierwotny administrator nie pamięta już, jak został ustawiony serwer.

Wybierz właściwy artifact i gałąź

Pobieraj pliki z oficjalnej strony pobierania artifacts Cfx, a nie z archiwum z komentarza lub filmu. Selektor pozwala wybrać platformę FiveM / RedM albo FiveM dla GTA V Enhanced, system Windows lub Linux oraz branch Recommended lub Latest. Dla działającego serwera RP wybór gałęzi powinien wynikać z kompatybilności zasobów i planu utrzymania. Nie zmieniaj jednocześnie branchu, systemu operacyjnego i frameworka, bo trudniej będzie znaleźć przyczynę problemu.

Recommended jest wyborem dla administratora, który chce dłuższego okna wsparcia i spokojnego wdrożenia. Latest daje nowsze wydanie, ale według bieżących reguł jego okres wsparcia po następnym wydaniu jest krótszy. To nie jest wybór „dobry” kontra „zły”. Ważne jest, by serwer nie pozostawał bez aktualizacji i by sprawdzić zachowanie własnych zasobów przed godziną największego ruchu.

Nie wybieraj pakietu Enhanced tylko dlatego, że nazwa wygląda na nowszą. To osobny wariant platformy serwerowej. Upewnij się, że odpowiada twojemu środowisku i planowi kompatybilności klientów. Jeśli aktualizujesz klasyczny serwer FiveM, pobierz jego właściwy artifact dla tego systemu operacyjnego. W razie wątpliwości porównaj wybrany produkt i platformę z opisem w panelu pobierania Cfx, zamiast polegać na numerze builda znalezionym w poradniku.

Wybierz branch i pobierz archiwum przed wyłączeniem serwera. Sprawdź, czy plik jest kompletny i czy system ma miejsce na rozpakowanie tymczasowej kopii. Gdy masz już paczkę, możesz wykonać właściwą aktualizację w zaplanowanym oknie serwisowym, z możliwością szybkiego powrotu do starego runtime.

Aktualizacja artifacts na Windows i Linux

SystemArchiwum dla FiveM LegacyCo zrobić
Windowsserver.7zRozpakuj zawartość do nowego katalogu runtime. Standardowy program uruchomieniowy to FXServer.exe.
Linuxfx.tar.xzRozpakuj archiwum do nowego katalogu runtime i uruchamiaj serwer z dostarczonego run.sh.

Jeśli wybrałeś wariant GTA V Enhanced, nazwy archiwów są inne: Cfx używa między innymi cfx-server_win_x64 dla Windows oraz cfx-server-linux_x64 dla Linux. Nie mieszaj plików Legacy i Enhanced w jednym katalogu. Nazwa pobranego archiwum i wybrany wariant w selektorze muszą się zgadzać.

Przykładowy układ katalogów

C:\FXServer\runtime-current\   pliki artifacts uruchomionej wersji
C:\FXServer\runtime-next\      nowy artifact przed przełączeniem
C:\FXServer\server-data\       server.cfg, resources i dane społeczności
~/FXServer/server-current/       pliki artifacts uruchomionej wersji
~/FXServer/server-next/          nowy artifact przed przełączeniem
~/FXServer/server-data/          server.cfg, resources i dane społeczności

Na Linux utwórz katalog docelowy i rozpakuj standardowe archiwum tak:

mkdir -p ~/FXServer/server-next
tar xf fx.tar.xz -C ~/FXServer/server-next

Po rozpakowaniu sprawdź, czy nowe pliki zawierają oczekiwany program uruchomieniowy. Skonfiguruj usługę, skrypt albo panel tak, aby startował z nowego katalogu. Przed przełączeniem zapisz poprzednią ścieżkę, wybrany branch i numer buildu pokazany na stronie pobierania. Po restarcie potwierdź w logu startowym, że proces uruchomił się z nowej ścieżki, a potem sprawdź status serwera i wykonaj próbne połączenie.

txAdmin jest dostarczany razem z FXServer w aktualnych buildach, więc zwykła aktualizacja artifacts aktualizuje także jego część serwerową. Nie pobieraj osobnego archiwum txAdmin. Zachowaj katalog danych panelu, profile i bazę, a po uruchomieniu sprawdź, czy txAdmin monitoruje właściwy proces FXServer.

Bezpieczna aktualizacja krok po kroku

  1. Zapowiedz restart. Poinformuj graczy o krótkiej przerwie i ustaw czas poza godziną wydarzenia. Jeśli serwer ma kolejkę, wyłącz przyjmowanie nowych połączeń na czas zamknięcia.
  2. Zrób kopię danych. Skopiuj server.cfg, katalog resources, dane txAdmin, pliki frameworka i bazę danych, jeśli jest przechowywana osobno. Nie zakładaj, że backup całego runtime zabezpiecza bazę lub pliki poza katalogiem.
  3. Zapisz aktualny runtime. Zachowaj dotychczasowy katalog artifacts albo przygotuj jego kopię pod nazwą z datą. Dzięki temu powrót nie będzie polegał na ponownym szukaniu starego pliku.
  4. Zatrzymaj serwer poprawnie. Użyj konsoli txAdmin, panelu usługi albo polecenia zatrzymania używanego w twojej instalacji. Poczekaj, aż proces FXServer zakończy pracę i zamknie pliki.
  5. Rozpakuj właściwe archiwum osobno. Na Windows użyj server.7z, a na Linux fx.tar.xz dla FiveM Legacy. Upewnij się, że zawartość odpowiada systemowi i branchowi wybranemu w selektorze Cfx.
  6. Przełącz runtime, zachowując dane. Skieruj usługę albo panel na nowy katalog plików FXServer. Nie kasuj server-data, zasobów, konfiguracji, bazy ani katalogu txData. Jeśli ścieżki nie są jasne, sprawdź polecenie startowe i profil txAdmin przed zmianą.
  7. Uruchom serwer i obserwuj konsolę. Sprawdź, czy proces startuje, czy panel txAdmin widzi instancję oraz czy nie pojawiają się błędy odczytu konfiguracji albo uruchamiania zasobów.
  8. Wykonaj test połączenia. Dołącz kontem testowym, sprawdź logowanie, podstawowe zasoby, zapis danych i konsolę. Dopiero potem poinformuj graczy, że przerwa się zakończyła.
  9. Zachowaj poprzednią wersję przez okres obserwacji. Nie usuwaj kopii runtime natychmiast po pierwszym starcie. Jeśli nowa paczka powoduje regresję, łatwiej wrócić do znanego stanu, gdy masz cały poprzedni katalog.

Nie podmieniaj plików, gdy proces FXServer nadal działa. Może to zostawić mieszankę starych i nowych bibliotek albo spowodować, że pliki zostaną zablokowane przez system. Nie nadpisuj też backupu przed potwierdzeniem, że ostatnia kopia jest czytelna. Najpierw wykonaj test uruchomienia, potem dopiero porządkuj stare katalogi.

Jeśli korzystasz z panelu hostingowego, zwykle runtime aktualizuje się z poziomu funkcji aktualizacji albo przez wymianę paczki w odpowiednim katalogu. Nazwy menu są zależne od panelu, dlatego nie stosuj poleceń przeznaczonych dla innego środowiska. Możesz wykorzystać poniższą listę kontrolną, ale wykonuj ją narzędziami, które faktycznie uruchamiają twoją instancję.

Jak sprawdzić, czy aktualizacja zadziałała

Sam brak czerwonego komunikatu nie wystarcza. Po starcie sprawdź log startowy, aby potwierdzić, że uruchomił się nowy runtime z nowej ścieżki, a nie stary proces lub folder. Porównaj numer buildu zanotowany z selektora pobierania, sprawdź status w txAdmin i wykonaj próbne połączenie. Następnie sprawdź logi zasobów na koncie bez uprawnień administratora, aby test odzwierciedlał zwykłe wejście gracza.

Sprawdź kilka funkcji, które przechodzą przez różne warstwy: wejście na serwer, załadowanie postaci, zapis postępu, komunikację z bazą i najważniejszy skrypt społeczności. Jeśli uruchamiają się tylko podstawowe zasoby, ale baza nie przyjmuje zapisu, wdrożenie nie jest zakończone. Zapisz godzinę startu i branch artifacts, by następna osoba wiedziała, co dokładnie zostało wdrożone.

Jeżeli pojawia się ten sam komunikat, sprawdź, czy usługa, skrypt lub profil txAdmin wskazuje nowy katalog runtime. Samo rozpakowanie archiwum do innego folderu nie zmienia procesu, który uruchamia panel. Zatrzymaj serwer, popraw ścieżkę startową i uruchom właściwą instancję ponownie.

Jeżeli nowy runtime uruchamia się, ale gracze nadal nie mogą dołączyć, zbierz dokładny błąd, log serwera i informację, czy dotyczy wszystkich osób. Wtedy można odróżnić nieaktualne artifacts od problemu sieci, klucza, bazy danych, zasobu lub różnicy platformy klienta. Nie zaczynaj od reinstalacji całego GTA V, jeśli problem jest wyświetlany jako wersja serwerowych artifacts.

Typowe błędy przy aktualizacji

Nowe pliki są w katalogu, ale numer wersji się nie zmienił

Najpierw znajdź rzeczywistą komendę startową. Być może kopiujesz do innego katalogu niż używa usługa. Sprawdź skrót, plik BAT, skrypt startowy, panel txAdmin albo konfigurację systemd. Upewnij się, że proces został zatrzymany przed wymianą plików i uruchomiony ponownie po niej.

Serwer nie startuje po podmianie

Przywróć kopię runtime, sprawdź kompletność archiwum i porównaj wybrany system z systemem hosta. Nie usuwaj danych serwera. Jeśli przywrócenie starego runtime przywraca działanie, zachowaj logi nieudanej próby i przetestuj nową paczkę na kopii środowiska albo w oknie serwisowym, zanim ponowisz wdrożenie.

TxAdmin otwiera się, ale nie widzi instancji

Panel może działać niezależnie od procesu serwera. Sprawdź, czy serwer wystartował z tym samym profilem, portem i katalogiem danych, którego oczekuje txAdmin. Upewnij się też, że nie uruchomiłeś dwóch kopii FXServer jednocześnie. Dodatkowa instancja może blokować port albo panel może monitorować niewłaściwy PID.

Aktualizacja artifacts zepsuła resource

Oddziel błąd runtime od błędu konkretnego zasobu. Sprawdź log startu, wyłącz tylko zasób, którego komunikat wskazuje na problem, i wykonaj test na kopii. Nie aktualizuj frameworka i całej kolekcji skryptów w tym samym oknie, jeśli chcesz ustalić przyczynę. Przywróć poprzedni runtime, jeżeli wymagana funkcja nie działa i nie masz gotowej poprawki zasobu.

Gracz widzi ostrzeżenie EOS, ale może wejść

To zgodne z opisem Cfx. EOS jest ostrzeżeniem końca wsparcia i serwer może być nadal osiągalny. Zaplanuj aktualizację w dogodnym terminie, zamiast wysyłać graczy do reinstalacji klienta. Nie czekaj jednak, aż ostrzeżenie zmieni się w EOL.

Jeśli jesteś graczem

Gdy podczas łączenia pojawia się ostrzeżenie EOS albo EOL, zanotuj dokładny kolor i treść. W przypadku szarego EOS spróbuj wejść, jeśli przycisk połączenia jest aktywny. Gdy czerwony EOL blokuje połączenie, napisz administratorowi, że dokumentacja Cfx przypisuje aktualizację artifacts właścicielowi serwera. Nie pobieraj plików runtime i nie próbuj modyfikować instalacji serwera na swoim komputerze.

Jeśli komunikat pojawia się tylko przy jednym serwerze, a inne działają, to kolejny sygnał, że problem jest po stronie tej instancji. Jeśli wszystkie serwery sprawiają kłopot, dopiero wtedy sprawdź stan klienta i sieci. Rozdzielenie tych przypadków oszczędza czas i zmniejsza ryzyko usunięcia lokalnych plików bez związku z problemem.

Właściciel może przekazać społeczności krótką informację: aktualizujemy artifacts, serwer będzie niedostępny przez zaplanowany czas, a postęp i zasoby pozostają w katalogu danych. Po restarcie poproś dwie osoby o test, zanim ogłosisz pełny powrót. To prosta procedura, która ogranicza chaos na Discordzie i pozwala wychwycić problem zanim wrócą wszyscy gracze.

Najczęstsze pytania

Czy błąd outdated artifacts naprawię reinstalacją FiveM? Zwykle nie. Komunikat dotyczy plików serwera FXServer, więc zaktualizować je musi operator. Reinstalacja klienta nie zmieni wersji runtime na serwerze.

Czy muszę zawsze wybierać Latest? Nie. Cfx udostępnia gałąź Recommended i Latest. Wybierz ją zgodnie z kompatybilnością zasobów, wymaganym wsparciem i planem wdrożenia, a potem testuj serwer po aktualizacji.

Czy EOS oznacza, że serwer jest wyłączony? Nie. Według dokumentacji szare EOS samo w sobie nie blokuje dołączenia. Czerwone EOL może już uniemożliwiać połączenie.

Czy aktualizacja kasuje zasoby RP? Sama wymiana runtime nie powinna wymagać kasowania katalogu z zasobami. Zachowaj server-data, konfigurację, dane txAdmin i bazę. Zrób kopię przed podmianą i sprawdź, do którego folderu wskazuje polecenie startowe.

Jak często aktualizować artifacts? Sprawdzaj wydania i ostrzeżenia Cfx regularnie, a nową paczkę instaluj w kontrolowanym oknie. Okresy wsparcia zależą od kolejnych wydań, więc nie opieraj procedury na stałej liczbie dni od daty instalacji.

Powiązane poradniki