Časté chyby FiveM serveru a jejich řešení

Většinu problémů FiveM serveru prozradí jediný řádek ve výpisu. Tady najdete nejčastější hlášky přesně tak, jak je uvidíte, s příčinou a postupem opravy. Hledejte podle textu chyby (Ctrl+F).

Kde hledat chyby#

Čtěte od první chyby. Další chyby jsou často jen její následek. Řádky ve žluté a červené barvě jsou varování a chyby.

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

Příčina: server nemá platný license key. Buď ho nedostal vůbec, nebo je neplatný, deaktivovaný či zkopírovaný s chybou.

Řešení: zkontrolujte řádek sv_licenseKey v server.cfg, který server opravdu načítá, a proměnnou s klíčem v záložce Nastavení. Na Cfx.re Portalu (otevře se v novém okně) ověřte, že má klíč stav Active. Podrobný postup: FiveM license key.

Couldn't find resource …#

Příčina: server nezná resource se jménem z ensure. Název složky nesedí (-main, velká písmena), fxmanifest.lua je o úroveň hlouběji, nebo jste skript nahráli za běhu bez příkazu refresh.

Řešení: přejmenujte složku přesně na název z ensure a zkontrolujte, že je v ní přímo fxmanifest.lua. Pak zadejte v konzoli refresh a ensure <NAZEV>, nebo server restartujte. Viz FiveM resources.

Could not find dependency … for resource …#

Příčina: skript potřebuje jiný resource (knihovnu, framework), který na serveru není.

Řešení: nainstalujte resource uvedený jako první v hlášce a jeho ensure dejte v server.cfg nad skript. Hláška Could not start dependency … znamená, že závislost existuje, ale sama spadla. Najděte v konzoli její chybu.

Couldn't start resource …#

Příčina: resource existuje, ale nespustil se. Skutečný důvod je v řádcích těsně nad touto hláškou: chybějící závislost, nesplněná podmínka (OneSync, game build, verze serveru) nebo chyba licence placeného skriptu.

Řešení: opravte příčinu z předchozích řádků a resource spusťte znovu příkazem ensure <NAZEV>.

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

Příčina: chyba v kódu skriptu. Hláška obsahuje resource, soubor, číslo řádku a popis, například attempt to index a nil value. Nejčastěji jde o špatné nastavení frameworku v config.lua, chybějící tabulku v databázi nebo starší verzi skriptu, než kterou framework čeká.

Řešení: zkontrolujte config.lua (správný framework), naimportujte SQL skriptu a aktualizujte skript i framework. Pokud chyba vznikla po úpravě souboru, vraťte úpravu.

You lack the required entitlement to use …#

Příčina: placený skript chráněný Asset Escrow je koupený na jiném účtu Cfx.re, než ke kterému patří license key serveru.

Řešení: použijte license key ze stejného účtu, na kterém jste skript koupili, nebo skript na Cfx.re Portalu převeďte. Server pak restartujte.

Failed to verify protected resource …#

Příčina: soubory zašifrovaného skriptu se při přenosu poškodily nebo chybí, nejčastěji soubor .fxap.

Řešení: nahrajte resource znovu celý, včetně souboru .fxap a skrytých souborů (začínají tečkou).

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

Příčina: oxmysql se nepřipojil k databázi. Kód v závorce říká proč:

Řešení: opravte set mysql_connection_string v server.cfg podle návodu Databáze pro FiveM. Po opravě se v konzoli objeví Database server connection established!.

Server není v seznamu serverů nebo je „soukromý“#

Příčina: aktivní řádek sv_master1 "", chybějící sets sv_projectName nebo sets sv_projectDesc, server nedostupný zvenku, nebo jen krátká doba od startu.

Řešení:

1. Ověřte, že se na server dá připojit přímo: ve hře F8 a connect <IP_ADRESA>:<PORT> (adresa ze záložky Síť).
2. Zakomentujte řádek sv_master1 "" znakem #.
3. Doplňte sets sv_projectName "…" a sets sv_projectDesc "…".
4. Počkejte až 8 minut po startu.

Server zkontrolujete i nástrojem CFX Resolver. Podrobnosti v návodu server.cfg.

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

Příčina: hra hráče a server mají jinou revizi game buildu. Typicky krátce po aktualizaci GTA V nebo FiveM.

Řešení: aktualizujte artefakty serveru (návod). Hráč může v klientu FiveM přepnout Update Channel (ozubené kolo › Game) na kanál, který odpovídá serveru. Často stačí počkat, než aktualizace dorazí všem.

Hráči se při připojování zaseknou na načítací obrazovce#

Příčina:

• chyba v multicharacteru nebo databázi (postava se nenačte),
• velké množství modelů ke stažení (auta, oblečení, mapy) nebo pomalé stahování,
• první připojení po změně sv_enforceGameBuild (stahuje se DLC),
• skript načítací obrazovky, který se nikdy neukončí.

Řešení: podívejte se do konzole serveru a do F8 u hráče, kde načítání skončilo. U frameworku zkontrolujte připojení k databázi. U Qboxu s vlastním multicharacterem nastavte setr loadscreen:externalShutdown false. Velké balíčky aut a oblečení zkuste dočasně vypnout a ověřte, jestli se hráči dostanou dál.

Připojení skončí vypršením času (timed out) nebo connection refused#

Příčina:

• port v endpoint_add_tcp a endpoint_add_udp nesedí s portem v záložce Síť (častý případ po nasazení receptu txAdminu, který zapíše výchozí 30120),
• server se nespustil celý (nenačetl server.cfg, žádné resources neběží),
• server je přetížený (procesor nebo RAM na limitu) nebo právě padá,
• na vlastní VPS blokuje port firewall.

Řešení: porovnejte port v server.cfg s řádkem Adresa pro připojení. V konzoli ověřte, že se resources spustily (Started resource …). Pod konzolí zkontrolujte využití RAM a procesoru. Na VPS povolte port TCP i UDP ve firewallu (firewall).

Server artifact version is outdated (varování EOS nebo EOL)#

Příčina: server běží na starém buildu FXServeru. Artefakty starší než 3 měsíce nejdou připojit ze seznamu serverů.

Řešení: aktualizujte artefakty na kanál Recommended (návod).

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

Příčina: skript nebo framework používá funkce, které vaše verze serveru nezná.

Řešení: aktualizujte artefakty na Recommended. Když to nestačí, na Latest.

txAdmin hlásí pád nebo zamrznutí serveru a restartuje ho#

Příčina: server spadl nebo přestal odpovídat. txAdmin ho sám spustí znovu. Nejčastěji jde o chybu skriptu (nekonečná smyčka, velký dotaz do databáze), nedostatek RAM nebo nově nainstalovaný resource.

Řešení:

1. V txAdminu otevřete Live Console a System › Console Log a najděte poslední chyby před pádem.
2. Zkontrolujte využití RAM pod konzolí v zákaznické zóně. Když se drží u limitu, ubírejte resources nebo přejděte na větší balíček (záložka Změna balíčku).
3. Pokud pády začaly po instalaci nebo aktualizaci skriptu, skript vypněte (zakomentujte jeho ensure) a ověřte, jestli pády ustanou.

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

Příčina: txAdmin zakomentoval řádek, který v server.cfg nesmí být, a za dvojtečku napsal důvod. Nejčastěji:

• onesync MUST only be set in the txAdmin settings page. – OneSync se u txAdminu nastavuje v Settings › FXServer.
• you MUST NOT start/stop/ensure txadmin resources. – smažte řádek ensure monitor (txAdmin se spouští sám).
• the … port … is dedicated for txAdmin and CAN NOT be used for FXServer. – v endpoint_add_* je port txAdminu. Dejte tam port hry ze záložky Síť.

Řešení: opravte řádek podle důvodu a zakomentovaný řádek smažte.

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

Příčina: v server.cfg chybí řádky endpoint_add_tcp a endpoint_add_udp, nebo mají jiný port.

Řešení: na začátek server.cfg doplňte oba řádky s portem ze záložky Síť:

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

Za <PORT> dosaďte číslo za dvojtečkou v řádku Adresa pro připojení.

Nejde nastavit víc než 48 slotů#

Příčina: víc než 48 hráčů vyžaduje předplatné Element Club Argentum na Cfx.re Portalu. Předplatné samo počet slotů nezvýší.

Řešení: po zakoupení předplatného zvyšte sv_maxclients v server.cfg (u serveru bez txAdminu případně proměnnou se sloty v záložce Nastavení) a server restartujte. Víc než 64 slotů vyžaduje OneSync on.

server thread hitch warning: timer interval of … milliseconds#

Příčina: jedno kolo serveru trvalo déle než 150 ms a server „zadrhl“. Při startu a načítání resources je to normální. Časté hlášky za běhu znamenají, že některý skript dělá náročnou práci najednou (velké dotazy do databáze, smyčky přes všechny hráče nebo entity). Podobné hlášky existují i pro síťové (network thread) a synchronizační (sync thread) vlákno.

Řešení: najděte viníka profilerem: v konzoli serveru profiler record 500, po dokončení profiler saveJSON profil.json, soubor stáhněte v záložce Soubory a otevřete v nástrojích pro vývojáře v Chrome (záložka Performance). Pak skript optimalizujte, aktualizujte nebo nahraďte. Pomůže i kontrola využití procesoru pod konzolí.

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

Příčina: skript posílá hráčům velké množství dat najednou v jedné události. Hráčům to může způsobit lagy a odpojení.

Řešení: zjistěte z názvu události, o jaký skript jde, a nahlaste to autorovi. Velká data se mají posílat takzvanými latentními událostmi (po částech).

Could not contact the server browser#

Příčina: server se nemůže spojit se službami Cfx.re, které vedou seznam serverů. Občasná hláška je neškodná, trvalé opakování znamená, že server ze seznamu zmizí.

Řešení: server restartujte. Pokud se hláška opakuje, napište nám. Na vlastní VPS ověřte, že firewall nebo ochrana proti DDoS propouští adresy Cfx.re ze seznamu static.cfx.re/ips.txt (otevře se v novém okně).

Can't restart a stopped resource.#

Příčina: příkazem restart jste chtěli restartovat resource, který neběží.

Řešení: použijte ensure <NAZEV>. Spustí resource, který neběží, a restartuje ten, který běží.

Varování Resource … does not specify an fx_version in fxmanifest.lua.#

Příčina: starší skript nemá v manifestu řádek fx_version.

Řešení: na začátek fxmanifest.lua doplňte fx_version 'cerulean' a game 'gta5'. Skript s __resource.lua místo fxmanifest.lua je hodně starý, hledejte novější verzi.

Auto nebo model se ve hře nenačte#

Příčina: název modelu v příkazu nebo skriptu nesedí s názvem ve vehicles.meta, resource s modelem neběží, chybí řádky data_file v manifestu, nebo model vyžaduje vyšší game build.

Řešení: zkontrolujte v konzoli, že resource s modelem běží (Started resource …). Ve vehicles.meta najděte přesný název modelu (modelName) a ten použijte pro spawn. Ověřte, že manifest obsahuje data_file pro vehicles.meta (FiveM resources).

Když něco nefunguje dál: kdy napsat podpoře#

Napište nám (kontakty), když:

• se konzole v zákaznické zóně nenačte nebo tlačítka Spustit a Restartovat nereagují,
• server nenaběhne ani se základním receptem txAdminu bez dalších skriptů,
• hráči se nedostanou na port, i když server.cfg odpovídá záložce Síť,
• potřebujete přístup přes SFTP pro velké soubory.

Pošlete název nebo ID služby, čas problému, přesný text chyby (zkopírovaný z konzole) a co jste naposledy měnili. Nikdy neposílejte license key ani heslo k databázi.

Další zdroje#

• FiveM: Server Issues (otevře se v novém okně)
• FiveM: Resource FAQ (otevře se v novém okně)
• FiveM: Server Commands (otevře se v novém okně)