Průvodce řešením problémů s běžnými problémy RedM serveru včetně chyb licenčních klíčů, viditelnosti v prohlížeči serverů, selhání resourceů, připojení klientů, databázových problémů a optimalizace výkonu. Pro úvodní instrukce k nastavení viz náš Průvodce nastavením RedM serveru.

Chyby licenčního klíče

Problémy s licenčním klíčem jsou nejčastějším problémem při spouštění nového RedM serveru. Zde jsou typické chyby a jejich řešení:

"Invalid license key" nebo "Could not authenticate"

Server se nezobrazuje v prohlížeči

Pokud váš server běží, ale hráči ho nemohou najít v prohlížeči serverů RedM:

Kontrolní seznam

1. Počkejte alespoň 5 minut. Po spuštění potřebuje server čas na registraci na hlavním seznamu serverů Cfx.re. Nové servery se mohou zobrazit až po několika minutách.
2. Ověřte, že licenční klíč je platný. Server nebude uveden bez funkčního licenčního klíče. Zkontrolujte konzoli serveru, zda neobsahuje chyby související s licencí.
3. Zkontrolujte konfiguraci endpointů. Ujistěte se, že endpoint_add_tcp a endpoint_add_udp v server.cfg používají správný port:

   endpoint_add_tcp "0.0.0.0:30120"
   endpoint_add_udp "0.0.0.0:30120"

   Port musí odpovídat tomu, který je přiřazen v GPanel.
4. Zkontrolujte nastavení "sv_master1" nebo výpisu. Ujistěte se, že jste omylem nenastavili server tak, aby se nevypisoval. Ve vaší konfiguraci by nemělo být žádné sv_master1 "" (toto deaktivuje registraci na hlavním seznamu).
5. Ověřte, že server skutečně běží. Zkontrolujte konzoli GPanel. Pokud server spadl nebo se zastavil, nezobrazí se v prohlížeči.
6. Zkuste přímé připojení. I když server není v prohlížeči, přímé připojení by mělo fungovat. Nechte hráče stisknout F8 v RedM a zadat:

   connect YOUR_SERVER_IP:PORT

Selhání načítání resourceů

Chyby resourceů jsou běžné při přidávání nových skriptů nebo frameworků na váš server. Zde jsou nejčastější problémy:

"Could not find resource [resource_name]"

• Složka resourceu neexistuje v adresáři resources/ nebo je na nesprávném místě.
• Název složky neodpovídá názvu použitému v ensure. Názvy resourceů rozlišují velká a malá písmena.
• Řešení: Ověřte, že složka resourceu existuje a název v server.cfg přesně odpovídá. Zkontrolujte pomocí správce souborů GPanel nebo SFTP.

"Failed to load resource [resource_name]: manifest error"

• Soubor fxmanifest.lua nebo __resource.lua resourceu obsahuje syntaktickou chybu.
• Manifest odkazuje na soubory, které neexistují ve složce resourceu.
• Řešení: Otevřete soubor manifestu a zkontrolujte překlepy, chybějící čárky nebo odkazy na neexistující soubory. Zkontrolujte konzoli serveru, kde najdete konkrétní číslo řádku chyby.

"Error loading script [filename]: [error details]"

• Soubor Lua, C# nebo JavaScript v rámci resourceu má syntaktickou nebo runtime chybu.
• Řešení: Přečtěte si celou chybovou zprávu v konzoli. Bude obsahovat název souboru a číslo řádku. Běžné příčiny zahrnují:
  • Chybějící závislosti (jiný resource, který musí být načten jako první)
  • Zastaralý resource nekompatibilní s aktuální verzí RedM serveru
  • Nesprávné konfigurační hodnoty v konfiguračním souboru resourceu

Problémy s pořadím načítání resourceů

Resourcy v server.cfg se načítají v pořadí, v jakém jsou uvedeny. Pokud resource závisí na jiném (např. vorp_inventory závisí na vorp_core), závislost musí být uvedena jako první:

# 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

Problémy s připojením klientů

Když se hráči nemohou připojit k vašemu serveru:

"Connection timed out" / "Failed to connect"

"Connection rejected by server"

• Heslo serveru: Pokud je nastaveno sv_password, hráč musí zadat správné heslo.
• Resource pro whitelist/allowlist: Pokud máte aktivní resource pro whitelist, hráč musí být schválen před připojením.
• Ban: Hráč může být zabanován. Zkontrolujte seznam banů nebo databázi pro jeho identifikátory.

Klient spadne při připojení

• Resource na serveru odesílá chybná data nebo má chybu v klientském skriptu, která způsobí pád klienta.
• Řešení: Deaktivujte nedávno přidané resourcy jeden po druhém, abyste identifikovali problematický. Zkontrolujte konzoli serveru, zda neobsahuje chyby během připojení klienta.
• Ujistěte se, že klient RedM hráče je aktuální.

Chyby "Could not download file"

• Server se pokouší odeslat velký soubor (např. streaming asset), který překračuje limity přenosu nebo je připojení nestabilní.
• Řešení: Zmenšete velikost streamovaných assetů, použijte CDN/externí hosting pro velké soubory, pokud je podporován, nebo nechte hráče zkusit připojení znovu.

Databázové problémy (MySQL / oxmysql)

Většina RedM roleplay frameworků používá MySQL pro perzistentní ukládání dat. Nejběžnějším databázovým konektorem je oxmysql.

Chyby připojení

Pokud se oxmysql (nebo jiný MySQL konektor) nepodaří připojit, zkontrolujte následující:

# Typical oxmysql connection string in server.cfg
set mysql_connection_string "mysql://user:password@host:3306/database_name?charset=utf8mb4"

Chybějící tabulky nebo chyby schématu

Roleplay frameworky často vyžadují nastavení databázových tabulek předtím, než mohou fungovat:

1. Zkontrolujte dokumentaci frameworku nebo jeho GitHub repozitář pro SQL importní soubory (často pojmenované database.sql, schema.sql nebo podobně).
2. Importujte SQL soubor do vaší databáze pomocí phpMyAdmin nebo MySQL klienta.
3. Některé frameworky automaticky vytvářejí tabulky při prvním spuštění. Ujistěte se, že databázový uživatel má oprávnění CREATE TABLE.

Problémy s výkonem

Pokud váš RedM server zažívá lag, nízký tick rate nebo obecně špatný výkon:

Identifikace problémů s výkonem

Zkontrolujte konzoli serveru, zda neobsahuje varování o výkonu. RedM servery cílí na tick rate přibližně 30–64 ticků za sekundu. Můžete to monitorovat pomocí:

• Dashboard txAdmin: Pokud je txAdmin k dispozici, zobrazuje metriky výkonu serveru v reálném čase.
• Konzole serveru: Sledujte varování typu "slow tick" nebo "resource hitch".
• Příkaz resmon: Zadejte resmon 1 v konzoli serveru (nebo konzoli F8) pro aktivaci monitoru resourceů, který zobrazuje čas CPU na resource.

Běžná řešení výkonnostních problémů

Doporučené postupy

• Naplánujte automatické restarty každých 6–12 hodin pomocí funkce plánování v GPanel nebo txAdmin pro vyčištění nahromaděné paměti a problémů s entitami.
• Udržujte resourcy aktualizované, abyste těžili z oprav výkonu a optimalizací.
• Vyhněte se duplicitní funkcionalitě — nespouštějte dva resourcy, které dělají totéž (např. dva systémy počasí).
• Testujte nové resourcy na testovacím serveru (nebo s nízkým počtem hráčů) před nasazením na váš hlavní server.
• Pravidelně monitorujte metriky serveru prostřednictvím GPanel nebo txAdmin, abyste zachytili problémy včas.

Obecné tipy pro řešení problémů

1. Vždy čtěte výstup konzole serveru. Téměř každá chyba obsahuje zprávu v konzoli, která vám řekne, co se pokazilo a kde.
2. Po změnách konfigurace restartujte server. Většina změn v server.cfg vyžaduje kompletní restart serveru, aby se projevily.
3. Deaktivujte resourcy jeden po druhém pro izolaci problémů. Zakomentujte řádky ensure v server.cfg pomocí #.
4. Uchovávejte zálohy funkčních konfigurací před prováděním změn. Stáhněte si server.cfg a databázi před velkými aktualizacemi.
5. Zkontrolujte fóra a dokumentaci Cfx.re na docs.fivem.net pro oficiální dokumentaci, která platí pro FiveM i RedM.
6. Ověřte kompatibilitu resourceů s vaší verzí serveru. Resourcy vytvořené pro starší verze nemusí fungovat s aktuálními buildy RedM.

Související články

• Průvodce nastavením RedM serveru — Licenční klíče, konfigurace server.cfg, správa resourceů a připojení.
• Jak najít IP adresu a port vašeho serveru
• Jak nahrát soubory přes SFTP
• Začínáme s vaším novým serverem

Potřebujete pomoc?

Stále máte problémy s vaším RedM serverem? Otevřete tiket podpory a přiložte všechny chybové zprávy z konzole vašeho serveru. Náš tým vám pomůže diagnostikovat a vyřešit problém.