У цьому посібнику описано, як встановлювати ресурси (скрипти) на ваш сервер 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) цілу папку категорії:

# 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 ви використовували, він має бути забезпечений (ensured) у 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:

Більшість фреймворків встановлюється через систему рецептів (recipe) TXAdmin під час початкового налаштування. Якщо під час налаштування TXAdmin ви вибрали рецепт на кшталт «QBCore» чи «ESX», фреймворк та його основні залежності вже встановлено. Якщо вам потрібно встановити фреймворк вручну, дотримуйтесь його офіційної документації:

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

Отримання допомоги

Якщо вам потрібна допомога зі встановленням ресурсів або налаштуванням бази даних:

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

Пов'язані статті

• Посібник із налаштування сервера FiveM
• Усунення несправностей FiveM
• Як завантажувати файли через SFTP
• Як знайти IP-адресу та порт вашого сервера