Това ръководство обхваща как да инсталирате ресурси (скриптове) на вашия 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. Запишете следните детайли:
   • Database Host (адрес и порт)
   • Database Name
   • Username
   • Password (щракнете върху иконата на око, за да я разкриете)

Конфигуриране на връзката с базата данни

Детайлите за връзка с базата данни се задават в 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 ресурс да използвате, той трябва да бъде осигурен в 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 и порта на вашия сървър