ESX, QBCore, alebo Qbox? Výber a inštalácia frameworku pre FiveM

Roleplay server stojí na frameworku: ten rieši postavy, peniaze, práce, inventár a autá. Porovnáme tri najpoužívanejšie (ESX Legacy, QBCore a Qbox), poradíme s výberom a prevedieme vás inštaláciou cez recept txAdminu vrátane nastavenia adminov.

Čo je framework#

Framework je sada resources, ktorá dáva serveru základnú „hru v RP“: vytvorenie postavy, peniaze v hotovosti a v banke, zamestnania a hodnosti, inventár, vlastníctvo áut, ukladanie do databázy. Ostatné skripty (práce, obchody, telefón, garáže) potom stavajú na funkciách frameworku.

Dôležité dôsledky:

• Skript je napísaný pre konkrétny framework. Skript pre ESX bez úprav na QBCore nepobeží a naopak. Pri skripte preto vždy hľadajte verziu pre váš framework.
• Framework sa ťažko mení za behu. Prechod na iný znamená novú databázu a výmenu skriptov. Vyberte si preto dobre hneď na začiatku.
• Framework potrebuje databázu a resource oxmysql.

Server bez frameworku (freeroam, drift, preteky) môže bežať na základnom recepte txAdminu (FiveM Basic Server).

Základné pojmy#

Kto tomu rozumie, ľahšie nájde chybu: keď sa „stratia“ peniaze alebo auto, je to záznam v databáze, ktorý sa dá dohľadať a opraviť (napríklad v HeidiSQL).

Porovnanie#

Ako vybrať#

• Chcete najviac hotových skriptov a návodov? ESX Legacy. Je najrozšírenejší a skripty preň nájdete takmer na všetko.
• Chcete moderný základ a skripty pre QBCore? Qbox. Používa knižnice ox_lib, ox_inventory a ox_target, má prísnejší kód a väčšinu skriptov pre QBCore spustí cez most bez úprav.
• Máte konkrétne platené skripty pre QBCore? QBCore, alebo Qbox (overte u autora skriptu, že na Qboxe funguje).
• Staviate server s vlastnými skriptmi od nuly? Vyberte ten, ktorého dokumentácia vám najviac vyhovuje. Dobrá znalosť frameworku je dôležitejšia než jeho voľba.

Najistejší postup: nasaďte framework na skúšku, prejdite ho v hre a až potom kupujte skripty.

Pred inštaláciou#

1. Vytvorte prázdnu databázu v záložke Databázy (napríklad fivem, Povolený prístup z %). Údaje Názov databázy, Používateľ, Server a Heslo si nechajte otvorené.
2. Pripravte license key (začína cfxk_).
3. Urobte zálohu, ak na serveri už niečo máte (záložka Zálohy, návod) a databázu vyexportujte (návod). Nové nasadenie sa ukladá do nového priečinka, ale databázu by recept so zapnutou voľbou Delete Database zmazal.
4. Skontrolujte artefakty. Frameworky vyžadujú aktuálnu verziu servera. Starý server aktualizujte podľa návodu Aktualizácia artefaktov.

Inštalácia cez recept txAdminu#

Postup je pri všetkých troch frameworkoch rovnaký, líši sa iba recept a pár nastavení po inštalácii. Ak ste v txAdmine už iný server nasadili, nového sprievodcu spustíte v Settings › FXServer tlačidlom Reset vedľa poľa Server Data Folder. txAdmin sa vráti na stránku Setup a existujúce súbory nezmaže.

1. V txAdmine na stránke Setup zadajte Server Name a kliknite na Next.
2. Pri Deployment Type zvoľte Popular Recipes.
3. Vyberte recept podľa záložky nižšie.
4. Ponechajte navrhnutý priečinok pre dáta, kliknite na Save a potom na Go to Recipe Deployer.
5. V kroku Step 1: Review Recipe kliknite na Next.
6. V kroku Step 2: Input Parameters vyplňte Server Registration Key a po kliknutí na Show/Hide Database options (advanced) aj databázu: Database Host (IP z poľa Server), Database Port (port z poľa Server), Database Username, Database Password, Database Name. Prepínač Delete Database je v predvolenom stave zapnutý, skontrolujte, že je na Off. Každé pole podrobne vysvetľuje návod k txAdminu.
7. Kliknite na Run Recipe a počkajte na dokončenie. Pri veľkých receptoch to trvá niekoľko minút.
8. V kroku Step 4: Configure server.cfg skontrolujte, že endpoint_add_tcp a endpoint_add_udp majú port z riadka Adresa na pripojenie v záložke Sieť (recept môže zapísať predvolený 30120). Potom upravte nastavenia podľa záložky nižšie a kliknite na Save & Run Server.

Prvé kroky po inštalácii: admin práva#

Admin v txAdmine a admin vo frameworku sú dve rôzne veci. txAdmin pri nasadení pridá do server.cfg hlavného admina do skupiny group.admin (riadok add_principal identifier.fivem:<FIVEM_ID> group.admin). Frameworky na to nadväzujú takto:

setgroup <ID_HRACE> admin

add_principal identifier.license:<LICENSE_HRACE> qbcore.god

add_principal identifier.license:<LICENSE_HRACE> group.admin

Po úprave server.cfg alebo permissions.cfg reštartujte server.

Pri Qboxe vyžadujú admin príkazy jadra (napríklad /addpermission, /setjob, /car) najprv zadať /optin. Vypína sa to voľbou requireOptIn = false v qbx_core/config/server.lua.

Čo nastaviť ako prvé#

Každý framework má hlavný konfiguračný súbor s ekonomikou, spawnom a postavami. Upravujte ho pri vypnutom serveri, alebo v txAdmine po úprave reštartujte server. Súbory nájdete v priečinku nasadenia v resources.

Peniaze a predmety sa ukladajú do databázy. Zmena štartovacích hodnôt sa týka iba novo vytvorených postáv, existujúcim nič nezmení.

Kompatibilné skripty#

• Sťahujte verziu pre svoj framework. Mnohí autori ponúkajú jeden skript pre viac frameworkov a voľbu v config.lua (napríklad Config.Framework = 'esx', 'qb' alebo 'qbx').
• Knižnice ox (ox_lib, ox_inventory, ox_target) fungujú s ESX aj Qboxom. Pred inštaláciou druhého inventára si ujasnite, ktorý používate. Dva inventáre naraz nefungujú.
• Skripty pre QBCore na Qboxe bežia cez most, ak používajú qb-core dokumentovaným spôsobom. Nefungujú skripty, ktoré siahajú priamo do databázových tabuliek QBCore.
• Konflikty: dva skripty s rovnakou funkciou (dva HUDy, dve garáže, dva telefóny) si zvyčajne prekážajú. Pôvodný vypnite (zakomentujte jeho ensure alebo ho presuňte z kategórie).

Inštaláciu jednotlivých skriptov opisuje návod FiveM resources.

Ručná inštalácia (pre pokročilých)#

Recept robí automaticky to, čo by ste inak robili ručne:

1. Stiahne jadro frameworku a jeho závislosti (oxmysql, ox_lib …) v konkrétnych verziách.
2. Naimportuje SQL súbor frameworku do databázy.
3. Pripraví server.cfg so správnym poradím ensure, právami ACE a connection stringom.

Ručnú inštaláciu voľte iba vtedy, keď chcete mať každú verziu pod kontrolou. Postupujte podľa oficiálnej dokumentácie frameworku a dodržte poradie: oxmysql › knižnice › jadro › skripty. Na serveri u nás je recept výrazne rýchlejší, ručné nahrávanie stoviek súborov cez záložku Súbory je zdĺhavé (veľké súbory cez SFTP zriadi podpora).

Aktualizácia frameworku#

1. Zálohujte súbory (záložka Zálohy) a vyexportujte databázu (HeidiSQL, návod).
2. Prečítajte si poznámky k vydaniu (changelog) na GitHube frameworku. Hľadajte hlavne zmeny databázy (súbory .sql s migráciami) a zmeny konfigurácie.
3. Vypnite server.
4. Nahraďte priečinky aktualizovaných resources novými. Svoje config.lua si vopred stiahnite a po aktualizácii porovnajte s novými (nové voľby môžu chýbať).
5. Spustite migračné SQL, ak ho vydanie obsahuje.
6. Spustite server a sledujte konzolu. Potom skontrolujte v hre postavu, peniaze a inventár.

Neaktualizujte iba jadro bez ostatných častí frameworku. Verzie es_extended a skriptov [esx_addons] (alebo qb-core a qb-*) majú ísť spolu.

Overenie#

• V konzole (alebo Live Console v txAdmine) je Database server connection established! a bez červených chýb sa načíta jadro frameworku.
• Po pripojení v hre sa objaví vytvorenie alebo výber postavy.
• Príkaz /group (ESX) alebo otvorenie admin menu /admin (QBCore, Qbox) potvrdí, že máte admin práva.

Keď niečo nefunguje#

Hlásenia, ktoré tu nenájdete, hľadajte v prehľade Časté chyby FiveM servera.

Task Failed: Response code 403 (rate limit exceeded)#

Recept sťahuje desiatky repozitárov z GitHubu a GitHub dočasne obmedzil počet požiadaviek. Počkajte zhruba hodinu a nasadenie spustite znova.

Nasadenie skončí chybou databázy#

Údaje sa nezhodujú so záložkou Databázy (host z poľa Server, nie localhost; názov databázy presne podľa zoznamu). Typické hlásenia a ich riešenia nájdete v návode Databáza pre FiveM.

ESX = nil (alebo attempt to index a nil value (global 'ESX'))#

Skript nemá prístup k ESX: buď štartuje skôr než es_extended, alebo používa starý spôsob načítania ESX. Dajte jeho ensure pod es_extended a aktualizujte es_extended aj skript na aktuálnu verziu.

No such export GetCoreObject in resource qbx_core#

Skript pre QBCore volá jadro Qboxu napriamo. Na Qboxe má volať exports['qb-core']:GetCoreObject() (cez most). Skontrolujte, že je most zapnutý (setr qbx:enableBridge "true"), a skript upravte alebo stiahnite verziu pre Qbox.

Native … is not supported#

Framework alebo skript používa funkciu, ktorú vaša verzia servera ešte nepozná. Aktualizujte artefakty na najnovšiu verziu (návod).

Hráč visí na načítacej obrazovke#

• Najčastejšie chyba v multicharacteri alebo databáze. Pozrite sa do konzoly servera a do klientskej konzoly F8.
• Qbox s vlastným multicharacterom: nastavte setr loadscreen:externalShutdown false.
• QBCore po prvom nasadení: počkajte, kým dobehne zostavenie resources (yarn).

ESX Multicharacter couldn't connect to the database#

Nefunguje pripojenie k databáze. Skontrolujte set mysql_connection_string v server.cfg a riadok Database server connection established! v konzole.

Admin príkazy nefungujú#

• QBCore a Qbox: chýba riadok add_principal … so správnym identifikátorom, alebo ste ho pridali a nereštartovali server.
• ESX: hráč nemá skupinu admin. Overte príkazom /group a nastavte ju setgroup.

Ďalšie zdroje#

• ESX Legacy: dokumentácia (otvorí sa v novom okne)
• QBCore: dokumentácia (otvorí sa v novom okne)
• Qbox: dokumentácia (otvorí sa v novom okne)
• FiveM: Frameworks (otvorí sa v novom okne)
• Zoznam receptov txAdminu (Popular Recipes) (otvorí sa v novom okne)