Ten przewodnik obejmuje konfigurację administracji, zasobów po stronie serwera, niestandardowych map, zarządzanie pojazdami oraz rozwiązywanie problemów dla Twojego serwera BeamMP w Legion Hosting. Informacje na temat wstępnej konfiguracji serwera, kluczy uwierzytelniających i podstawowej konfiguracji znajdziesz w Przewodniku konfiguracji serwera BeamMP.

---

Konfiguracja administracji

BeamMP nie posiada tradycyjnego systemu logowania administratora ani haseł. Zamiast tego polecenia administracyjne są wykonywane przez konsolę serwera lub za pomocą wtyczek Lua po stronie serwera, które sprawdzają identyfikatory graczy.

Polecenia konsoli

Konsola serwera w GPanel zapewnia bezpośredni dostęp do wbudowanych poleceń serwera. Wpisuj polecenia bezpośrednio w polu wprowadzania konsoli:

---

Struktura folderu zasobów

BeamMP używa folderu Resources do organizowania treści po stronie serwera. Folder ten zawiera dwa podkatalogi o odmiennym przeznaczeniu:

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

Zasoby klienta

Pliki umieszczone w Resources/Client/ są automatycznie pobierane przez graczy podczas łączenia. Jest to wykorzystywane do:

• Niestandardowych map — pliki .zip modów map, których gracze potrzebują, aby załadować mapę serwera.
• Niestandardowych pojazdów — pliki .zip modów pojazdów, które dodają nowe samochody lub modyfikują istniejące.
• Innych modów klienta — dowolny mod BeamNG.drive, który musi być obecny po stronie klienta.

Zasoby serwera (wtyczki Lua)

Katalog Resources/Server/ zawiera wtyczki Lua po stronie serwera. Działają one wyłącznie na serwerze i nie są wysyłane do graczy. Każda wtyczka znajduje się w osobnym podfolderze z plikiem main.lua:

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

Wtyczki po stronie serwera mogą:

• Reagować na zdarzenia graczy (dołączenie, opuszczenie, wiadomości czatu, pojawienie się pojazdów).
• Implementować niestandardowe polecenia wyzwalane przez czat (np. /tp, /give).
• Zarządzać uprawnieniami i limitami pojazdów.
• Dodawać systemy ekonomii, teleportacji lub inne niestandardowe funkcje rozgrywki.
• Rejestrować aktywność graczy i egzekwować zasady.

---

Dodawanie niestandardowych map

Aby uruchomić niestandardową (niedomyślną) mapę na serwerze BeamMP:

1. Pobierz mod mapy jako plik .zip ze źródła modów BeamNG.drive (np. z repozytorium modów BeamNG.drive).
2. Zatrzymaj serwer w GPanel.
3. Prześlij plik .zip do Resources/Client/ przez zakładkę Files lub SFTP. Nie rozpakowuj archiwum zip.
4. Zaktualizuj zmienną startową MAP (lub Map w ServerConfig.toml) na poprawną ścieżkę mapy dla niestandardowej mapy. Ścieżka ta ma zazwyczaj format /levels/map_name/info.json — sprawdź dokumentację moda, aby poznać dokładną ścieżkę.
5. Uruchom serwer.

---

Zarządzanie pojazdami

Zarządzanie pojazdami na serwerach BeamMP jest kontrolowane przez ustawienie MaxCars oraz opcjonalnie przez wtyczki Lua po stronie serwera.

Ustawienie MaxCars

Ustawienie MaxCars w ServerConfig.toml (lub zmienna startowa MAX_CARS) kontroluje, ile pojazdów każdy gracz może jednocześnie przywołać:

• 1 — każdy gracz może mieć jeden pojazd naraz (zalecane dla większych serwerów).
• 2–3 — pozwala graczom mieć kilka pojazdów, przydatne dla mniejszych serwerów lub zlotów samochodowych.
• Wyższe wartości proporcjonalnie zwiększają obciążenie serwera.

Niestandardowe mody pojazdów

Aby dodać niestandardowe pojazdy do swojego serwera:

1. Pobierz mod pojazdu jako plik .zip.
2. Umieść go w Resources/Client/.
3. Uruchom ponownie serwer. Gracze automatycznie pobiorą mod pojazdu po połączeniu.

Ograniczanie pojazdów za pomocą wtyczek

Aby uzyskać bardziej szczegółową kontrolę (np. zbanowanie określonych pojazdów, ograniczenie typów pojazdów), będziesz potrzebować wtyczki Lua po stronie serwera. Takie wtyczki mogą przechwytywać zdarzenia pojawienia się pojazdów i zezwalać na nie lub je blokować na podstawie niestandardowych reguł. Wtyczek do zarządzania pojazdami szukaj na forum BeamMP.

---

Instalowanie wtyczek i zarządzanie nimi

Wtyczki Lua po stronie serwera rozszerzają funkcjonalność Twojego serwera. Oto jak je zainstalować i nimi zarządzać:

Instalowanie wtyczki

1. Pobierz pliki wtyczki (zazwyczaj folder zawierający main.lua i ewentualnie inne pliki).
2. Zatrzymaj serwer.
3. Prześlij folder wtyczki do Resources/Server/ przez zakładkę Files lub SFTP.
4. Upewnij się, że struktura folderów jest poprawna: Resources/Server/PluginName/main.lua.
5. Uruchom serwer. Konsola wyświetli komunikaty w trakcie ładowania wtyczek.

Usuwanie wtyczki

1. Zatrzymaj serwer.
2. Usuń folder wtyczki z Resources/Server/.
3. Uruchom serwer.

---

Rozwiązywanie problemów

Błędy klucza uwierzytelniającego

• Sprawdź, czy klucz został poprawnie wklejony w zmiennej startowej AUTH_KEY — bez dodatkowych spacji ani znaków nowej linii.
• Upewnij się, że klucz nie został cofnięty ani nie wygasł w BeamMP Keymaster.
• Każdy klucz może być używany tylko na jednym serwerze naraz. Jeśli używasz tego samego klucza w innym miejscu, wystąpi błąd.
• Konsola wyświetli błędy uwierzytelniania podczas uruchamiania, jeśli klucz jest nieprawidłowy.

Gracze nie mogą się połączyć

• Potwierdź, że serwer jest w pełni uruchomiony i wyświetlany jako online w GPanel.
• Sprawdź, czy gracz używa launchera BeamMP, a nie standardowego launchera BeamNG.drive.
• Jeśli serwer jest ustawiony na Private = true, gracze muszą użyć bezpośredniego połączenia z poprawnym IP i portem. Zobacz Jak znaleźć IP i port serwera.
• Upewnij się, że wersja launchera BeamMP gracza jest zgodna z wersją serwera. Nieaktualne launchery mogą nie nawiązać połączenia.
• Jeśli serwer jest pełny (osiągnięto MaxPlayers), dodatkowi gracze nie mogą dołączyć, dopóki ktoś nie wyjdzie.

Problemy z synchronizacją modów

• Jeśli gracze utkną podczas pobierania lub otrzymują błędy o brakujących modach, sprawdź, czy pliki .zip modów w Resources/Client/ nie są uszkodzone.
• Pobierz ponownie i prześlij ponownie plik moda, jeśli .zip jest uszkodzony.
• Bardzo duże pliki modów mogą powodować przekroczenia limitu czasu u graczy z wolnym połączeniem. Rozważ usunięcie zbędnych dużych modów.
• Upewnij się, że pliki .zip modów nie są zagnieżdżone (tzn. .zip wewnątrz folderu wewnątrz innego .zip).

Problemy z wydajnością przy wielu graczach/pojazdach

• Zmniejsz MaxCars do 1 na gracza.
• Obniż MaxPlayers, jeśli serwer doświadcza stałych opóźnień.
• Przełącz się na prostszą mapę (Grid Map lub Industrial), aby uzyskać lepszą wydajność przy dużej liczbie graczy.
• Usuń zbędne mody klienta z Resources/Client/, aby skrócić czas pobierania i zmniejszyć zużycie pamięci.
• Sprawdź wykresy zużycia zasobów w GPanel — jeśli CPU lub RAM jest stale na granicy, rozważ uaktualnienie planu serwera. Otwórz zgłoszenie do pomocy technicznej, aby omówić opcje.

Serwer nie pojawia się w przeglądarce

• Upewnij się, że Private jest ustawione na false w Twojej konfiguracji.
• Sprawdź, czy klucz uwierzytelniający jest prawidłowy i nie jest używany przez inny serwer.
• Po uruchomieniu odczekaj 1–2 minuty, aż serwer zarejestruje się w zapleczu BeamMP.
• Sprawdź konsolę pod kątem błędów związanych z połączeniem z serwerem głównym.

---

Powiązane artykuły

• Przewodnik konfiguracji serwera BeamMP — wstępna konfiguracja, klucz uwierzytelniający, konfiguracja i instrukcje połączenia
• Jak znaleźć IP i port serwera
• Jak przesyłać pliki przez SFTP
• Przewodnik uruchamiania serwera — ogólny przewodnik uruchamiania dowolnego serwera gier w Legion Hosting

---

Potrzebujesz więcej pomocy?

Jeśli napotkasz problemy nieomówione w tym przewodniku, nasz zespół wsparcia jest gotowy do pomocy. Otwórz zgłoszenie pod adresem legionhosting.net/submitticket.php, podając szczegóły serwera, opis problemu oraz wszelkie istotne komunikaty o błędach z konsoli GPanel.