Vodič za rešavanje uobičajenih problema sa RedM serverom, uključujući greške licencnog ključa, vidljivost u pregledniku servera, neuspehe resursa, klijentske konekcije, probleme sa bazom podataka i optimizaciju performansi. Za uputstva o početnom podešavanju, pogledajte naš Vodič za podešavanje RedM servera.
Greške licencnog ključa
Problemi sa licencnim ključem su najčešći problem pri pokretanju novog RedM servera. Evo tipičnih grešaka i njihovih rešenja:
"Invalid license key" ili "Could not authenticate"
| Uzrok | Rešenje |
|---|---|
| Licencni ključ je pogrešno otkucan ili ima dodatne razmake | Kopirajte ključ direktno iz Keymaster-a. Uklonite sve vodeće/završne razmake iz CFX_LICENSE startup promenljive u GPanel-u ili iz linije sv_licenseKey u server.cfg. |
| Neusklađenost IP adrese | Ključ je registrovan na drugu IP adresu od stvarne IP adrese vašeg servera. Idite na Keymaster, proverite registrovanu IP adresu i ažurirajte je da se poklapa sa IP adresom vašeg servera prikazanom u GPanel-u. |
| Ključ je postavljen i u GPanel-u i u server.cfg sa različitim vrednostima | Uverite se da je ključ dosledan. Najbolje je da ga postavite u GPanel startup promenljivu i pustite da egg obradi njegovo prosleđivanje serveru. Uklonite ili zakomentarišite sv_licenseKey iz server.cfg ako ga GPanel obrađuje. |
| Problem sa Cfx.re nalogom ili opozvan ključ | Prijavite se na Keymaster i proverite da li je ključ i dalje aktivan. Generišite novi ključ ako je stari obrisan ili istekao. |
| Keymaster servis je privremeno nedostupan | Proverite Cfx.re stranicu statusa za prekide. Sačekajte i pokušajte ponovo kasnije. |
Važno: Ako ste nedavno dobili novi server ili se IP adresa vašeg servera promenila (npr. nakon migracije čvora), morate ažurirati IP u Keymaster-u ili generisati novi licencni ključ. Stari ključ neće raditi na drugoj IP adresi.
Server se ne pojavljuje u pregledniku
Ako vaš server radi, ali igrači ne mogu da ga pronađu u RedM pregledniku servera:
Lista za proveru
- Sačekajte najmanje 5 minuta. Nakon pokretanja, serveru je potrebno vreme da se registruje na Cfx.re master listi servera. Novi serveri mogu da se pojave tek nakon nekoliko minuta.
- Proverite da li je licencni ključ važeći. Server neće biti izlistan bez ispravnog licencnog ključa. Proverite konzolu servera za greške vezane za licencu.
- Proverite konfiguraciju endpoint-a. Uverite se da
endpoint_add_tcpiendpoint_add_udpuserver.cfgkoriste ispravan port:
Port se mora poklapati sa onim koji je dodeljen u GPanel-u.endpoint_add_tcp "0.0.0.0:30120" endpoint_add_udp "0.0.0.0:30120" - Proverite "sv_master1" ili podešavanja listiranja. Uverite se da niste slučajno postavili da se server ne listira sam. Ne bi trebalo da bude
sv_master1 ""u vašoj konfiguraciji (ovo onemogućava registraciju na master listi). - Proverite da li server zaista radi. Proverite GPanel konzolu. Ako se server srušio ili zaustavio, neće se pojaviti u pregledniku.
- Pokušajte direktno povezivanje. Čak i ako server nije u pregledniku, direktno povezivanje bi trebalo da radi. Neka igrač pritisne F8 u RedM-u i ukuca:
connect YOUR_SERVER_IP:PORT
Savet: Možete proveriti da li je vaš server dostupan korišćenjem Cfx.re pretrage servera. Pokušajte da navigirate do
http://YOUR_SERVER_IP:PORT/info.json u veb pregledaču. Ako server radi i dostupan je, vratiće JSON odgovor sa informacijama o serveru.
Neuspesi pri učitavanju resursa
Greške resursa su uobičajene pri dodavanju novih skripti ili okvira na vaš server. Evo najčešćih problema:
"Could not find resource [resource_name]"
- Folder resursa ne postoji u direktorijumu
resources/, ili je na pogrešnoj lokaciji. - Naziv foldera se ne poklapa sa nazivom korišćenim u
ensure. Nazivi resursa razlikuju velika i mala slova. - Rešenje: Proverite da li folder resursa postoji i da li se naziv u
server.cfgtačno poklapa. Koristite GPanel menadžer fajlova ili SFTP da proverite.
"Failed to load resource [resource_name]: manifest error"
- Fajl
fxmanifest.luaili__resource.luaresursa ima sintaksnu grešku. - Manifest referencira fajlove koji ne postoje u folderu resursa.
- Rešenje: Otvorite fajl manifesta i proverite da li ima grešaka u kucanju, nedostajućih zareza ili referenci na nepostojeće fajlove. Proverite konzolu servera za tačan broj linije greške.
"Error loading script [filename]: [error details]"
- Lua, C# ili JavaScript fajl unutar resursa ima sintaksnu grešku ili grešku tokom rada.
- Rešenje: Pročitajte celu poruku o grešci u konzoli. Sadržaće naziv fajla i broj linije. Uobičajeni uzroci uključuju:
- Nedostajuće zavisnosti (drugi resurs koji se mora učitati prvi)
- Zastareo resurs koji nije kompatibilan sa trenutnom verzijom RedM servera
- Netačne vrednosti konfiguracije u konfiguracionom fajlu resursa
Problemi sa redosledom učitavanja resursa
Resursi u server.cfg učitavaju se redosledom kojim se pojavljuju. Ako resurs zavisi od drugog (npr. vorp_inventory zavisi od vorp_core), zavisnost mora biti navedena prva:
# Correct order - dependencies first
ensure oxmysql
ensure vorp_core
ensure vorp_inventory
ensure vorp_stores
# Wrong order - will cause errors
# ensure vorp_inventory <-- depends on vorp_core
# ensure vorp_core <-- loaded too late
Upozorenje: Ako se resurs ne učita, svi resursi koji od njega zavise takođe će zakazati. Uvek pažljivo proverite izlaz konzole da biste identifikovali osnovni uzrok, koji je obično prva greška koja se pojavi.
Problemi sa klijentskom konekcijom
Kada igrači ne mogu da se povežu na vaš server:
"Connection timed out" / "Failed to connect"
| Uzrok | Rešenje |
|---|---|
| Server ne radi | Proverite GPanel konzolu da potvrdite da je server na mreži i da se nije srušio. |
| Pogrešan IP ili port | Proverite da li igrač koristi ispravan IP i port iz GPanel-a. Pogledajte Kako da pronađete IP adresu i port svog servera. |
| Pogrešna konfiguracija endpoint-a | Uverite se da endpoint_add_tcp i endpoint_add_udp u server.cfg koriste port 0.0.0.0:PORT gde se PORT poklapa sa GPanel-om. |
| Server je pun | Proverite da li je dostignut sv_maxclients. Povećajte vrednost ako vaš hosting plan to dozvoljava. |
"Connection rejected by server"
- Lozinka servera: Ako je
sv_passwordpostavljen, igrač mora uneti ispravnu lozinku. - Whitelist/allowlist resurs: Ako imate omogućen whitelist resurs, igrač mora biti odobren pre povezivanja.
- Ban: Igrač je možda banovan. Proverite svoju listu banova ili bazu podataka za njegove identifikatore.
Klijent se ruši pri povezivanju
- Resurs na serveru šalje loše podatke ili ima grešku u skripti na strani klijenta koja ruši klijent.
- Rešenje: Onemogućite nedavno dodate resurse jedan po jedan da biste identifikovali problematičan. Proverite konzolu servera za greške tokom klijentske konekcije.
- Uverite se da je RedM klijent igrača ažuriran.
Greške "Could not download file"
- Server pokušava da pošalje veliki fajl (npr. streaming sredstvo) koji prelazi limite prenosa ili je konekcija nestabilna.
- Rešenje: Smanjite veličinu streamovanih sredstava, koristite CDN/eksterno hostovanje za velike fajlove ako je podržano, ili neka igrač ponovo pokuša povezivanje.
Problemi sa bazom podataka (MySQL / oxmysql)
Većina RedM rolplej okvira koristi MySQL za trajno čuvanje podataka. Najčešći konektor za bazu podataka je oxmysql.
Greške neuspele konekcije
Ako oxmysql (ili drugi MySQL konektor) ne uspe da se poveže, proverite sledeće:
# Typical oxmysql connection string in server.cfg
set mysql_connection_string "mysql://user:password@host:3306/database_name?charset=utf8mb4"| Greška | Rešenje |
|---|---|
ECONNREFUSED ili "Connection refused" |
MySQL server ne radi, host/port je pogrešan, ili MySQL server ne prihvata eksterne konekcije. Proverite host, port i da li je vaš server baze podataka na mreži. |
ER_ACCESS_DENIED_ERROR |
Pogrešno korisničko ime ili lozinka u stringu konekcije. Dvaput proverite kredencijale u panelu za hostovanje baze podataka. |
ER_BAD_DB_ERROR |
Naziv baze podataka ne postoji. Prvo napravite bazu podataka kroz svoj panel za upravljanje bazom podataka (phpMyAdmin, itd.). |
ETIMEDOUT |
Server baze podataka je nedostupan. Proverite da li postoje pravila zaštitnog zida koja blokiraju konekciju, ili da li je host baze podataka ispravan. |
| "Too many connections" | Baza podataka je dostigla svoj maksimalni limit konekcija. Ovo se može desiti ako resursi pravilno ne zatvaraju konekcije, ili ako je limit prenizak. Ponovo pokrenite server i proverite svoje MySQL max_connections podešavanje. |
Savet: Ako su vaš RedM server i MySQL baza podataka na istoj mašini, koristite
localhost ili 127.0.0.1 kao host. Ako su na različitim serverima, koristite IP adresu servera baze podataka i uverite se da MySQL korisnik ima privilegije za udaljeno povezivanje.
Nedostajuće tabele ili greške šeme
Rolplej okviri često zahtevaju da se tabele baze podataka podese pre nego što mogu da funkcionišu:
- Proverite dokumentaciju okvira ili GitHub repozitorijum za SQL fajlove za uvoz (često nazvane
database.sql,schema.sqlili slično). - Uvezite SQL fajl u svoju bazu podataka koristeći phpMyAdmin ili MySQL klijent.
- Neki okviri automatski kreiraju tabele pri prvom pokretanju. Uverite se da korisnik baze podataka ima
CREATE TABLEprivilegije.
Problemi sa performansama
Ako vaš RedM server doživljava lag, nizak tick rate ili generalno loše performanse:
Identifikovanje problema sa performansama
Proverite konzolu servera za upozorenja o performansama. RedM serveri ciljaju tick rate od oko 30-64 tika u sekundi. Ovo možete pratiti pomoću:
- txAdmin kontrolne table: Ako je txAdmin dostupan, prikazuje metrike performansi servera u realnom vremenu.
- Konzole servera: Pazite na upozorenja "slow tick" ili "resource hitch".
- resmon komande: Ukucajte
resmon 1u konzoli servera (ili F8 konzoli) da omogućite monitor resursa, koji prikazuje CPU vreme po resursu.
Uobičajena rešenja za performanse
| Problem | Rešenje |
|---|---|
| Visoko korišćenje CPU-a od strane određenog resursa | Koristite resmon 1 da identifikujete resurs. Razmotrite zamenu optimizovanijom alternativom ili kontaktirajte programera resursa. |
| Previše učitanih resursa | Svaki resurs troši serverske resurse. Proverite svoju listu resursa i uklonite sve koji su nekorišćeni ili suvišni. |
| Usko grlo upita baze podataka | Spori ili neindeksirani upiti baze podataka mogu uzrokovati zastoje servera. Proverite oxmysql upozorenja o sporim upitima u konzoli. Dodajte indekse na kolone koje se često upituju. |
| Visok broj igrača koji uzrokuje lag | Smanjite sv_maxclients na nivo koji hardver vašeg servera može da podnese. Razmotrite nadogradnju hosting plana za više resursa. |
| OneSync limiti entiteta | Previše spawnovanih entiteta (peds, vozila, objekti) može degradirati performanse. Koristite resurse koji čiste nekorišćene entitete. |
| Curenje memorije | Neki loše kodirani resursi cure memoriju tokom vremena. Pratite korišćenje RAM-a servera u GPanel-u. Redovna ponovna pokretanja servera (svakih 6-12 sati) mogu ovo ublažiti. |
Preporučene prakse
- Zakažite automatska ponovna pokretanja svakih 6-12 sati koristeći GPanel funkciju rasporeda ili txAdmin da očistite nagomilanu memoriju i probleme sa entitetima.
- Održavajte resurse ažuriranim da biste imali koristi od ispravki performansi i optimizacija.
- Izbegavajte dupliranu funkcionalnost — nemojte pokretati dva resursa koji rade istu stvar (npr. dva vremenska sistema).
- Testirajte nove resurse na probnom serveru (ili sa malim brojem igrača) pre nego što ih primenite na svoj glavni server.
- Pratite metrike servera redovno kroz GPanel ili txAdmin da biste rano uhvatili probleme.
Napomena: Ako dosledno doživljavate probleme sa performansama uprkos optimizaciji, vašem serveru je možda potreban hosting plan višeg nivoa sa više CPU i RAM resursa. Kontaktirajte naš tim za podršku da razgovarate o opcijama nadogradnje.
Opšti saveti za rešavanje problema
- Uvek čitajte izlaz konzole servera. Skoro svaka greška uključuje poruku u konzoli koja vam govori šta je pošlo naopako i gde.
- Ponovo pokrenite server nakon promena konfiguracije. Većina promena u
server.cfgzahteva potpuno ponovno pokretanje servera da bi stupila na snagu. - Onemogućite resurse jedan po jedan da izolujete probleme. Zakomentarišite
ensurelinije userver.cfgpomoću#. - Čuvajte rezervne kopije ispravnih konfiguracija pre nego što napravite promene. Preuzmite svoj
server.cfgi bazu podataka pre velikih ažuriranja. - Proverite Cfx.re forume i dokumentaciju na docs.fivem.net za zvaničnu dokumentaciju koja se odnosi i na FiveM i na RedM.
- Proverite kompatibilnost resursa sa verzijom vašeg servera. Resursi napravljeni za starije verzije možda neće raditi sa trenutnim RedM build-ovima.
Povezani članci
- Vodič za podešavanje RedM servera — Licencni ključevi, server.cfg konfiguracija, upravljanje resursima i povezivanje.
- Kako da pronađete IP adresu i port svog servera
- Kako da otpremite fajlove preko SFTP-a
- Početak rada sa vašim novim serverom
Potrebna vam je pomoć?
I dalje imate probleme sa svojim RedM serverom? Otvorite tiket za podršku i navedite sve poruke o greškama iz konzole svog servera. Naš tim će vam pomoći da dijagnostikujete i rešite problem.
