Как установить сервер QBCore: рецепт txAdmin и ручные шаги

Вы хотите сервер QBCore и выбираете между рецептом и ручной установкой. Это руководство охватывает оба, server.cfg, который вам нужен, что проверить при первом запуске и ошибки, которые появляются почти на каждом первом сервере QBCore.

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

Рецепт — это рекомендуемый способ. В настройке txAdmin выберите шаблон QBCore из популярных рецептов, как описано в txAdmin setup и рецепты. Вы вводите ваш лицензионный ключ и детали базы данных, txAdmin загружает всё, создаёт базу данных и пишет server.cfg. Проверьте этот файл, запустите сервер и перейдите к первым проверкам ниже.

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

Используйте это, если у вас уже есть сервер и вы хотите добавить QBCore. Вам нужны FXServer, база данных MySQL или MariaDB и лицензионный ключ.

#1. Получите ресурсы

QBCore — это не один ресурс. Вам нужны:

• qb-core, сам фреймворк.
• Ресурсы qb вокруг него: инвентарь, мультихарактер, селектор спауна, работы, телефон и так далее. Они обычно сгруппированы в папку, такую как [qb].
• oxmysql для базы данных и ox_lib, от которого зависят многие текущие ресурсы.
• Автономные ресурсы, такие как ресурс голоса (см. pma-voice not working) и любые пакеты карты или автомобилей.

Скопируйте их в папку resources, например resources/[qb] и resources/[standalone].

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

CREATE DATABASE qbcore CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

Импортируйте SQL файл, который поставляется с установкой QBCore (репозиторий рецепта поставляет его с базовыми таблицами) и затем SQL каждого ресурса, который имеет свой собственный файл. Если скрипт позже говорит, что таблица отсутствует, см. SQL table doesn't exist.

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

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

ensure oxmysql
ensure ox_lib
ensure qb-core
ensure [qb]
ensure [standalone]

add_ace group.admin command allow
add_ace qbcore.god command allow
add_principal group.admin qbcore.god
add_principal identifier.license:YOUR_LICENSE_HERE qbcore.god

Замените YOUR_LICENSE_HERE вашим собственным идентификатором лицензии FiveM. Вы найдёте его в списке игроков txAdmin или в консоли сервера при присоединении. Строки ACE охватываются в ACE permissions.

Совет: ensure [qb] запускает каждый ресурс внутри этой папки. Держите сам qb-core вне её, как в примере, или он будет обеспечен дважды. См. server.cfg ensure order.

#Первые проверки

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

1. oxmysql подключается к базе данных без ошибки.
2. qb-core запускается. Если нет, каждый другой ресурс qb не удаётся после него.
3. Никакие красные ошибки от ресурсов в [qb]. Несколько предупреждений нормальны; повторяющиеся ошибки не.
4. Вы можете присоединиться, получить выбор персонажа, создать персонажа и спауниться.
5. Строка создана в таблице players для вашего персонажа.

Если вы не можете присоединиться или остаться на экране загрузки, прочитайте players stuck on the loading screen.

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

QBCore is nil. Скрипт, который использует старый метод получения основного объекта, не удаётся:

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

Используйте local QBCore = exports['qb-core']:GetCoreObject() в верхней части каждого файла. Полное объяснение находится в QBCore nil: the GetCoreObject fix.

qb-core не запустился. Другие ресурсы затем сообщают:

No such export GetCoreObject in resource qb-core

Посмотрите в верхней части консоли первую ошибку самого qb-core, которая обычно является базой данных. См. oxmysql connection error.

Ресурс не запускается. Отсутствующая зависимость или проблемы с названием папки: could not find dependency, couldn't start resource.

Вы не администратор. Ваш идентификатор в server.cfg не совпадает с вашим, или вы не перезагрузились после редактирования.

#Следующие шаги

Когда база стабильна, обычные первые задачи — это добавление работ и элементов. См. QBCore add job и qb-inventory add items. Если вы планируете запустить более новый стек позже, прочитайте install QBox в первую очередь, потому что стек отличается.

#Чеклист