Ovaj vodič pokriva rješenja za najčešće probleme s FiveM poslužiteljem — problemi s pristupom TXAdmin-u, greške CFX licence ključa, neuspjele veze s bazom podataka, rušenja poslužitelja, problemi s povezivanjem igrača i resursi koji se ne učitavaju. Za početno postavljanje poslužitelja, pogledajte Vodič za postavljanje FiveM poslužitelja.
Opći savjet za rješavanje problema: Uvijek najprije provjerite ispis GPanel konzole i TXAdmin zapise. Većina grešaka proizvodi jasnu poruku koja ukazuje na uzrok.
TXAdmin se ne učitava ili je nedostupan
- Provjerite radi li poslužitelj u GPanel-u — TXAdmin se pokreće samo kad je FiveM serverski proces aktivan.
- Provjerite GPanel konzolu za TXAdmin URL i port. TXAdmin port razlikuje se od porta igre.
- Provjerite koristite li
http://a nehttps://— TXAdmin prema zadanim postavkama ne koristi SSL. - Ako je TXAdmin ranije radio ali se prestao učitavati, pokušajte ponovno pokrenuti poslužitelj iz GPanel-a.
- Očistite predmemoriju preglednika ili pokušajte u anonimnom/privatnom prozoru.
Izgubili ste TXAdmin lozinku? Ako se ne možete prijaviti, možda ćete trebati izbrisati podatke TXAdmin profila i ponovno pokrenuti čarobnjak za postavljanje. Provjerite GPanel karticu Files za TXAdmin direktorij podataka i uklonite njegove datoteke profila, zatim ponovno pokrenite poslužitelj.
Greške CFX licence ključa
| Poruka greške | Uzrok | Rješenje |
|---|---|---|
Invalid license key |
Ključ je pogrešno kopiran ili sadrži dodatne razmake | Idite na Keymaster, potvrdite da je ključ aktivan i pažljivo ga ponovo kopirajte. Zalijepite ga u GPanel Startup varijablu i u sv_licenseKey u server.cfg. |
License key already in use |
Ključ je registriran na drugu IP adresu poslužitelja | Svaki ključ može se koristiti samo na jednom poslužitelju istovremeno. Opozovite stari ključ na Keymaster-u i generirajte novi s trenutnom IP adresom svog poslužitelja. |
Unable to verify license key |
Cfx.re autentifikacijski poslužitelji su privremeno nedostupni | Pričekajte nekoliko minuta i ponovno pokrenite poslužitelj. Provjerite status.cfx.re za ispade. |
Savjet: Provjerite je li ključ postavljen i u GPanel Startup varijabli i u
server.cfg (sv_licenseKey). Ovisno o vašoj konfiguraciji, poslužitelj može čitati iz jednog ili drugog.
Greške u vezi s bazom podataka
| Poruka greške | Uzrok | Rješenje |
|---|---|---|
Connection refused ili ETIMEDOUT |
Pogrešna adresa hosta ili port baze podataka | Dvaput provjerite adresu hosta i port baze podataka iz GPanel kartice Databases. Ne koristite localhost ili 127.0.0.1. |
Access denied |
Pogrešno korisničko ime ili lozinka | Kopirajte vjerodajnice izravno iz GPanel-a kako biste izbjegli pogreške u tipkanju. Lozinke razlikuju velika i mala slova. |
Unknown database |
Naziv baze podataka se ne podudara | Provjerite da naziv baze podataka u vašem connection stringu točno odgovara onome što je prikazano u GPanel-u. |
Dodatni koraci za rješavanje problema s bazom podataka:
- Ako koristite oxmysql, provjerite imate li
oxmysqlresurs u svojoj mapiresources/i da seensure oxmysqlpojavljuje u server.cfg prije bilo kojih resursa koji zahtijevaju bazu podataka. - Ako vaša lozinka sadrži posebne znakove poput
@,#ili%, URL-kodirajte ih u connection stringu (npr.@postaje%40). - Provjerite connection string za nedostajuće ili suvišne znakove — čak i jedan pogrešno postavljen znak uzrokovat će neuspjeh.
Ne koristite localhost. Poslužitelj baze podataka je odvojen od poslužitelja igre. Uvijek koristite punu adresu hosta prikazanu u GPanel kartici Databases.
Poslužitelj se ruši pri pokretanju
- Provjerite GPanel konzolu za poruke o greškama. Česti uzroci uključuju nedostajući ili pogrešno konfiguriran
server.cfg, nevažeći CFX licencni ključ ili neispravan resurs. - Pokušajte onemogućiti prilagođene resurse tako što ćete ih zakomentirati u server.cfg (dodajte
#ispred svakeensurelinije) i ponovno pokrenite. Dodajte ih natrag jedan po jedan kako biste identificirali problematični resurs. - Provjerite da portovi u
endpoint_add_tcpiendpoint_add_udpodgovaraju vašem GPanel dodijeljenom portu.
# 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
Binarna pretraga za problematične resurse: Ako imate mnogo resursa, zakomentirajte polovicu odjednom umjesto jednog po jednog. To znatno brže sužava problem.
Igrači se ne mogu povezati
- Potvrdite da poslužitelj prikazuje Running u GPanel-u.
- Provjerite IP i port — igrači trebaju koristiti port igre, ne TXAdmin port.
- Provjerite da
sv_maxclientsnije postavljen na 0 ili nerazumno nizak broj. - Ako koristite lozinku poslužitelja (
sv_passwordu server.cfg), provjerite da je igrači znaju. - Igrači moraju imati instaliran FiveM klijent — ne mogu se povezati koristeći obični GTA V pokretač.
- Provjerite GPanel karticu Network i potvrdite da portovi u
endpoint_add_tcpiendpoint_add_udpodgovaraju. Nepodudarnost će spriječiti povezivanje.
Poslužitelj se ne prikazuje u pregledniku? Novim poslužiteljima može trebati 5-15 minuta da se pojave na popisu FiveM poslužitelja. U međuvremenu koristite izravno povezivanje (
IP:PORT). Također provjerite da je vaš sv_licenseKey valjan.
Resursi se ne učitavaju
- Provjerite da se mapa resursa nalazi unutar direktorija
resources/(ili odgovarajuće podmape). - Provjerite da naziv mape točno odgovara
ensureliniji u server.cfg (razlikuje velika i mala slova). - Svaki resurs mora sadržavati valjan
fxmanifest.lua(ili stariji__resource.lua). Ako ova datoteka nedostaje, resurs se neće učitati. - Provjerite TXAdmin ili GPanel konzolu za poruke o greškama vezane uz resurs. Česte greške uključuju nedostajuće ovisnosti ili Lua sintaktičke pogreške.
- Ako resurs zahtijeva framework (ESX, QBCore), provjerite da je framework učitan prije resursa u server.cfg.
- Ako resurs zahtijeva bazu podataka, provjerite da je vaš MySQL resurs (oxmysql, mysql-async) učitan i da veza s bazom podataka radi.
Provjerite strukturu mapa. Česta pogreška je prijenos resursa koji rezultira dvostruko ugniježđenom mapom poput
resources/my-resource/my-resource/fxmanifest.lua. Manifest mora biti izravno unutar mape resursa: resources/my-resource/fxmanifest.lua.
Problemi s performansama poslužitelja
- Otvorite TXAdmin i provjerite Dashboard za metrike performansi (tick time, broj igrača, korištenje memorije).
- Zdrav FiveM poslužitelj trebao bi održavati serversko tick vrijeme (također zvano "hitch") ispod 20ms. Dosljedno premašivanje ove vrijednosti ukazuje da resurs troši previše procesorskog vremena.
- Koristite TXAdmin stranicu Resources za identificiranje resursa koji troše najviše serverskog vremena.
- Uklonite ili zamijenite loše optimizirane resurse. Besplatni resursi iz nepoznatih izvora često su uzrok problema s performansama.
- Smanjite broj učitanih resursa ako su ograničenja memorije ili procesora vašeg plana poslužitelja dosegnuta.
Pomoć
Ako ste isprobali gore navedena rješenja i još uvijek imate problema:
- Kopirajte potpunu poruku greške iz GPanel konzole ili TXAdmin zapisa.
- Zabilježite koje ste korake rješavanja problema već pokušali.
- Otvorite zahtjev za podršku na https://legionhosting.net/submitticket.php s tim informacijama. Naš tim će vam pomoći što je brže moguće.