Ez az útmutató a leggyakoribb FiveM szerver problémák megoldásait tartalmazza — TXAdmin hozzáférési problémák, CFX licenckulcs hibák, adatbázis kapcsolódási hibák, szerver összeomlások, játékos csatlakozási problémák és nem betöltődő resource-ok. A szerver alapbeállításáért lásd a FiveM szerver beállítási útmutató cikket.

A TXAdmin nem töltődik be vagy nem elérhető

• Ellenőrizd, hogy a szerver fut-e a GPanel-ben — a TXAdmin csak akkor indul el, ha a FiveM szerver folyamat aktív.
• Ellenőrizd a GPanel konzolon a TXAdmin URL-t és portot. A TXAdmin port különbözik a játékporttól.
• Győződj meg róla, hogy http://-t használsz, nem https://-t — a TXAdmin alapértelmezetten nem használ SSL-t.
• Ha a TXAdmin korábban működött, de már nem töltődik be, próbáld meg újraindítani a szervert a GPanel-ből.
• Töröld a böngésző gyorsítótárat vagy próbálj inkognitó/privát ablakot.

CFX licenckulcs hibák

Adatbázis kapcsolódási hibák

További adatbázis hibaelhárítási lépések:

• Ha oxmysql-t használsz, győződj meg róla, hogy az oxmysql resource megvan a resources/ mappádban, és az ensure oxmysql a server.cfg-ben minden adatbázist igénylő resource előtt szerepel.
• Ha a jelszavad speciális karaktereket tartalmaz, mint @, # vagy %, URL-kódold őket a kapcsolati karakterláncban (pl. a @ %40 lesz).
• Ellenőrizd a kapcsolati karakterláncot hiányzó vagy felesleges karakterekre — egyetlen rosszul elhelyezett karakter is hibát okoz.

A szerver összeomlik indításkor

• Ellenőrizd a GPanel konzolt hibaüzenetekért. Gyakori okok közé tartozik a hiányzó vagy rosszul konfigurált server.cfg, érvénytelen CFX licenckulcs vagy egy hibás resource.
• Próbáld kikapcsolni az egyéni resource-okat úgy, hogy kikommentezed őket a server.cfg-ben (adj hozzá #-t minden ensure sor elé) és indítsd újra. Egyenként add vissza őket a problémás resource azonosításához.
• Győződj meg róla, hogy az endpoint_add_tcp és endpoint_add_udp portjai megegyeznek a GPanel-ben hozzárendelt porttal.

# 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

A játékosok nem tudnak csatlakozni

• Erősítsd meg, hogy a szerver Running állapotban van a GPanel-ben.
• Ellenőrizd az IP-t és portot — a játékosoknak a játékportot kell használniuk, nem a TXAdmin portot.
• Ellenőrizd, hogy az sv_maxclients nincs-e 0-ra vagy ésszerűtlenül alacsony számra állítva.
• Ha szerver jelszót használsz (sv_password a server.cfg-ben), győződj meg róla, hogy a játékosok ismerik.
• A játékosoknak telepítve kell lennie a FiveM kliensnek — nem tudnak csatlakozni a sima GTA V indítóval.
• Ellenőrizd a GPanel Network fülét, és erősítsd meg, hogy az endpoint_add_tcp és endpoint_add_udp portjai megegyeznek. Az eltérés megakadályozza a csatlakozást.

A resource-ok nem töltődnek be

• Ellenőrizd, hogy a resource mappa a resources/ könyvtáron belül van (vagy egy megfelelő almappában).
• Ellenőrizd, hogy a mappa neve pontosan megegyezik az ensure sorral a server.cfg-ben (kis- és nagybetű érzékeny).
• Minden resource-nak tartalmaznia kell egy érvényes fxmanifest.lua (vagy a régebbi __resource.lua) fájlt. Ha ez a fájl hiányzik, a resource nem fog betöltődni.
• Ellenőrizd a TXAdmin vagy GPanel konzolt a resource-hoz kapcsolódó hibaüzenetekért. Gyakori hibák közé tartoznak a hiányzó függőségek vagy Lua szintaxis hibák.
• Ha a resource keretrendszert igényel (ESX, QBCore), győződj meg róla, hogy a keretrendszer a resource előtt van betöltve a server.cfg-ben.
• Ha a resource adatbázist igényel, győződj meg róla, hogy a MySQL resource-od (oxmysql, mysql-async) betöltődik és az adatbázis kapcsolat működik.

Szerver teljesítmény problémák

• Nyisd meg a TXAdmin-t és ellenőrizd a Dashboard-on a teljesítmény mutatókat (tick idő, játékosszám, memória használat).
• Egy egészséges FiveM szerver tick ideje (más néven "hitch") 20ms alatt kell maradjon. Az ennél magasabb állandó kiugrások arra utalnak, hogy egy resource túl sok feldolgozási időt használ.
• Használd a TXAdmin Resources oldalát annak azonosítására, hogy mely resource-ok fogyasztják a legtöbb szerver időt.
• Távolítsd el vagy cseréld ki a rosszul optimalizált resource-okat. Az ismeretlen forrásokból származó ingyenes resource-ok gyakran okoznak teljesítmény problémákat.
• Csökkentsd a betöltött resource-ok számát, ha a szerver csomagod memória- vagy CPU-korlátai elérésre kerülnek.

Segítség kérése

Ha kipróbáltad a fenti megoldásokat és továbbra is problémákat tapasztalsz:

1. Másold ki a teljes hibaüzenetet a GPanel konzolból vagy a TXAdmin naplóból.
2. Jegyezd fel, milyen hibaelhárítási lépéseket próbáltál már.
3. Nyiss egy support jegyet itt: https://legionhosting.net/submitticket.php ezekkel az információkkal. Csapatunk a lehető leggyorsabban segít.

Kapcsolódó cikkek

• FiveM szerver beállítási útmutató
• FiveM resource-ok, scriptek és adatbázis beállítás
• Hogyan találd meg a szervered IP-jét és portját
• Szerver indítási útmutató