Przestarzałe artefakty serwera FiveM: jak bezpiecznie zaktualizować FXServer

txAdmin pokazuje ostrzeżenie, że artefakty serwera są przestarzałe, lub zasób prosi o nowszy build niż ten, który uruchamiasz. Naprawka to zastąpienie programu FXServer bieżącą kompilacją. Trwa pięć minut, jeśli trzymasz dane oddzielnie od niego i to jak się go robi.

#Co to są artefakty

„Artefakty" to binaria FXServer: program, który uruchamia Twój serwer. Nie są Twoje zasoby i nie Twoja konfiguracja. Typowy układ wygląda tak:

FXServer/
  server/          <- artifacts (FXServer.exe or run.sh and its files)
  server-data/     <- your server.cfg and resources
  txData/          <- txAdmin data and profiles

Aktualizacja oznacza zastąpienie tego, co jest w folderze artefaktów. Nie dotykasz pozostałych dwóch. Jeśli Twoje foldery są zmieszane razem, wybierz co jest czym, zanim cokolwiek zastąpisz: folder artefaktów to ten zawierający FXServer.exe na Windows lub run.sh na Linux.

#Rekomendowane czy najnowsze

Strony pobierania oznaczają dwie kompilacje blisko góry:

• Recommended: kompilacja, którą Cfx.re uważa za stabilną. Wybierz to dla serwera live.
• Latest: najnowsza kompilacja. Ma najnowsze naprawki i funkcje oraz wyższą szansę na nowe błędy.

Jeśli txAdmin powie Ci, że konkretny numer kompilacji jest potrzebny i rekomendowany jest starszy, weź nowszą kompilację z listy. Nie skaczmy do najnowszej tylko dlatego, że jest najnowsza.

#Gdzie pobrać

Kompilacje są hostowane przez Cfx.re na runtime.fivem.net:

• Windows: https://runtime.fivem.net/artifacts/fivem/build_server_windows/master/
• Linux: https://runtime.fivem.net/artifacts/fivem/build_proot_linux/master/

Pobieraj z tych stron tylko. Nie bierz kompilacji serwera z postu na forum, pliku Discord lub witryny trzeciej strony.

Na Windows otrzymujesz archiwum server.7z, które otwierasz za pomocą 7-Zip. Na Linux otrzymujesz archiwum fx.tar.xz.

#Utwórz kopię zapasową najpierw

Zanim cokolwiek zastąpisz, skopiuj:

1. Bieżący folder artefaktów (cały folder server).
2. Twój folder server-data, lub przynajmniej server.cfg i resources.
3. Folder txData.
4. Zrzut Twojej bazy danych, jeśli masz. Użyj swojego zwyczajowego narzędzia, lub mysqldump na maszynie.

Jeśli nowa kompilacja się źle zachowuje, możesz wstawić stary folder z powrotem i działać ponownie w minutę.

Ostrzeżenie: zatrzymaj serwer i txAdmin całkowicie przed zastąpieniem plików. Nadpisanie FXServer podczas jego działania zawodzi na Windows i na Linux pozostawia zepsutą mieszankę starych i nowych plików.

#Aktualizacja na Windows

1. Zatrzymaj serwer i zamknij txAdmin.
2. Pobierz server.7z kompilacji, którą chcesz.
3. Zmień nazwę starego folderu artefaktów, na przykład na server_old.
4. Utwórz nowy folder server i rozpakuj archiwum do niego.
5. Uruchom FXServer.exe w taki sam sposób jak przedtem, z tej samej lokalizacji i z tym samym skrótem lub argumentami.

txAdmin znajduje txData według ścieżki, którą mu dałeś, i nie zmieniłeś jej, więc Twój profil, ustawienia i administratorzy są nadal tam.

#Aktualizacja na Linux

sudo systemctl stop fivem        # or stop the screen session

cd ~/fivem
mv server server_old
mkdir server && cd server

wget https://runtime.fivem.net/artifacts/fivem/build_proot_linux/master/<build>/fx.tar.xz
tar xf fx.tar.xz
rm fx.tar.xz

Zastąp <build> nazwą folderu, którą kopiujesz ze strony pobierania. Uruchom serwer ponownie za pomocą zwyczajowego polecenia lub usługi. Jeśli tego jeszcze nie ustawiłeś, zobacz uruchomienie FiveM serwera na Linux.

#Sprawdź, czy to zadziałało

Przy starcie konsola drukuje wersję FXServer. Porównaj ją z numerem kompilacji na stronie pobierania. txAdmin również pokazuje wersję na swoim pulpicie i ostrzeżenie o uaktualnieniu powinno zniknąć.

Jeśli coś się złamie po aktualizacji:

• Zasoby nie uruchamiają się: przeczytaj pierwszy błąd w konsoli. Zasób, który zależał od starego zachowania, może potrzebować aktualizacji. Zobacz couldn't start resource.
• Serwer w ogóle się nie uruchomi: wstaw stary folder server_old z powrotem, uruchom go i zgłoś numer kompilacji, który nie powiódł się.
• Nowe ostrzeżenie o build'zie gry: to inne ustawienie, zobacz sv_enforceGameBuild i DLC.

#Jak często aktualizować

Nie musisz ścigać każdej kompilacji. Rozumna zasada: aktualizuj, gdy txAdmin cię ostrzega, gdy zasób potrzebuje nowszej kompilacji, lub gdy trafisz na błąd, który nowsza kompilacja naprawia. Zawsze najpierw przetestuj aktualizację na kopii serwera, jeśli uruchamiasz płatne lub zajęte serwery i zrób to, gdy niewielu ludzi jest online.

#Lista kontrolna