Tento průvodce pokrývá řešení nejčastějších problémů s FiveM serverem — problémy s přístupem k TXAdmin, chyby CFX licenčního klíče, selhání připojení k databázi, pády serveru, problémy s připojením hráčů a nenačítající se zdroje. Pro počáteční nastavení serveru viz Průvodce nastavením FiveM serveru.
Obecný tip pro řešení problémů: Vždy nejprve zkontrolujte výstup konzole GPanel a logy TXAdmin. Většina chyb vytvoří jasnou zprávu, která ukazuje na příčinu.
TXAdmin se nenačítá nebo je nedostupný
- Ověřte, že server běží v GPanel — TXAdmin se spustí pouze tehdy, když je proces FiveM serveru aktivní.
- Zkontrolujte konzoli GPanel pro URL a port TXAdmin. Port TXAdmin se liší od herního portu.
- Ujistěte se, že používáte
http://a nehttps://— TXAdmin ve výchozím nastavení nepoužívá SSL. - Pokud TXAdmin dříve fungoval, ale přestal se načítat, zkuste restartovat server z GPanel.
- Vymažte mezipaměť prohlížeče nebo zkuste anonymní/soukromé okno.
Ztratili jste heslo k TXAdmin? Pokud se nemůžete přihlásit, možná budete muset smazat data profilu TXAdmin a znovu spustit průvodce nastavením. Zkontrolujte záložku Files v GPanel pro datový adresář TXAdmin a odstraňte jeho soubory profilu, poté restartujte server.
Chyby CFX Licenčního Klíče
| Chybová zpráva | Příčina | Řešení |
|---|---|---|
Invalid license key |
Klíč zkopírován nesprávně nebo obsahuje přebytečné mezery | Přejděte na Keymaster, ověřte, že je klíč aktivní, a znovu ho pečlivě zkopírujte. Vložte ho jak do proměnné GPanel Startup, tak do sv_licenseKey v server.cfg. |
License key already in use |
Klíč je registrován na jinou IP adresu serveru | Každý klíč lze použít pouze na jednom serveru najednou. Zrušte starý klíč na Keymaster a vygenerujte nový s aktuální IP adresou serveru. |
Unable to verify license key |
Autentizační servery Cfx.re jsou dočasně nedostupné | Počkejte několik minut a restartujte server. Zkontrolujte status.cfx.re pro případné výpadky. |
Tip: Ujistěte se, že klíč je nastaven jak v proměnné GPanel Startup, tak v
server.cfg (sv_licenseKey). V závislosti na vaší konfiguraci může server číst z jednoho nebo druhého.
Chyby Připojení k Databázi
| Chybová zpráva | Příčina | Řešení |
|---|---|---|
Connection refused nebo ETIMEDOUT |
Špatná adresa nebo port databázového hostitele | Znovu zkontrolujte adresu a port databázového hostitele ze záložky Databases v GPanel. Nepoužívejte localhost nebo 127.0.0.1. |
Access denied |
Špatné uživatelské jméno nebo heslo | Zkopírujte přihlašovací údaje přímo z GPanel, abyste předešli překlepům. Hesla rozlišují velká a malá písmena. |
Unknown database |
Název databáze neodpovídá | Ujistěte se, že název databáze ve vašem připojovacím řetězci přesně odpovídá tomu, co je zobrazeno v GPanel. |
Další kroky pro řešení problémů s databází:
- Pokud používáte oxmysql, ujistěte se, že máte zdroj
oxmysqlve složceresources/a žeensure oxmysqlje v server.cfg uvedeno před všemi zdroji, které vyžadují databázi. - Pokud vaše heslo obsahuje speciální znaky jako
@,#nebo%, URL-enkódujte je v připojovacím řetězci (např.@se změní na%40). - Zkontrolujte, zda v připojovacím řetězci nechybí nebo nepřebývají znaky — i jeden špatně umístěný znak způsobí selhání.
Nepoužívejte localhost. Databázový server je oddělený od herního serveru. Vždy použijte úplnou adresu hostitele zobrazenou v záložce Databases v GPanel.
Server padá při spuštění
- Zkontrolujte konzoli GPanel pro chybové zprávy. Běžné příčiny zahrnují chybějící nebo špatně nakonfigurovaný
server.cfg, neplatný CFX licenční klíč nebo poškozený zdroj. - Zkuste deaktivovat vlastní zdroje jejich zakomentováním v server.cfg (přidejte
#před každý řádekensure) a restartujte. Přidávejte je zpět jeden po druhém pro identifikaci problematického zdroje. - Ujistěte se, že porty v
endpoint_add_tcpaendpoint_add_udpodpovídají portu přiřazenému v GPanel.
# Comment out resources to isolate the problem
#ensure suspicious-resource
#ensure another-resource
# Keep core resources enabled
ensure mapmanager
ensure spawnmanager
ensure sessionmanager
ensure hardcap
ensure chat
Binární hledání špatných zdrojů: Pokud máte mnoho zdrojů, zakomentujte polovinu najednou místo jednoho po druhém. Tím problém zúžíte mnohem rychleji.
Hráči se nemohou připojit
- Potvrďte, že server zobrazuje stav Running v GPanel.
- Ověřte IP adresu a port — hráči by měli používat herní port, nikoli port TXAdmin.
- Zkontrolujte, že
sv_maxclientsnení nastaveno na 0 nebo nepřiměřeně nízké číslo. - Pokud používáte heslo serveru (
sv_passwordv server.cfg), ujistěte se, že ho hráči znají. - Hráči musí mít nainstalovaného FiveM klienta — nemohou se připojit pomocí běžného spouštěče GTA V.
- Zkontrolujte záložku Network v GPanel a ověřte, že porty v
endpoint_add_tcpaendpoint_add_udpodpovídají. Nesoulad zabrání připojení.
Server není v prohlížeči? Novým serverům může trvat 5–15 minut, než se objeví v seznamu FiveM serverů. Mezitím použijte přímé připojení (
IP:PORT). Ověřte také, že váš sv_licenseKey je platný.
Zdroje se nenačítají
- Zkontrolujte, že složka zdroje je uvnitř adresáře
resources/(nebo příslušné podsložky). - Ověřte, že název složky přesně odpovídá řádku
ensurev server.cfg (rozlišují se velká a malá písmena). - Každý zdroj musí obsahovat platný soubor
fxmanifest.lua(nebo starší__resource.lua). Pokud tento soubor chybí, zdroj se nenačte. - Zkontrolujte konzoli TXAdmin nebo GPanel pro chybové zprávy související se zdrojem. Běžné chyby zahrnují chybějící závislosti nebo syntaktické chyby v Lua.
- Pokud zdroj vyžaduje framework (ESX, QBCore), ujistěte se, že je framework načten před tímto zdrojem v server.cfg.
- Pokud zdroj vyžaduje databázi, ujistěte se, že váš MySQL zdroj (oxmysql, mysql-async) je načten a připojení k databázi funguje.
Zkontrolujte strukturu složek. Častou chybou je nahrání zdroje s výsledkem dvojitě vnořené složky jako
resources/my-resource/my-resource/fxmanifest.lua. Manifest musí být přímo uvnitř složky zdroje: resources/my-resource/fxmanifest.lua.
Problémy s výkonem serveru
- Otevřete TXAdmin a zkontrolujte Dashboard pro metriky výkonu (tick time, počet hráčů, využití paměti).
- Zdravý FiveM server by měl udržovat server tick time (také nazývaný "hitch") pod 20ms. Konzistentní špičky nad touto hodnotou naznačují, že nějaký zdroj využívá příliš mnoho výpočetního času.
- Pomocí stránky Resources v TXAdmin identifikujte, které zdroje spotřebovávají nejvíce serverového času.
- Odstraňte nebo nahraďte špatně optimalizované zdroje. Bezplatné zdroje z neznámých zdrojů jsou často příčinou problémů s výkonem.
- Snižte počet načtených zdrojů, pokud dosahujete limitů paměti nebo CPU vašeho serverového plánu.
Získání Pomoci
Pokud jste vyzkoušeli výše uvedená řešení a stále máte problémy:
- Zkopírujte úplnou chybovou zprávu z konzole GPanel nebo logu TXAdmin.
- Poznamenejte si, které kroky řešení problémů jste již vyzkoušeli.
- Otevřete tiket podpory na https://legionhosting.net/submitticket.php s těmito informacemi. Náš tým vám pomůže co nejrychleji.