Artefakty FiveM wyjaśnione

1. Czym jest artefakt FiveM

Cfx.re publikuje nowe buildy FXServer kilka razy w tygodniu na runtime.fivem.net, numerowane rosnąco. Każdy build to kompletny pakiet serwera: pliki binarne FXServer, środowisko Citizen i dołączony txAdmin. Twoje zasoby, server.cfg i baza danych nie są jego częścią; zostają na miejscu, gdy zmieniasz builda.

Numer builda sprawdzają lista serwerów i klient gry. Gdy Cfx.re wydaje aktualizację klienta wymagającą nowszego serwera, serwery na starszych buildach przestają przyjmować nowych graczy, dopóki się nie zaktualizują. Dlatego aktualizacja artefaktów to najczęstsze zadanie konserwacyjne na serwerze FiveM.

2. Recommended, latest czy konkretny build?

Cfx.re oznacza jeden build jako Recommended: ten, który jest dostępny wystarczająco długo, by mu zaufać. Build Latest to najnowszy opublikowany, czasem sprzed kilku godzin. Dla publicznego serwera roleplay Recommended jest bezpiecznym wyborem; Latest bierz tylko wtedy, gdy wymaga tego aktualizacja klienta albo gdy wpis w changelogu naprawia problem, który masz.

Starsze buildy pozostają dostępne, więc możesz też przypiąć konkretny numer, na przykład gdy zasób, od którego zależysz, psuje się na nowszym buildzie. Changelog na changelogs.fivem.net pokazuje, co zmieniło się między buildami, i oznacza te krytyczne (critical).

3. Sprawdź, na jakim buildzie działa twój serwer

Otwórz stronę logowania txAdmin swojego serwera: stopka pokazuje dwie wersje, na przykład tx: v8.1.1 | fx: b i numer. Ten numer fx to twój artefakt i nie musisz się nawet logować, żeby go odczytać. Konsola serwera wypisuje ten sam numer zaraz po starcie.

4. Aktualizacja na serwerze VibeGAMES (jedno kliknięcie)

W panelu gry otwórz swój serwer i kliknij Artifacts Updater w sekcji Game Server. Lista pokazuje buildy z runtime.fivem.net, z etykietą Recommended przy tym, który poleca Cfx.re, i etykietą Optional przy najnowszym; pole wyszukiwania znajdzie konkretny numer.

Wybierz build i naciśnij Install. Panel zatrzymuje serwer, pobiera build bezpośrednio z Cfx.re i uruchamia serwer ponownie; strona Console pokazuje, kiedy wrócił. Twoje zasoby, server.cfg, dane txAdmin i baza danych pozostają nietknięte. Jeśli przeskakujesz wiele buildów naraz, zrób najpierw kopię zapasową.

Serwery przełączone na FiveM for GTAV Enhanced zawsze automatycznie działają na najnowszym buildzie, więc tam aktualizator jest tylko do odczytu; wróć na stronie GTAV Enhanced, jeśli musisz przypiąć build.

5. Ręczna aktualizacja na VPS lub serwerze dedykowanym

Zatrzymaj serwer. Pobierz wybrany build z runtime.fivem.net (fx.tar.xz dla Linuksa, server.7z dla Windows), rozpakuj go do nowego folderu obok starego i skieruj polecenie startowe lub run.sh na nowy folder. Twój folder server-data z zasobami, server.cfg i cache zostaje tam, gdzie jest.

Uruchom serwer i obserwuj w konsoli numer builda oraz linię informującą, że uwierzytelnienie klucza licencyjnego się powiodło. Zachowaj stary folder, dopóki nie masz pewności, że wszystko działa; cofnięcie zmian to wtedy tylko przestawienie polecenia startowego z powrotem.

6. Gdy aktualizacja coś psuje

Serwer, który po aktualizacji przestaje się uruchamiać, to zwykle zasób korzystający z API usuniętego w nowym buildzie albo profil txAdmin wymagający resetu. Znajdź w konsoli pierwszą czerwoną linię, wyłącz wskazany w niej zasób i spróbuj ponownie. Jeśli to nie pomoże, zainstaluj ponownie build Recommended; obniżenie wersji jest tak samo bezpieczne jak podniesienie.

Autorzy zasobów publikują uwagi o zgodności na forum Cfx.re i na stronach wydań, więc po dużym skoku warto w tej samej sesji zaktualizować największe zasoby (framework, ekwipunek, anti-cheat).

7. Jak często aktualizować?

Raz na kilka tygodni wystarczy większości serwerów, plus za każdym razem, gdy aktualizacja klienta uniemożliwia graczom połączenie. Obserwuj w changelogu buildy oznaczone jako critical: usuwają problemy z bezpieczeństwem lub stabilnością i warto je instalować od razu. W VibeGAMES aktualizacja to jedno kliknięcie i około minuty przestoju, więc nie ma powodu zostawać rok w tyle.