Tento průvodce pokrývá nastavení administrace, serverové zdroje, vlastní mapy, správu vozidel a řešení problémů pro váš BeamMP server na Legion Hosting. Pro úvodní nastavení serveru, autentizační klíče a základní konfiguraci si přečtěte Průvodce nastavením serveru BeamMP.

---

Nastavení administrace

BeamMP nemá tradiční systém přihlášení administrátora ani hesla. Místo toho se administrátorské příkazy provádějí přes konzoli serveru nebo prostřednictvím serverových Lua pluginů, které kontrolují identifikátory hráčů.

Příkazy konzole

Konzole serveru v GPanel poskytuje přímý přístup k vestavěným příkazům serveru. Zadávejte příkazy přímo do vstupního pole konzole:

---

Struktura složky Resources

BeamMP používá složku Resources k organizaci serverového obsahu. Tato složka obsahuje dva podadresáře s odlišnými účely:

Resources/
  Client/       <-- Client-side mods (maps, vehicles) synced to players
  Server/       <-- Server-side Lua plugins (not sent to players)

Klientské zdroje

Soubory umístěné v Resources/Client/ se automaticky stahují hráčům při připojení. Používá se to pro:

• Vlastní mapy — .zip soubory modů map, které hráči potřebují k načtení mapy serveru.
• Vlastní vozidla — .zip soubory modů vozidel, které přidávají nová auta nebo upravují stávající.
• Další klientské mody — Jakýkoli mod BeamNG.drive, který musí být přítomen na klientovi.

Serverové zdroje (Lua pluginy)

Adresář Resources/Server/ obsahuje serverové Lua pluginy. Ty běží pouze na serveru a nejsou odesílány hráčům. Každý plugin má vlastní podsložku se souborem main.lua:

Resources/
  Server/
    MyPlugin/
      main.lua        <-- Plugin entry point
    AnotherPlugin/
      main.lua

Serverové pluginy mohou:

• Reagovat na události hráčů (připojení, odpojení, chatové zprávy, spawny vozidel).
• Implementovat vlastní příkazy spouštěné přes chat (např. /tp, /give).
• Spravovat oprávnění a limity vozidel.
• Přidávat ekonomické systémy, teleportaci nebo další vlastní herní funkce.
• Zaznamenávat aktivitu hráčů a vynucovat pravidla.

---

Přidání vlastních map

Pro spuštění vlastní (nevýchozí) mapy na vašem BeamMP serveru:

1. Stáhněte mod mapy jako .zip soubor ze zdroje modů BeamNG.drive (např. repozitář modů BeamNG.drive).
2. Zastavte server v GPanel.
3. Nahrajte .zip soubor do Resources/Client/ přes záložku Files nebo SFTP. Nerozbalujte zip soubor.
4. Aktualizujte spouštěcí proměnnou MAP (nebo Map v ServerConfig.toml) na správnou cestu mapy pro vlastní mapu. Tato cesta je obvykle ve formátu /levels/map_name/info.json — zkontrolujte dokumentaci modu pro přesnou cestu.
5. Spusťte server.

---

Správa vozidel

Správa vozidel na BeamMP serverech je řízena pomocí nastavení MaxCars a volitelně prostřednictvím serverových Lua pluginů.

Nastavení MaxCars

Nastavení MaxCars v ServerConfig.toml (nebo spouštěcí proměnná MAX_CARS) určuje, kolik vozidel může každý hráč mít současně spawnovaných:

• 1 — Každý hráč může mít jedno vozidlo najednou (doporučeno pro větší servery).
• 2–3 — Umožňuje hráčům mít několik vozidel, užitečné pro menší servery nebo setkání aut.
• Vyšší hodnoty úměrně zvyšují zatížení serveru.

Vlastní mody vozidel

Pro přidání vlastních vozidel na váš server:

1. Stáhněte mod vozidla jako .zip soubor.
2. Umístěte jej do Resources/Client/.
3. Restartujte server. Hráči si mod vozidla automaticky stáhnou při připojení.

Omezení vozidel pomocí pluginů

Pro detailnější kontrolu (např. zákaz konkrétních vozidel, omezení typů vozidel) budete potřebovat serverový Lua plugin. Tyto pluginy mohou zachytit události spawnu vozidel a povolit nebo zamítnout je na základě vlastních pravidel. Zkontrolujte fórum BeamMP pro pluginy na správu vozidel.

---

Instalace a správa pluginů

Serverové Lua pluginy rozšiřují funkčnost vašeho serveru. Zde je návod, jak je instalovat a spravovat:

Instalace pluginu

1. Stáhněte soubory pluginu (obvykle složka obsahující main.lua a případně další soubory).
2. Zastavte server.
3. Nahrajte složku pluginu do Resources/Server/ přes záložku Files nebo SFTP.
4. Ujistěte se, že struktura složek je správná: Resources/Server/PluginName/main.lua.
5. Spusťte server. Konzole zobrazí zprávy při načítání pluginů.

Odebrání pluginu

1. Zastavte server.
2. Smažte složku pluginu z Resources/Server/.
3. Spusťte server.

---

Řešení problémů

Chyby autentizačního klíče

• Ověřte, že klíč je správně vložen ve spouštěcí proměnné AUTH_KEY — bez extra mezer nebo zalomení řádků.
• Ujistěte se, že klíč nebyl odvolán nebo nevypršel na BeamMP Keymaster.
• Každý klíč lze použít pouze na jednom serveru najednou. Pokud stejný klíč používáte jinde, selže.
• Konzole zobrazí chyby autentizace při spuštění, pokud je klíč neplatný.

Hráči se nemohou připojit

• Potvrďte, že server je plně spuštěn a zobrazuje se jako online v GPanel.
• Zkontrolujte, že hráč používá BeamMP launcher, nikoli standardní launcher BeamNG.drive.
• Pokud je server nastaven na Private = true, hráči se musí připojit přímým připojením se správnou IP adresou a portem. Viz Jak najít IP adresu a port vašeho serveru.
• Ujistěte se, že verze BeamMP launcheru hráče je kompatibilní s verzí serveru. Zastaralé launchery se nemusí připojit.
• Pokud je server plný (dosaženo MaxPlayers), další hráči se nemohou připojit, dokud někdo neodejde.

Problémy se synchronizací modů

• Pokud se hráči zaseknou při stahování nebo obdrží chyby o chybějících modech, ověřte, že .zip soubory modů v Resources/Client/ nejsou poškozené.
• Znovu stáhněte a nahrajte soubor modu, pokud je .zip poškozen.
• Velmi velké soubory modů mohou způsobit vypršení časového limitu u hráčů s pomalým připojením. Zvažte odebrání nepotřebných velkých modů.
• Ujistěte se, že .zip soubory modů nejsou vnořené (tj. .zip uvnitř složky uvnitř dalšího .zip).

Problémy s výkonem při mnoha hráčích/vozidlech

• Snižte MaxCars na 1 na hráče.
• Snižte MaxPlayers, pokud server zažívá trvalé lagování.
• Přepněte na jednodušší mapu (Grid Map nebo Industrial) pro lepší výkon při vysokém počtu hráčů.
• Odeberte nepotřebné klientské mody z Resources/Client/ pro zkrácení doby stahování a snížení využití paměti.
• Zkontrolujte grafy využití zdrojů v GPanel — pokud je CPU nebo RAM trvale na limitu, zvažte upgrade vašeho serverového plánu. Otevřete ticket podpory pro projednání možností.

Server se nezobrazuje v prohlížeči

• Ujistěte se, že Private je nastaven na false ve vaší konfiguraci.
• Ověřte, že autentizační klíč je platný a není používán jiným serverem.
• Počkejte 1–2 minuty po spuštění, než se server zaregistruje u backendu BeamMP.
• Zkontrolujte konzoli pro případné chyby související s připojením k master serveru.

---

Související články

• Průvodce nastavením serveru BeamMP — Úvodní nastavení, autentizační klíč, konfigurace a pokyny k připojení
• Jak najít IP adresu a port vašeho serveru
• Jak nahrávat soubory přes SFTP
• Průvodce spuštěním serveru — Obecný průvodce pro spuštění jakéhokoli herního serveru na Legion Hosting

---

Potřebujete další pomoc?

Pokud máte problémy, které nejsou pokryty v tomto průvodci, náš tým podpory je k dispozici. Otevřete ticket na legionhosting.net/submitticket.php s údaji o vašem serveru, popisem problému a relevantními chybovými zprávami z konzole GPanel.