Как установить ESX Legacy на сервер FiveM: рецепт и вручную

Вы хотите запустить сервер FiveM с ESX Legacy и хотите знать, как его установить. Есть два способа: рецепт txAdmin, который делает всё, и ручная установка, где вы размещаете каждый кусок самостоятельно. Это руководство охватывает оба, затем что проверить при первом входе и ошибки, которые вы, скорее всего, увидите.

#Вариант 1: рецепт txAdmin

Это рекомендуемый маршрут. В настройке txAdmin выберите шаблон ESX Legacy из популярных рецептов. Следуйте инструкциям в setup и рецепты txAdmin: введите ваш лицензионный ключ и учётные данные базы данных, затем проверьте сгенерированный server.cfg и запустите сервер.

Рецепт загружает es_extended и основные ресурсы, oxmysql и ox_lib, создаёт базу данных и импортирует файл SQL ESX. Когда вы закончите, у вас будет рабочая база. Пропустите до "Проверки первого входа".

#Вариант 2: ручная установка

Сделайте это, когда вы добавляете ESX на сервер, который вы построили сами. Вам нужен запущенный FXServer, база данных MySQL или MariaDB и лицензионный ключ.

#1. Загрузите ресурсы

Из выпусков ESX Legacy получите основной пакет (es_extended и основные ресурсы, которые он использует, такие как ресурсы идентичности, меню и уведомления). Поместите их в папку resources, например в resources/[esx]. Вам также нужны:

• oxmysql, слой базы данных.
• ox_lib, общая зависимость для современных ресурсов ESX.
• Инвентарь. Многие серверы ESX Legacy используют ox_inventory. Следуйте документации версии, которую вы загружаете, потому что стандартная установка может отличаться между выпусками.

#2. Создайте базу данных и импортируйте SQL

Создайте пустую базу данных, например esx:

CREATE DATABASE esx CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

Затем импортируйте файл SQL, который идёт с es_extended (ищите файл .sql в его папке, названный legacy.sql на момент написания). Используйте HeidiSQL, phpMyAdmin или командную строку mysql. Без этого вы встретитесь ошибками table doesn't exist.

#3. Отредактируйте server.cfg

Установите строку подключения и запустите ресурсы в хорошем порядке:

set mysql_connection_string "mysql://user:password@localhost/esx?charset=utf8mb4"

ensure oxmysql
ensure ox_lib
ensure es_extended
ensure ox_inventory
ensure [esx]
ensure [standalone]

Порядок объясняется в server.cfg ensure order. Если вы используете ресурсы идентичности или мультихарактера ESX, убедитесь, что работает только один ресурс выбора символа.

#Проверки первого входа

Запустите сервер и прочитайте консоль сверху вниз перед присоединением. Затем проверьте:

1. oxmysql подключается. Есть строка о подключении базы данных и никакой красной ошибки сразу после неё.
2. es_extended запускается без ошибок.
3. Вы можете присоединиться и достичь создания персонажа или спауна.
4. Строка вашего игрока существует. После присоединения вы должны увидеть строку для себя в таблице users.
5. Деньги и работа загружаются. Откройте инвентарь или запустите команду, которая печатает ваш счёт и работу.

Для прав администратора установите вашу group на admin в вашей строке users, затем повторно присоединитесь. Для txAdmin и команд ACE см. ACE permissions.

#Частые первые ошибки

ESX nil в скрипте. Ресурс, который всё ещё использует старый способ получения ESX, показывает:

attempt to index a nil value (global 'ESX')

Современный способ — ESX = exports['es_extended']:getSharedObject(). См. ESX is nil: fixing esx:getSharedObject и no such export getSharedObject in es_extended.

Не может подключиться к базе данных. Строка подключения неправильна, база данных не запущена или пользователь не имеет прав. См. oxmysql connection error.

Ресурс не запускается. Часто отсутствует зависимость или неправильное имя папки. См. could not find dependency и couldn't start resource.

Игроки застревают на загрузке. Посмотрите в консоль на ресурс, который ошибается при присоединении. См. players stuck on the loading screen.

Совет: когда вы добавляете скрипт, добавляйте по одному и перезагружайте. Если появляется ошибка, вы знаете, какой скрипт её вызвал.

#Добавление работ и элементов

Как только база работает, следующие задачи — это работы и элементы. Add a job on ESX показывает строки базы данных, которые вам нужны. Для элементов способ зависит от вашего инвентаря: см. ox_inventory add items.

#Чеклист