Ez az útmutató bemutatja, hogyan telepíthetsz resource-okat (scripteket) a FiveM szerveredre, hogyan állíthatsz be MySQL adatbázist olyan keretrendszerekhez mint az ESX vagy QBCore, és megértheted a resource betöltési sorrendet. Ha még nem végezted el a szerver alapbeállítását, kezdd a FiveM szerver beállítási útmutató cikkel.

Resource-ok és scriptek telepítése

A FiveM szerverek resource-okkal (más néven scriptek) bővíthetők. A resource-ok olyan funkciókat adnak hozzá, mint autókereskedések, munkák, HUD elemek, keretrendszerek és még sok más.

Resource telepítése

1. Töltsd le a resource-ot a forrásából (GitHub, Cfx.re fórumok, Tebex stb.).
2. Ha szükséges, csomagold ki a resource mappát a ZIP/archívumból.
3. Töltsd fel a resource mappát a szervered resources/ könyvtárába a GPanel Files fülön vagy SFTP-n keresztül.
4. Nyisd meg a server.cfg fájlt és adj hozzá egy ensure sort a resource-hoz:

# Add your custom resources
ensure my-new-resource

5. Indítsd újra a szervert a GPanel-ből vagy TXAdmin-ból, hogy a resource betöltődjön.

Resource manifest-ek

Minden érvényes resource-nak tartalmaznia kell egy manifest fájlt. A modern resource-ok fxmanifest.lua fájlt használnak, míg a régebbiek __resource.lua fájlt. Ha egy letöltött resource mappa egyiket sem tartalmazza, a resource nem fog betöltődni. Néhány letöltés a tényleges resource mappát egy külső mappába ágyazza — győződj meg róla, hogy a resources/ könyvtárba helyezett mappa az, amelyik tartalmazza a manifest-et.

Resource betöltési sorrend

A resource-ok a server.cfg-ben megadott sorrendben töltődnek be. Ha egy resource függ egy másiktól (például egy munka script, ami függ egy keretrendszertől mint az ESX vagy QBCore), a függőséget előbb kell felsorolni, mint az azt igénylő resource-ot:

# 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

Resource-ok rendszerezése kategória mappákkal

A resource-okat almappákba rendezheted a resources/ könyvtáron belül. Használj szögletes zárójeles jelölést a server.cfg-ben egy teljes kategória mappa betöltéséhez:

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

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

Ez betölti az összes resource-ot az adott almappán belül. Kényelmes módja a kapcsolódó scriptek csoportosításának anélkül, hogy mindegyiket külön-külön kellene felsorolni.

Resource-ok azonnali betöltése TXAdmin-on keresztül

Nem mindig szükséges a szerver teljes újraindítása egy új resource betöltéséhez. A TXAdmin képes egyenként elindítani, leállítani és újraindítani resource-okat a Resources oldaláról. Egy új resource feltöltése és az ensure sor hozzáadása után a következő parancsot futtathatod a TXAdmin élő konzolban:

refresh
ensure my-new-resource

A refresh parancs utasítja a szervert, hogy keresse újra a resources/ könyvtárat az új bejegyzésekért.

Adatbázis beállítás (MySQL / MariaDB)

Sok FiveM keretrendszer és resource (például ESX, QBCore vagy vRP) MySQL vagy MariaDB adatbázist igényel. A Legion Hosting adatbázis hozzáférési adatokat biztosít a szervereddel.

Az adatbázis hozzáférési adatok megtalálása

1. A GPanel-ben menj a Databases fülre.
2. Ha még nincs adatbázisod, kattints a New Database gombra egy létrehozásához.
3. Jegyezd fel a következő adatokat:
   • Adatbázis hoszt (cím és port)
   • Adatbázis név
   • Felhasználónév
   • Jelszó (kattints a szem ikonra a megjelenítéshez)

Az adatbázis kapcsolat konfigurálása

Az adatbázis kapcsolat adatait a server.cfg-ben kell megadni egy kapcsolati karakterlánccal. A pontos formátum attól függ, melyik MySQL resource-ot használod, de a leggyakoribb formátum:

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

Cseréld ki a helyőrzőket a tényleges hozzáférési adataidra a Databases fülről. Például:

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

MySQL resource kiválasztása

Bármely MySQL resource-ot használod, azt a server.cfg-ben előbb kell betölteni, mint bármely tőle függő resource-ot:

# 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

Keretrendszer alapok

A keretrendszer biztosítja azokat az alapvető játékmenet rendszereket, amelyekre más resource-ok építenek — például játékos azonosítás, pénz, leltár, munkák és járművek. A két legnépszerűbb FiveM keretrendszer:

A legtöbb keretrendszer a TXAdmin recept rendszerén keresztül telepíthető az első beállítás során. Ha a TXAdmin beállításakor olyan receptet választottál, mint "QBCore" vagy "ESX", a keretrendszer és annak alap függőségei már telepítve vannak. Ha manuálisan kell telepítened egy keretrendszert, kövesd annak hivatalos dokumentációját:

• ESX dokumentáció
• QBCore dokumentáció

Segítség kérése

Ha segítségre van szükséged a resource telepítéssel vagy az adatbázis konfigurációval kapcsolatban:

1. Ellenőrizd a resource dokumentációját vagy GitHub oldalát a telepítési utasításokért és ismert problémákért.
2. Tekintsd át a GPanel konzolt vagy a TXAdmin naplókat hibaüzenetekért.
3. Nyiss egy support jegyet itt: https://legionhosting.net/submitticket.php a hibaüzenetekkel és a telepíteni kívánt resource nevével együtt.

Kapcsolódó cikkek

• FiveM szerver beállítási útmutató
• FiveM hibaelhárítás
• Fájlok feltöltése SFTP-vel
• Hogyan találd meg a szervered IP-jét és portját