Что входит в готовый комплект
Сборка 1.1.3 содержит движок, txAdmin, мастер, издатель и базовый игровой профиль. Она не является готовым RP-сервером с экономикой, персонажами, работами и SQL-базой. openm-local предназначен для базовой проверки игрового мира и спавна.
QBCore и другие frameworks — отдельные наборы ресурсов со своими версиями, лицензиями и схемами данных. Установка движка и установка framework проверяются как два самостоятельных этапа.
Инвентаризация существующей сборки
До переноса запишите:
- Версию framework и каждого критичного ресурса, исходный репозиторий или архив.
- Основной
server.cfg, все цепочкиexec, порядокensureи ACE-права. - Версию СУБД, кодировку, схему, SQL-миграции и коннектор.
- Внешние зависимости: Discord, телефония, платежи, изображения, CDN, API.
- Требуемые natives, игровые build-параметры, платные или закрытые компоненты.
- Формат идентификаторов владельцев персонажей, имущества и прав.
Сделайте согласованную резервную копию. Для теста используйте копию БД и отдельную карточку/идентичность. Запуск тестового framework на рабочей БД может изменить записи уже при старте.
Подключение существующего server-data
Расположите каталог данных по абсолютному ASCII-пути, например C:\OpenM-Data\Roleplay. В нём должны существовать server.cfg и resources. Запустите мастер и выберите существующие данные, укажите этот путь, затем настройте сеть, ID и отдельные ключи OpenM.
Мастер сохраняет резервную копию основного конфига перед изменением, заменяет управляемые верхнеуровневые endpoint-настройки и подключает openm-server.cfg. Он не анализирует рекурсивно все exec и не мигрирует SQL. После применения вручную проверьте вложенные конфиги на повторные endpoint, выключенный admission и устаревшие настройки внешней инфраструктуры.
Не копируйте старый исполняемый файл FXServer поверх OpenM. Движок берётся из комплекта OpenM, а существующий каталог содержит данные и ресурсы.
Порядок запуска QBCore
Общий порядок выглядит так; точные имена и состав определяются вашим набором ресурсов:
# Строка БД должна быть задана до запуска коннектора.
exec private-database.cfg
ensure oxmysql
ensure qb-core
# Далее — зависимости и ресурсы вашей согласованной версии.
Если framework самостоятельно управляет персонажем и спавном, отключите ensure openm-local: два владельца спавна могут конфликтовать. Не удаляйте штатные ресурсы вслепую — сначала проверьте зависимости framework. Конфигурация выше не является полным готовым рецептом RP-сервера.
В проекте выполнялись интеграционные проверки QBCore 1.3.0, oxmysql 2.14.3 и MySQL 8.4, а также отдельного набора ресурсов рецепта. Это свидетельство конкретной комбинации, а не подтверждение всех функций любого актуального QBCore. Эти сторонние пакеты не включены в стандартный серверный ZIP.
Идентификаторы игроков
Режимы могут ожидать идентификаторы с историческими префиксами license, license2 или fivem. OpenM предоставляет совместимые представления на основе подтверждённой идентичности OpenM. Совпадение названия префикса не означает совпадение значения со старой базой другого сервера.
Перед переносом персонажей определите таблицы и связи, в которых хранится идентификатор владельца. Подготовьте проверяемое соответствие старых и новых аккаунтов; не выдавайте имущество только по нику, Discord-имени или произвольному значению от клиента. Массовое обновление идентификаторов без подтверждения принадлежности может передать чужие данные.
Матрица приёмки режима
На тестовой копии проверьте создание и выбор персонажа, повторный вход, позицию, деньги, инвентарь, транспорт, гаражи, работу администраторов и сохранение после штатной остановки. Для каждого действия запишите результат, ошибки клиента/сервера и изменения БД.
Затем повторите вход двумя игроками из внешней сети. Убедитесь, что серверные события проверяют права и входные данные, а не доверяют клиентской сумме денег или роли. Только после этого планируйте миграцию рабочих данных.
Восстановление после неудачного переноса
Остановите тестовый экземпляр. Сохраните его логи отдельно, верните предыдущий согласованный набор ресурсов, конфигов и БД. Не запускайте одновременно старую и новую сборку с общей рабочей базой. Если схема была изменена необратимо, восстановите резервную копию в отдельную БД и проверьте её до переключения игроков.