Устаревшие артефакты FiveM сервера: как безопасно обновить FXServer

txAdmin показывает предупреждение, что артефакты вашего сервера устарели, или ресурс просит более новую сборку, чем та, которую вы запускаете. Исправление - заменить программу FXServer текущей сборкой. Это займет пять минут, если вы держите свои данные отдельно от нее, и вот как это сделать.

#Что такое артефакты

"Артефакты" - это бинарные файлы FXServer: программа, которая запускает ваш сервер. Это не ваши ресурсы и не ваша конфигурация. Типичная раскладка выглядит так:

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

Обновление означает замену того, что находится в папке артефактов. Вы не касаетесь других двух. Если ваши папки смешаны вместе, выясните, что есть что перед тем, как что-либо заменить: папка артефактов - это та, которая содержит FXServer.exe в Windows или run.sh в Linux.

#Рекомендуемые или новейшие

Страницы загрузки отмечают два строения рядом вверху:

• Recommended: сборка, которую Cfx.re считает стабильной. Выберите это для живого сервера.
• Latest: новейшая сборка. Она имеет новейшие исправления и функции, и более высокий шанс новых ошибок.

Если txAdmin говорит вам, что конкретный номер сборки необходимо, и рекомендуемый старше этого, возьмите более новую сборку из списка. Не прыгайте на новейший просто потому что он новейший.

#Где загружать

Сборки размещены Cfx.re на 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/

Загружайте только с этих страниц. Не берите сборки сервера из постов форума, файлов Discord или сторонних сайтов.

В Windows вы получаете архив server.7z, который вы открываете с помощью 7-Zip. В Linux вы получаете архив fx.tar.xz.

#Создайте резервную копию сначала

Перед тем как заменить что-либо, скопируйте:

1. Текущую папку артефактов (всю папку server).
2. Вашу папку server-data или по крайней мере server.cfg и resources.
3. Папку txData.
4. Дамп вашей базы данных, если она есть. Используйте ваш обычный инструмент или mysqldump на машине.

Если новая сборка ведет себя неправильно, вы можете положить старую папку обратно и снова работать за минуту.

Внимание: остановите сервер и txAdmin полностью перед заменой файлов. Перезапись FXServer, пока он работает, не удается в Windows, и в Linux это оставляет сломанную смесь старых и новых файлов.

#Обновление на Windows

1. Остановите сервер и закройте txAdmin.
2. Загрузите server.7z сборки, которую вы хотите.
3. Переименуйте старую папку артефактов, например на server_old.
4. Создайте новую папку server и извлеките в нее архив.
5. Запустите FXServer.exe так, как вы это делали раньше, с того же места и с той же ярлыком или аргументами.

txAdmin находит его txData по пути, который вы ему дали, и вы этого не изменили, поэтому ваш профиль, настройки и администраторы все еще там.

#Обновление на 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

Замените <build> на имя папки, которое вы копируете со страницы загрузки. Запустите сервер снова с вашей обычной командой или сервисом. Если вы еще этого не установили, смотрите running a FiveM server on Linux.

#Проверьте, что это сработало

При запуске консоль выводит версию FXServer. Сравните ее с номером сборки на странице загрузки. txAdmin также показывает версию на своей приборной панели, и устаревшее предупреждение должно быть ушло.

Если что-то сломается после обновления:

• Ресурсы не запускаются: прочитайте первую ошибку в консоли. Ресурс, который зависел от старого поведения, может нуждаться в обновлении. Смотрите couldn't start resource.
• Сервер вообще не запускается: положите старую папку server_old обратно, запустите его и сообщите номер сборки, который не сработал.
• Новое предупреждение о сборке игры: это другая настройка, смотрите sv_enforceGameBuild and DLC.

#Как часто обновлять

Вам не нужно гнаться за каждой сборкой. Разумное правило: обновляйте, когда txAdmin предупреждает вас, когда ресурс нуждается в более новой сборке, или когда вы попадаете в ошибку, которую позже сборка исправляет. Всегда сначала протестируйте обновление на копии сервера, если вы запускаете платные или занятые серверы, и сделайте это, когда мало людей онлайн.

#Контрольный список