Časté chyby FiveM servera a ich riešenie

Väčšinu problémov FiveM servera prezradí jediný riadok vo výpise. Tu nájdete najčastejšie hlásenia presne tak, ako ich uvidíte, s príčinou a postupom opravy. Hľadajte podľa textu chyby (Ctrl+F).

Kde hľadať chyby#

Čítajte od prvej chyby. Ďalšie chyby sú často iba jej následok. Riadky v žltej a červenej farbe sú varovania a chyby.

Could not authenticate server license key alebo no license key was specified#

Príčina: server nemá platný license key. Buď ho nedostal vôbec, alebo je neplatný, deaktivovaný či skopírovaný s chybou.

Riešenie: skontrolujte riadok sv_licenseKey v server.cfg, ktorý server naozaj načítava, a premennú s kľúčom v záložke Nastavenia. Na Cfx.re Portali (otvorí sa v novom okne) overte, že má kľúč stav Active. Podrobný postup: FiveM license key.

Couldn't find resource …#

Príčina: server nepozná resource s menom z ensure. Názov priečinka nesedí (-main, veľké písmená), fxmanifest.lua je o úroveň hlbšie, alebo ste skript nahrali za behu bez príkazu refresh.

Riešenie: premenujte priečinok presne na názov z ensure a skontrolujte, že je v ňom priamo fxmanifest.lua. Potom zadajte v konzole refresh a ensure <NAZEV>, alebo server reštartujte. Pozri FiveM resources.

Could not find dependency … for resource …#

Príčina: skript potrebuje iný resource (knižnicu, framework), ktorý na serveri nie je.

Riešenie: nainštalujte resource uvedený ako prvý v hlásení a jeho ensure dajte v server.cfg nad skript. Hlásenie Could not start dependency … znamená, že závislosť existuje, ale sama spadla. Nájdite v konzole jej chybu.

Couldn't start resource …#

Príčina: resource existuje, ale nespustil sa. Skutočný dôvod je v riadkoch tesne nad týmto hlásením: chýbajúca závislosť, nesplnená podmienka (OneSync, game build, verzia servera) alebo chyba licencie plateného skriptu.

Riešenie: opravte príčinu z predchádzajúcich riadkov a resource spustite znova príkazom ensure <NAZEV>.

SCRIPT ERROR: @…/….lua:…: …#

Príčina: chyba v kóde skriptu. Hlásenie obsahuje resource, súbor, číslo riadka a opis, napríklad attempt to index a nil value. Najčastejšie ide o nesprávne nastavenie frameworku v config.lua, chýbajúcu tabuľku v databáze alebo staršiu verziu skriptu, než ktorú framework očakáva.

Riešenie: skontrolujte config.lua (správny framework), naimportujte SQL skriptu a aktualizujte skript aj framework. Ak chyba vznikla po úprave súboru, vráťte úpravu.

You lack the required entitlement to use …#

Príčina: platený skript chránený Asset Escrow je kúpený na inom účte Cfx.re, než ku ktorému patrí license key servera.

Riešenie: použite license key z rovnakého účtu, na ktorom ste skript kúpili, alebo skript na Cfx.re Portali preveďte. Server potom reštartujte.

Failed to verify protected resource …#

Príčina: súbory zašifrovaného skriptu sa pri prenose poškodili alebo chýbajú, najčastejšie súbor .fxap.

Riešenie: nahrajte resource znova celý, vrátane súboru .fxap a skrytých súborov (začínajú bodkou).

Unable to establish a connection to the database (…)!#

Príčina: oxmysql sa nepripojil k databáze. Kód v zátvorke hovorí prečo:

Riešenie: opravte set mysql_connection_string v server.cfg podľa návodu Databáza pre FiveM. Po oprave sa v konzole objaví Database server connection established!.

Server nie je v zozname serverov alebo je „súkromný“#

Príčina: aktívny riadok sv_master1 "", chýbajúci sets sv_projectName alebo sets sv_projectDesc, server nedostupný zvonku, alebo iba krátky čas od štartu.

Riešenie:

1. Overte, že sa na server dá pripojiť priamo: v hre F8 a connect <IP_ADRESA>:<PORT> (adresa zo záložky Sieť).
2. Zakomentujte riadok sv_master1 "" znakom #.
3. Doplňte sets sv_projectName "…" a sets sv_projectDesc "…".
4. Počkajte až 8 minút po štarte.

Server skontrolujete aj nástrojom CFX Resolver. Podrobnosti v návode server.cfg.

Connection rejected by server: Client/Server game build revision mismatch#

Príčina: hra hráča a server majú inú revíziu game buildu. Typicky krátko po aktualizácii GTA V alebo FiveM.

Riešenie: aktualizujte artefakty servera (návod). Hráč môže v klientovi FiveM prepnúť Update Channel (ozubené koleso › Game) na kanál, ktorý zodpovedá serveru. Často stačí počkať, kým aktualizácia dorazí všetkým.

Hráči sa pri pripájaní zaseknú na načítacej obrazovke#

Príčina:

• chyba v multicharacteri alebo databáze (postava sa nenačíta),
• veľké množstvo modelov na stiahnutie (autá, oblečenie, mapy) alebo pomalé sťahovanie,
• prvé pripojenie po zmene sv_enforceGameBuild (sťahuje sa DLC),
• skript načítacej obrazovky, ktorý sa nikdy neukončí.

Riešenie: pozrite sa do konzoly servera a do F8 u hráča, kde načítanie skončilo. Pri frameworku skontrolujte pripojenie k databáze. Pri Qboxe s vlastným multicharacterom nastavte setr loadscreen:externalShutdown false. Veľké balíčky áut a oblečenia skúste dočasne vypnúť a overte, či sa hráči dostanú ďalej.

Pripojenie skončí vypršaním času (timed out) alebo connection refused#

Príčina:

• port v endpoint_add_tcp a endpoint_add_udp nesedí s portom v záložke Sieť (častý prípad po nasadení receptu txAdminu, ktorý zapíše predvolený 30120),
• server sa nespustil celý (nenačítal server.cfg, žiadne resources nebežia),
• server je preťažený (procesor alebo RAM na limite) alebo práve padá,
• na vlastnom VPS blokuje port firewall.

Riešenie: porovnajte port v server.cfg s riadkom Adresa na pripojenie. V konzole overte, že sa resources spustili (Started resource …). Pod konzolou skontrolujte využitie RAM a procesora. Na VPS povoľte port TCP aj UDP vo firewalle (firewall).

Server artifact version is outdated (varovanie EOS alebo EOL)#

Príčina: server beží na starom builde FXServera. Artefakty staršie než 3 mesiace sa nedajú pripojiť zo zoznamu serverov.

Riešenie: aktualizujte artefakty na kanál Recommended (návod).

Native … is not supported, Error parsing script alebo Failed to load script#

Príčina: skript alebo framework používa funkcie, ktoré vaša verzia servera nepozná.

Riešenie: aktualizujte artefakty na Recommended. Keď to nestačí, na Latest.

txAdmin hlási pád alebo zamrznutie servera a reštartuje ho#

Príčina: server spadol alebo prestal odpovedať. txAdmin ho sám spustí znova. Najčastejšie ide o chybu skriptu (nekonečná slučka, veľký dopyt do databázy), nedostatok RAM alebo novo nainštalovaný resource.

Riešenie:

1. V txAdmine otvorte Live Console a System › Console Log a nájdite posledné chyby pred pádom.
2. Skontrolujte využitie RAM pod konzolou v zákazníckom účte. Keď sa drží pri limite, uberajte resources alebo prejdite na väčší balík (záložka Zmena balíka).
3. Ak pády začali po inštalácii alebo aktualizácii skriptu, skript vypnite (zakomentujte jeho ensure) a overte, či pády ustanú.

## [txAdmin CFG validator]: … v server.cfg#

Príčina: txAdmin zakomentoval riadok, ktorý v server.cfg nesmie byť, a za dvojbodku napísal dôvod. Najčastejšie:

• onesync MUST only be set in the txAdmin settings page. – OneSync sa pri txAdmine nastavuje v Settings › FXServer.
• you MUST NOT start/stop/ensure txadmin resources. – zmažte riadok ensure monitor (txAdmin sa spúšťa sám).
• the … port … is dedicated for txAdmin and CAN NOT be used for FXServer. – v endpoint_add_* je port txAdminu. Dajte tam port hry zo záložky Sieť.

Riešenie: opravte riadok podľa dôvodu a zakomentovaný riadok zmažte.

Your config file does not specify a valid endpoints for FXServer to use.#

Príčina: v server.cfg chýbajú riadky endpoint_add_tcp a endpoint_add_udp, alebo majú iný port.

Riešenie: na začiatok server.cfg doplňte oba riadky s portom zo záložky Sieť:

endpoint_add_tcp "0.0.0.0:<PORT>"
endpoint_add_udp "0.0.0.0:<PORT>"

Za <PORT> dosaďte číslo za dvojbodkou v riadku Adresa na pripojenie.

Nedá sa nastaviť viac než 48 slotov#

Príčina: viac než 48 hráčov vyžaduje predplatné Element Club Argentum na Cfx.re Portali. Predplatné samo počet slotov nezvýši.

Riešenie: po zakúpení predplatného zvýšte sv_maxclients v server.cfg (pri serveri bez txAdminu prípadne premennú so slotmi v záložke Nastavenia) a server reštartujte. Viac než 64 slotov vyžaduje OneSync on.

server thread hitch warning: timer interval of … milliseconds#

Príčina: jedno kolo servera trvalo dlhšie než 150 ms a server „zadrhol“. Pri štarte a načítaní resources je to normálne. Časté hlásenia za behu znamenajú, že niektorý skript robí náročnú prácu naraz (veľké dopyty do databázy, slučky cez všetkých hráčov alebo entity). Podobné hlásenia existujú aj pre sieťové (network thread) a synchronizačné (sync thread) vlákno.

Riešenie: nájdite vinníka profilerom: v konzole servera profiler record 500, po dokončení profiler saveJSON profil.json, súbor stiahnite v záložke Súbory a otvorte v nástrojoch pre vývojárov v Chrome (záložka Performance). Potom skript optimalizujte, aktualizujte alebo nahraďte. Pomôže aj kontrola využitia procesora pod konzolou.

Warning: sending large event … (… bytes). This may cause performance issues. Consider using latent events instead.#

Príčina: skript posiela hráčom veľké množstvo dát naraz v jednej udalosti. Hráčom to môže spôsobiť lagy a odpojenia.

Riešenie: zistite z názvu udalosti, o aký skript ide, a nahláste to autorovi. Veľké dáta sa majú posielať takzvanými latentnými udalosťami (po častiach).

Could not contact the server browser#

Príčina: server sa nemôže spojiť so službami Cfx.re, ktoré vedú zoznam serverov. Občasné hlásenie je neškodné, trvalé opakovanie znamená, že server zo zoznamu zmizne.

Riešenie: server reštartujte. Ak sa hlásenie opakuje, napíšte nám. Na vlastnom VPS overte, že firewall alebo ochrana proti DDoS prepúšťa adresy Cfx.re zo zoznamu static.cfx.re/ips.txt (otvorí sa v novom okne).

Can't restart a stopped resource.#

Príčina: príkazom restart ste chceli reštartovať resource, ktorý nebeží.

Riešenie: použite ensure <NAZEV>. Spustí resource, ktorý nebeží, a reštartuje ten, ktorý beží.

Varovanie Resource … does not specify an fx_version in fxmanifest.lua.#

Príčina: starší skript nemá v manifeste riadok fx_version.

Riešenie: na začiatok fxmanifest.lua doplňte fx_version 'cerulean' a game 'gta5'. Skript s __resource.lua namiesto fxmanifest.lua je veľmi starý, hľadajte novšiu verziu.

Auto alebo model sa v hre nenačíta#

Príčina: názov modelu v príkaze alebo skripte nesedí s názvom vo vehicles.meta, resource s modelom nebeží, chýbajú riadky data_file v manifeste, alebo model vyžaduje vyšší game build.

Riešenie: skontrolujte v konzole, že resource s modelom beží (Started resource …). Vo vehicles.meta nájdite presný názov modelu (modelName) a ten použite na spawn. Overte, že manifest obsahuje data_file pre vehicles.meta (FiveM resources).

Keď niečo nefunguje ďalej: kedy napísať podpore#

Napíšte nám (kontakty), keď:

• sa konzola v zákazníckom účte nenačíta alebo tlačidlá Spustiť a Reštartovať nereagujú,
• server nenabehne ani so základným receptom txAdminu bez ďalších skriptov,
• hráči sa nedostanú na port, aj keď server.cfg zodpovedá záložke Sieť,
• potrebujete prístup cez SFTP pre veľké súbory.

Pošlite názov alebo ID služby, čas problému, presný text chyby (skopírovaný z konzoly) a čo ste naposledy menili. Nikdy neposielajte license key ani heslo k databáze.

Ďalšie zdroje#

• FiveM: Server Issues (otvorí sa v novom okne)
• FiveM: Resource FAQ (otvorí sa v novom okne)
• FiveM: Server Commands (otvorí sa v novom okne)