Это руководство описывает, как устанавливать ресурсы (скрипты) на ваш сервер FiveM, настроить базу данных MySQL для фреймворков вроде ESX или QBCore, а также понять порядок загрузки ресурсов. Если вы ещё не завершили первоначальную настройку сервера, начните сначала с Руководства по настройке сервера FiveM.

Установка ресурсов и скриптов

Серверы FiveM расширяются с помощью ресурсов (также называемых скриптами). Ресурсы добавляют функции, такие как автодилеры, работы, элементы HUD, фреймворки и многое другое.

Как установить ресурс

1. Скачайте ресурс из его источника (GitHub, форумы Cfx.re, Tebex и т. д.).
2. При необходимости извлеките папку ресурса из ZIP-/архива.
3. Загрузите папку ресурса в каталог resources/ вашего сервера, используя вкладку Files в GPanel или через SFTP.
4. Откройте server.cfg и добавьте строку ensure для ресурса:

# Add your custom resources
ensure my-new-resource

5. Перезапустите сервер из GPanel или TXAdmin, чтобы ресурс загрузился.

Манифесты ресурсов

Каждый действительный ресурс должен содержать файл манифеста. Современные ресурсы используют fxmanifest.lua, а более старые — __resource.lua. Если скачанная папка ресурса не содержит ни одного из этих файлов, ресурс не загрузится. Некоторые загрузки вкладывают фактическую папку ресурса внутрь внешней папки — убедитесь, что папка, которую вы помещаете в resources/, — это та, что содержит манифест.

Порядок загрузки ресурсов

Ресурсы загружаются в том порядке, в котором они появляются в server.cfg. Если ресурс зависит от другого (например, скрипт работы, зависящий от фреймворка вроде ESX или QBCore), убедитесь, что зависимость указана перед ресурсом, который в ней нуждается:

# Database resource first
ensure oxmysql

# Framework second
ensure es_extended

# Then resources that depend on the framework
ensure esx_basicneeds
ensure esx_jobs
ensure esx_vehicleshop

Организация ресурсов с помощью папок категорий

Вы можете организовать ресурсы во вложенные папки внутри каталога resources/. Используйте скобочную нотацию в server.cfg, чтобы обеспечить загрузку целой папки категории:

# Ensure all resources inside resources/[esx]/
ensure [esx]

# Ensure all resources inside resources/[standalone]/
ensure [standalone]

Это загружает каждый ресурс внутри названной вложенной папки. Это удобный способ сгруппировать связанные скрипты без перечисления каждого по отдельности.

Горячая загрузка ресурсов через TXAdmin

Вам не всегда нужен полный перезапуск сервера для загрузки нового ресурса. TXAdmin может запускать, останавливать и перезапускать отдельные ресурсы со своей страницы Resources. После загрузки нового ресурса и добавления его строки ensure, вы можете выполнить следующую команду в живой консоли TXAdmin:

refresh
ensure my-new-resource

Команда refresh указывает серверу повторно просканировать каталог resources/ на наличие новых записей.

Настройка базы данных (MySQL / MariaDB)

Многие фреймворки и ресурсы FiveM (такие как ESX, QBCore или vRP) требуют базу данных MySQL или MariaDB. Legion Hosting предоставляет учётные данные базы данных вместе с вашим сервером.

Поиск учётных данных базы данных

1. В GPanel перейдите на вкладку Databases.
2. Если базы данных ещё нет, нажмите New Database, чтобы создать её.
3. Запишите следующие данные:
   • Хост базы данных (адрес и порт)
   • Имя базы данных
   • Имя пользователя
   • Пароль (нажмите значок глаза, чтобы показать его)

Настройка подключения к базе данных

Детали подключения к базе данных задаются в server.cfg с помощью строки подключения. Точный формат зависит от того, какой ресурс MySQL вы используете, но наиболее распространённый формат такой:

# MySQL connection string (oxmysql / mysql-async format)
set mysql_connection_string "mysql://USERNAME:PASSWORD@HOST:PORT/DATABASE_NAME?charset=utf8mb4"

Замените заполнители на ваши фактические учётные данные с вкладки Databases. Например:

set mysql_connection_string "mysql://u123_fivem:[email protected]:3306/s123_fivem?charset=utf8mb4"

Выбор ресурса MySQL

Какой бы ресурс MySQL вы ни использовали, он должен быть обеспечен (ensure) в server.cfg перед любыми ресурсами, которые от него зависят:

# Database connection
set mysql_connection_string "mysql://USERNAME:PASSWORD@HOST:PORT/DATABASE_NAME?charset=utf8mb4"

# MySQL resource — must load before framework
ensure oxmysql

# Framework
ensure es_extended

Основы фреймворков

Фреймворк предоставляет основные игровые системы, на которых строятся другие ресурсы — такие вещи, как идентичность игрока, деньги, инвентарь, работы и транспорт. Два самых популярных фреймворка FiveM:

Большинство фреймворков устанавливаются через систему рецептов TXAdmin во время первоначальной настройки. Если вы выбрали рецепт вроде «QBCore» или «ESX» во время настройки TXAdmin, фреймворк и его основные зависимости уже установлены. Если вам нужно установить фреймворк вручную, следуйте его официальной документации:

• Документация ESX
• Документация QBCore

Получение помощи

Если вам нужна помощь с установкой ресурсов или настройкой базы данных:

1. Проверьте документацию ресурса или его страницу на GitHub для инструкций по установке и известных проблем.
2. Просмотрите консоль GPanel или логи TXAdmin на наличие сообщений об ошибках.
3. Откройте тикет в поддержку на https://legionhosting.net/submitticket.php с вашими сообщениями об ошибках и именем ресурса, который вы пытаетесь установить.

Похожие статьи

• Руководство по настройке сервера FiveM
• Устранение неполадок FiveM
• Как загружать файлы через SFTP
• Как найти IP и порт вашего сервера