Скрипты FiveM устанавливаются так: ты кладёшь ресурс в папку resources/, запускаешь его в server.cfg через ensure и заранее загружаешь зависимости вроде ESX, QBCore или драйверов базы данных. Важнее всего аккуратная структура папок, правильный порядок запуска, проверенный импорт SQL и просмотр консоли сервера после перезапуска.
Требования
Тебе нужен доступ к файлам сервера, server.cfg, консоли сервера и, если скрипт использует таблицы базы данных, к твоей базе MySQL или MariaDB. Для арендованного FiveM Server обычно нужны файловый менеджер, FTP/SFTP и инструмент для базы данных вроде phpMyAdmin или Adminer. Если ты ещё только планируешь весь сервер, внутренний гайд арендовать и настроить FiveM Server поможет с базовой структурой.
В FiveM скрипты технически называются ресурсами. Согласно официальной документации Cfx.re, файл fxmanifest.lua описывает, какие файлы, скрипты и метаданные относятся к ресурсу. Поэтому всегда сначала проверяй, есть ли в распакованной папке действительный manifest-файл. Без manifest сервер не сможет корректно загрузить ресурс.
Проверка структуры скрипта
Типичный ресурс FiveM выглядит так:
мой_скрипт/
├── fxmanifest.lua # Manifest-файл
├── client.lua # Клиентский код
├── server.lua # Серверный код
├── config.lua # Конфигурация
└── html/ # NUI (веб-интерфейс)
Важно случайно не загрузить лишнюю папку-обёртку. Неправильно, например, resources/mein_script-main/mein_script/fxmanifest.lua, если ресурс на самом деле должен лежать напрямую в resources/mein_script/fxmanifest.lua. После распаковки открой папку и проверь уровень, на котором находится fxmanifest.lua.
Установка скрипта
- Скачать скрипт
- Распаковать в папку
resources/ - Добавить в
server.cfg:
ensure mein_script
- Перезапустить сервер
В качестве имени ресурса используй точно имя папки или имя, указанное в README. Многие ошибки возникают из-за различий в написании, пробелов в имени папки или специальных символов. Лучше использовать короткие имена со строчными буквами, дефисами или подчёркиваниями.
Настройка скриптов ESX
Скрипты ESX зависят от того, что база ESX и нужные дополнительные ресурсы запускаются заранее. Конкретный порядок может отличаться в зависимости от версии ESX и скрипта, поэтому правило такое: проверяй README скрипта и учитывай существующую документацию framework.
# База ESX
ensure es_extended
ensure esx_menu_default
ensure esx_menu_dialog
ensure esx_menu_list
# Работы
ensure esx_policejob
ensure esx_ambulancejob
ensure esx_mechanicjob
ensure esx_taxijob
# Функции
ensure esx_banking
ensure esx_vehicleshop
ensure esx_property
Если скрипт работы ожидает собственные таблицы базы данных или items, импортируй приложенный SQL-файл до первого продуктивного запуска. Перед этим сделай резервную копию базы данных. На существующих roleplay-серверах SQL-файлы могут перезаписать столбцы, items или jobs, если они не адаптированы под твою установку.
Настройка скриптов QBCore
Ресурсы QBCore работают по похожему принципу: сначала framework, затем общие библиотеки, после этого инвентарь, jobs, гаражи, phone или HUD. Простой пример:
ensure qb-core
ensure qb-policejob
ensure qb-ambulancejob
ensure qb-garages
ensure qb-inventory
ensure qb-phone
Особенно внимательно проверяй конфигурационные файлы вроде config.lua, shared/config.lua или framework-специфичные файлы items. Некоторые скрипты QBCore ожидают записи в Items, Jobs, Gangs или Permissions. Вноси только те значения, которые задокументированы скриптом. Если хочешь планировать ресурсы, txAdmin и эксплуатацию сервера в более широком контексте, прочитай также арендовать FiveM Server: настроить GTA RP, ресурсы и txAdmin 2025.
Учитывай порядок запуска
Порядок запуска важен:
- Сначала Framework (ESX/QBCore)
- Dependencies (oxmysql и т. д.)
- Базовые скрипты (инвентарь, HUD)
- Job-скрипты
- Косметические скрипты (эмоции, одежда)
Общие dependencies по возможности размещай централизованно и перед всеми зависимыми ресурсами. Если нескольким скриптам нужна одна и та же библиотека, она должна запускаться только один раз. При подключении к базе данных драйвер базы должен работать до того, как ресурсы начнут отправлять SQL-запросы.
Бесплатные источники скриптов
| Источник | Описание |
|---|---|
| GitHub | Open-Source скрипты |
| cfx.re Forum | Скрипты сообщества |
| Overextended | Качественный Open-Source |
Скачивай скрипты только из источников, где можно проверить код, changelog или отзывы сообщества. В неизвестных загрузках особенно обращай внимание на обфусцированный Lua-код, необъяснимые HTTP-запросы, чужие webhooks и жёстко прописанные tokens. Сначала устанавливай новые ресурсы на тестовый экземпляр или вне основного игрового времени.
Проверка результата
Перезапусти сервер и наблюдай за консолью. Корректно загруженный ресурс появляется без ошибок manifest, dependency или SQL. Затем в игре точно проверь функцию, которую предоставляет скрипт: меню работы, взаимодействие с инвентарём, marker, command, окно NUI или изменение базы данных. Тестируй с ролями и правами, которые позже будут использовать реальные игроки.
Дополнительно используй refresh и ensure mein_script в консоли сервера только для контролируемых тестов. Для продуктивных изменений чистый перезапуск часто информативнее, потому что он показывает полный порядок запуска.
Troubleshooting
SCRIPT ERROR
Сначала проверь строку в консоли. Часто отсутствует dependency, неверно задана config-переменная или экспортированная функция вызывается до запуска целевого ресурса. Сравни сообщение об ошибке с README скрипта.
Ошибки SQL
Импортируй приложенные таблицы или столбцы, если скрипт их требует. Если таблицы уже существуют, не запускай SQL повторно вслепую. Создай backup и адаптируй statements под свою существующую структуру базы данных.
Скрипт не загружается
Проверь имя папки, запись ensure и fxmanifest.lua. Опечатки в manifest-файле или неправильно вложенной папки достаточно, чтобы ресурс не запустился.
Функция не появляется в игре
Проверь права, jobs, items, координаты и версию framework. Многие roleplay-скрипты работают только для определённых jobs или групп. Поэтому тестируй не только как admin, но и с обычным профилем игрока.
Проверка, ограничения и безопасный откат
Инструкция «Установка скриптов FiveM Server — ESX и QBCore» относится к типу сервера, описанному в статье, и к состоянию версий, видимому на момент проверки. Названия меню, доступные версии, совместимость mods или plugins и необходимые ресурсы могут измениться после обновлений. Поэтому не переноси значения на другую версию игры, loader или сервера без проверки.
Перед изменениями мира, сохранения, конфигурации или расширений создай backup затронутых файлов. Затем меняй только один связанный шаг и проверяй его с той же версией клиента и сервера, с которой ты позже хочешь играть.
| Пункт проверки | Ожидаемый результат | Остановка и откат |
|---|---|---|
| Запуск сервера | Сервер достигает готового к работе состояния без новых сообщений об ошибках. | При ошибках запуска откатить изменение и восстановить последний backup. |
| Проверка подключения | Тестовый аккаунт может подключиться по адресу, показанному в панели. | При ошибках версии или подключения заново сверить версию, порт и разрешения. |
| Проверка функции | Конкретно изменённая функция работает, не повреждая существующие данные мира или игры. | При побочных эффектах остановить сервер и восстановить сохранённые файлы. |
Успешный одиночный тест не является гарантией производительности или доступности. Размер мира, mods, plugins, число игроков, сетевой маршрут и одновременная нагрузка могут изменить результат. Документируй версию, изменение и результат теста, чтобы позже понимать отклонения.
FAQ
Нужно ли перезапускать сервер после каждого скрипта?
Для надёжного теста да. Отдельные ресурсы можно перезагружать через консоль, но полный перезапуск показывает, действительно ли порядок запуска и все dependencies корректны.
Можно ли использовать ESX и QBCore одновременно?
На практике лучше выбрать один framework. Многие скрипты явно сделаны для ESX или QBCore и ожидают разные events, таблицы и структуры config.
Что делать, если у скрипта нет fxmanifest.lua?
Тогда он, возможно, устарел, неправильно распакован или не подготовлен для актуальных структур ресурсов FiveM. Проверь источник и документацию, прежде чем устанавливать его в production.
Стоит ли тестировать бесплатные скрипты прямо на live-сервере?
Лучше нет. Сначала тестируй новые ресурсы отдельно, сохраняй файлы и базу данных и проверяй консоль. Особенно на roleplay-серверах ошибочные скрипты могут повлиять на инвентарь, jobs или прогресс игроков.
Сколько скриптов может использовать FiveM Server?
Универсального разумного числа нет. Важны качество скриптов, зависимости, нагрузка на базу данных, поведение tick и число игроков. Планируй ресурсы осознанно и последовательно удаляй неиспользуемые скрипты.