Скрипты FiveM устанавливаются так: ты кладёшь ресурс в папку resources/, запускаешь его в server.cfg через ensure и заранее загружаешь зависимости вроде ESX, QBCore или драйверов базы данных. Решающее значение имеют аккуратная структура папок, правильный порядок запуска, проверенный импорт SQL и взгляд в консоль сервера после перезапуска.
Требования
Тебе нужен доступ к файлам сервера, к server.cfg, к консоли сервера и, если скрипт использует таблицы базы данных, к твоей базе MySQL или MariaDB. На арендованном сервере FiveM для этого обычно есть файловый менеджер, FTP/SFTP и инструмент для работы с базами данных, например phpMyAdmin или Adminer. Если ты ещё только планируешь весь сервер, с базовой структурой поможет наш внутренний гайд Аренда и настройка сервера FiveM.
FiveM технически называет скрипты ресурсами. Согласно официальной документации Cfx.re, файл fxmanifest.lua описывает, какие файлы, скрипты и метаданные относятся к ресурсу. Поэтому всегда сначала проверяй, есть ли в распакованной папке корректный файл манифеста. Без манифеста сервер не сможет правильно загрузить ресурс.
Проверка структуры скрипта
Типичный ресурс FiveM выглядит так:
my_script/
├── fxmanifest.lua # Файл манифеста
├── client.lua # Клиентский код
├── server.lua # Серверный код
├── config.lua # Конфигурация
└── html/ # NUI (веб-интерфейс)
Важно не загрузить случайно лишнюю папку-упаковку. Ошибкой было бы, например, resources/my_script-main/my_script/fxmanifest.lua, если ресурс должен лежать прямо в resources/my_script/fxmanifest.lua. После распаковки открой папку и проверь уровень, на котором лежит fxmanifest.lua.
Установка скрипта
- Скачай скрипт
- Распакуй его в папку
resources/ - Добавь в
server.cfg:
ensure my_script
- Перезапусти сервер
В качестве имени ресурса используй точное имя папки или имя, указанное в README. Многие ошибки возникают из-за отличающегося написания, пробелов в имени папки или спецсимволов. Лучше всего подходят короткие имена из строчных букв с дефисами или подчёркиваниями.
Настройка скриптов ESX
Скрипты ESX зависят от того, что база ESX и необходимые дополнительные ресурсы запущены раньше. Конкретный порядок может отличаться в зависимости от версии ESX и скрипта, поэтому правило такое: проверяй README скрипта и учитывай имеющуюся документацию фреймворка.
# Базовый 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
Если скрипт работы ожидает собственные таблицы базы данных или предметы, импортируй прилагаемый SQL-файл до первого боевого запуска. Предварительно сделай резервную копию базы данных. На уже работающих ролевых серверах SQL-файлы могут перезаписать столбцы, предметы или работы, если они не адаптированы под твою установку.
Настройка скриптов QBCore
Ресурсам QBCore нужны их зависимости до фреймворка или до соответствующего скрипта. Следующий пример предполагает, что эти версии используют oxmysql; дополнительные зависимости из README ты добавляешь в подходящем месте:
ensure oxmysql
ensure qb-core
ensure qb-inventory
ensure qb-garages
ensure qb-policejob
ensure qb-ambulancejob
ensure qb-phone
Особенно внимательно проверь конфигурационные файлы вроде config.lua, shared/config.lua или файлов предметов, специфичных для фреймворка. Некоторым скриптам QBCore нужны записи в предметах, работах, бандах или правах. Вноси только те значения, которые описаны в документации скрипта. Если хочешь рассмотреть ресурсы, txAdmin и работу сервера в более широком контексте, прочитай также Аренда сервера FiveM: настройка GTA RP, ресурсы и txAdmin 2025.
Соблюдай порядок запуска
Порядок запуска определяется фактически задокументированными зависимостями:
- Драйверы баз данных и общие библиотеки, например
oxmysql, если они требуются - Фреймворк, такой как ESX или QBCore
- Базовые ресурсы, например инвентарь или гаражи
- Работы и другие функции, использующие эту базу
- Косметические ресурсы, если их собственные зависимости уже запущены
Запись dependency в манифесте описывает предварительное условие. Согласно справочнику по манифесту Cfx.re, соответствующий ресурс должен загрузиться раньше зависящего от него ресурса. Точный порядок определяет README установленной версии.
По возможности запускай общие зависимости централизованно и до всех зависящих от них ресурсов. Если нескольким скриптам нужна одна и та же библиотека, её следует запускать только один раз. При подключении к базе данных драйвер должен работать раньше, чем ресурсы начнут отправлять SQL-запросы.
Бесплатные источники скриптов
| Источник | Описание |
|---|---|
| GitHub | Скрипты с открытым исходным кодом |
| Cfx.re Releases-Forum | Скрипты сообщества |
| Overextended | Качественные решения с открытым исходным кодом |
Скачивай скрипты только из источников, где код, список изменений или отзывы сообщества можно проверить. При неизвестных загрузках обращай особое внимание на обфусцированный Lua-код, необъяснимые HTTP-запросы, сторонние вебхуки и жёстко прописанные токены. Устанавливай новые ресурсы сначала на тестовом экземпляре или вне основного игрового времени.
Проверка результата
Перезапусти сервер и следи за консолью. Корректно загруженный ресурс отображается без ошибок манифеста, зависимостей или SQL. Затем в игре проверь именно ту функцию, которую предоставляет скрипт: меню работы, взаимодействие с инвентарём, маркеры, команду, окно NUI или изменение в базе данных. Тестируй с теми ролями и правами, которые позже будут у настоящих игроков.
Команды refresh и ensure my_script в консоли сервера используй дополнительно только для контролируемых тестов. Для рабочих изменений чистый перезапуск часто показательнее, потому что воспроизводит весь порядок запуска.
Устранение неполадок
SCRIPT ERROR
Сначала проверь строку в консоли. Часто не хватает зависимости, неправильно задана переменная конфигурации или экспортированная функция вызывается до запуска целевого ресурса. Сравни сообщение об ошибке с README скрипта.
Ошибка SQL
Импортируй прилагаемые таблицы или столбцы, если скрипт их требует. Если таблицы уже существуют, не выполняй SQL повторно вслепую. Создай резервную копию и адаптируй запросы под имеющуюся структуру базы данных.
Скрипт не загружается
Проверь имя папки, запись ensure и fxmanifest.lua. Опечатки в файле манифеста или неправильно вложенной папки достаточно, чтобы ресурс не запустился.
Функция не появляется в игре
Проверь права, работы, предметы, координаты и версию фреймворка. Многие ролевые скрипты работают только для определённых работ или групп. Поэтому тестируй не только как админ, но и с обычным профилем игрока.
FAQ
Нужно ли перезапускать сервер после каждого скрипта?
Для надёжного теста да. Отдельные ресурсы можно перезагрузить через консоль, но полный перезапуск показывает, действительно ли порядок запуска и все зависимости в порядке.
Можно ли использовать ESX и QBCore одновременно?
На практике стоит выбрать один фреймворк. Многие скрипты чётко написаны либо для ESX, либо для QBCore и ожидают разные события, таблицы и структуры конфигурации.
Что делать, если у скрипта нет fxmanifest.lua?
Дополнительно проверь, есть ли более старый манифест __resource.lua. Cfx.re по-прежнему документирует этот формат как устаревший, поэтому отсутствие одного лишь fxmanifest.lua не доказывает, что загрузка повреждена. Для новых ресурсов используй актуальный формат, а старые переноси по справочнику по манифесту. Не просто переименовывай старый файл, не проверив его синтаксис и содержимое.
Стоит ли тестировать бесплатные скрипты прямо на боевом сервере?
Лучше нет. Сначала тестируй новые ресурсы отдельно, сделай резервную копию файлов и базы данных и проверь консоль. Особенно на ролевых серверах ошибочные скрипты могут повлиять на инвентарь, работы или прогресс игроков.
Сколько скриптов может использовать сервер FiveM?
Универсального разумного числа не существует. Решающее значение имеют качество скриптов, зависимости, нагрузка на базу данных, поведение тиков и количество игроков. Планируй ресурсы осознанно и последовательно удаляй неиспользуемые скрипты.
