Артефакты FiveM: разбор

1. Что такое артефакт FiveM

Cfx.re публикует новые билды FXServer несколько раз в неделю на runtime.fivem.net, нумеруя их по возрастанию. Каждый билд представляет собой полный серверный пакет: бинарные файлы FXServer, среду выполнения Citizen и встроенный txAdmin. Ваши ресурсы, server.cfg и база данных в него не входят; при смене билда они остаются на месте.

Именно номер билда проверяют список серверов и игровой клиент. Когда Cfx.re выпускает обновление клиента, требующее более нового сервера, серверы на старых билдах перестают принимать новых игроков, пока не обновятся. Поэтому обновление артефактов является самой частой задачей обслуживания сервера FiveM.

2. Recommended, latest или конкретный билд?

Cfx.re помечает один билд как Recommended: тот, что вышел достаточно давно, чтобы ему доверять. Билд Latest является самым новым из опубликованных, иногда ему всего несколько часов. Для публичного roleplay-сервера Recommended является безопасным выбором; берите Latest только тогда, когда этого требует обновление клиента или запись в changelog исправляет именно вашу проблему.

Старые билды остаются доступными, поэтому можно закрепить и конкретный номер, например когда нужный вам ресурс ломается на более новом билде. Changelog на changelogs.fivem.net показывает, что изменилось между билдами, и отмечает билды со статусом critical.

3. Узнайте, какой билд работает на вашем сервере

Откройте страницу входа txAdmin вашего сервера: в подвале показаны две версии, например tx: v8.1.1 | fx: b и номер. Этот номер fx и есть ваш артефакт, и для его просмотра даже не нужно входить в систему. Консоль сервера выводит тот же номер сразу после запуска.

4. Обновление на сервере VibeGAMES (один клик)

В игровой панели откройте свой сервер и нажмите Artifacts Updater в разделе Game Server. В списке показаны билды с runtime.fivem.net: метка Recommended стоит на билде, который советует Cfx.re, а метка Optional на самом новом; поле поиска находит конкретный номер.

Выберите билд и нажмите Install. Панель останавливает сервер, скачивает билд напрямую с Cfx.re и запускает сервер снова; страница Console показывает, когда он вернулся в строй. Ваши ресурсы, server.cfg, данные txAdmin и база данных остаются нетронутыми. Если перепрыгиваете сразу через много билдов, сначала сделайте резервную копию.

Серверы, переведённые на FiveM for GTAV Enhanced, всегда автоматически работают на последнем билде, поэтому там обновлятор доступен только для просмотра; вернитесь назад на странице GTAV Enhanced, если нужно закрепить билд.

5. Обновление вручную на VPS или выделенном сервере

Остановите сервер. Скачайте нужный билд с runtime.fivem.net (fx.tar.xz для Linux, server.7z для Windows), распакуйте его в новую папку рядом со старой и направьте команду запуска или run.sh на новую папку. Папка server-data с ресурсами, server.cfg и кешем остаётся на месте.

Запустите сервер и проследите в консоли за номером билда и строкой об успешной проверке лицензионного ключа. Сохраняйте старую папку, пока не убедитесь, что всё работает; откат тогда сводится к тому, чтобы вернуть команду запуска обратно.

6. Если обновление что-то сломало

Сервер, который после обновления перестал запускаться, обычно упирается в ресурс, использующий удалённый в новом билде API, или в профиль txAdmin, требующий сброса. Найдите в консоли первую красную строку, отключите названный в ней ресурс и попробуйте снова. Если не помогло, установите заново билд Recommended; откат так же безопасен, как и обновление.

Авторы ресурсов публикуют заметки о совместимости на форуме Cfx.re и на страницах релизов, поэтому после большого скачка имеет смысл в тот же заход обновить самые крупные ресурсы (фреймворк, инвентарь, античит).

7. Как часто обновляться?

Раз в несколько недель достаточно для большинства серверов, плюс каждый раз, когда обновление клиента не даёт игрокам подключиться. Следите в changelog за билдами с пометкой critical: они закрывают проблемы безопасности или стабильности и заслуживают немедленной установки. На VibeGAMES обновление занимает один клик и около минуты простоя, так что отставать на год нет никаких причин.