Овој водич покрива како да инсталирате ресурси (скрипти) на вашиот FiveM сервер, да поставите MySQL база на податоци за фрејмворци како ESX или QBCore и да го разберете редоследот на вчитување на ресурси. Ако сè уште не сте го завршиле првичното поставување на серверот, започнете најпрво со Водич за поставување на FiveM сервер.

Инсталирање на ресурси и скрипти

FiveM серверите се прошируваат со ресурси (исто така наречени скрипти). Ресурсите додаваат функции како продавачи на автомобили, работни места, HUD елементи, фрејмворци и повеќе.

Како да инсталирате ресурс

1. Преземете го ресурсот од неговиот извор (GitHub, Cfx.re форуми, Tebex, итн.).
2. Извлечете ја папката со ресурсот од ZIP/архивата ако е потребно.
3. Поставете ја папката со ресурсот во директориумот resources/ на вашиот сервер користејќи го GPanel табот Files или преку 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 live конзолата:

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"

Заменете ги placeholders со вашите вистински акредитиви од табот 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 и портот на вашиот сервер