Diese Anleitung behandelt die Admin-Einrichtung, serverseitige Ressourcen, benutzerdefinierte Maps, Fahrzeugverwaltung und Fehlerbehebung für Ihren BeamMP-Server bei Legion Hosting. Für die erstmalige Servereinrichtung, Authentifizierungsschlüssel und grundlegende Konfiguration siehe BeamMP Server-Einrichtungsanleitung.

Admin-Einrichtung

BeamMP hat kein traditionelles Admin-Anmelde- oder Passwortsystem. Stattdessen werden Admin-Befehle über die Serverkonsole oder über serverseitige Lua-Plugins ausgeführt, die Spieleridentifikationen prüfen.

Konsolenbefehle

Die Serverkonsole in GPanel bietet direkten Zugriff auf integrierte Serverbefehle. Geben Sie Befehle direkt in das Konsoleneingabefeld ein:

Ressourcen-Ordnerstruktur

BeamMP verwendet einen Resources-Ordner zur Organisation serverseitiger Inhalte. Dieser Ordner enthält zwei Unterverzeichnisse mit unterschiedlichen Zwecken:

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

Client-Ressourcen

Dateien im Ordner Resources/Client/ werden automatisch von Spielern heruntergeladen, wenn sie sich verbinden. Dies wird verwendet für:

• Benutzerdefinierte Maps — Map-Mod-.zip-Dateien, die Spieler benötigen, um die Server-Map zu laden.
• Benutzerdefinierte Fahrzeuge — Fahrzeug-Mod-.zip-Dateien, die neue Autos hinzufügen oder bestehende modifizieren.
• Andere Client-Mods — Jeder BeamNG.drive-Mod, der auf dem Client vorhanden sein muss.

Server-Ressourcen (Lua-Plugins)

Das Verzeichnis Resources/Server/ enthält serverseitige Lua-Plugins. Diese laufen nur auf dem Server und werden nicht an Spieler gesendet. Jedes Plugin befindet sich in einem eigenen Unterordner mit einer main.lua-Datei:

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

Serverseitige Plugins können:

• Auf Spielerereignisse reagieren (Beitritt, Verlassen, Chat-Nachrichten, Fahrzeug-Spawns).
• Benutzerdefinierte Befehle implementieren, die über den Chat ausgelöst werden (z.B. /tp, /give).
• Fahrzeugberechtigungen und -limits verwalten.
• Wirtschaftssysteme, Teleportation oder andere benutzerdefinierte Gameplay-Funktionen hinzufügen.
• Spieleraktivitäten protokollieren und Regeln durchsetzen.

Benutzerdefinierte Maps hinzufügen

Um eine benutzerdefinierte (nicht standardmäßige) Map auf Ihrem BeamMP-Server zu verwenden:

1. Laden Sie den Map-Mod als .zip-Datei von einer BeamNG.drive-Mod-Quelle herunter (z.B. dem BeamNG.drive-Mod-Repository).
2. Stoppen Sie Ihren Server in GPanel.
3. Laden Sie die .zip-Datei in Resources/Client/ über den Files-Tab oder per SFTP hoch. Entpacken Sie die ZIP-Datei nicht.
4. Aktualisieren Sie die Startvariable MAP (oder Map in ServerConfig.toml) auf den korrekten Map-Pfad für die benutzerdefinierte Map. Dieser Pfad hat typischerweise das Format /levels/map_name/info.json — prüfen Sie die Dokumentation des Mods für den genauen Pfad.
5. Starten Sie den Server.

Fahrzeugverwaltung

Die Fahrzeugverwaltung auf BeamMP-Servern wird über die MaxCars-Einstellung und optional über serverseitige Lua-Plugins gesteuert.

MaxCars-Einstellung

Die MaxCars-Einstellung in ServerConfig.toml (oder die Startvariable MAX_CARS) steuert, wie viele Fahrzeuge jeder Spieler gleichzeitig spawnen kann:

• 1 — Jeder Spieler kann ein Fahrzeug gleichzeitig haben (empfohlen für größere Server).
• 2–3 — Ermöglicht Spielern ein paar Fahrzeuge, nützlich für kleinere Server oder Auto-Treffen.
• Höhere Werte erhöhen die Serverbelastung proportional.

Benutzerdefinierte Fahrzeug-Mods

Um benutzerdefinierte Fahrzeuge zu Ihrem Server hinzuzufügen:

1. Laden Sie den Fahrzeug-Mod als .zip-Datei herunter.
2. Platzieren Sie ihn in Resources/Client/.
3. Starten Sie den Server neu. Spieler laden den Fahrzeug-Mod beim Verbinden automatisch herunter.

Fahrzeuge über Plugins einschränken

Für eine detailliertere Kontrolle (z.B. bestimmte Fahrzeuge verbieten, Fahrzeugtypen einschränken) benötigen Sie ein serverseitiges Lua-Plugin. Diese Plugins können Fahrzeug-Spawn-Ereignisse abfangen und basierend auf benutzerdefinierten Regeln erlauben oder verweigern. Schauen Sie in den BeamMP-Foren nach Fahrzeugverwaltungs-Plugins.

Plugins installieren und verwalten

Serverseitige Lua-Plugins erweitern die Funktionalität Ihres Servers. So installieren und verwalten Sie sie:

Ein Plugin installieren

1. Laden Sie die Plugin-Dateien herunter (typischerweise ein Ordner mit main.lua und möglicherweise weiteren Dateien).
2. Stoppen Sie Ihren Server.
3. Laden Sie den Plugin-Ordner in Resources/Server/ über den Files-Tab oder SFTP hoch.
4. Stellen Sie sicher, dass die Ordnerstruktur korrekt ist: Resources/Server/PluginName/main.lua.
5. Starten Sie den Server. Die Konsole zeigt Meldungen an, wenn Plugins geladen werden.

Ein Plugin entfernen

1. Stoppen Sie Ihren Server.
2. Löschen Sie den Plugin-Ordner aus Resources/Server/.
3. Starten Sie den Server.

Fehlerbehebung

Authentifizierungsschlüssel-Fehler

• Überprüfen Sie, ob der Schlüssel korrekt in die Startvariable AUTH_KEY eingefügt wurde — keine zusätzlichen Leerzeichen oder Zeilenumbrüche.
• Stellen Sie sicher, dass der Schlüssel nicht widerrufen oder auf dem BeamMP Keymaster abgelaufen ist.
• Jeder Schlüssel kann nur auf einem Server gleichzeitig verwendet werden. Wenn Sie denselben Schlüssel anderswo verwenden, schlägt es fehl.
• Die Konsole zeigt beim Start Authentifizierungsfehler an, wenn der Schlüssel ungültig ist.

Spieler können sich nicht verbinden

• Bestätigen Sie, dass der Server vollständig gestartet ist und in GPanel als online angezeigt wird.
• Überprüfen Sie, ob der Spieler den BeamMP-Launcher verwendet und nicht den Standard-BeamNG.drive-Launcher.
• Wenn der Server auf Private = true gesetzt ist, müssen Spieler die Direktverbindung mit der korrekten IP und dem Port verwenden. Siehe So finden Sie Ihre Server-IP und den Port.
• Stellen Sie sicher, dass die BeamMP-Launcher-Version des Spielers mit der Serverversion kompatibel ist. Veraltete Launcher können möglicherweise keine Verbindung herstellen.
• Wenn der Server voll ist (MaxPlayers erreicht), können keine weiteren Spieler beitreten, bis jemand den Server verlässt.

Mod-Synchronisierungsprobleme

• Wenn Spieler beim Herunterladen hängen bleiben oder Fehler über fehlende Mods erhalten, überprüfen Sie, ob die Mod-.zip-Dateien in Resources/Client/ nicht beschädigt sind.
• Laden Sie die Mod-Datei erneut herunter und hoch, wenn die .zip beschädigt ist.
• Sehr große Mod-Dateien können bei Spielern mit langsamer Verbindung Zeitüberschreitungen verursachen. Erwägen Sie, unnötig große Mods zu entfernen.
• Stellen Sie sicher, dass Mod-.zip-Dateien nicht verschachtelt sind (d.h. eine .zip in einem Ordner in einer anderen .zip).

Leistungsprobleme bei vielen Spielern/Fahrzeugen

• Reduzieren Sie MaxCars auf 1 pro Spieler.
• Senken Sie MaxPlayers, wenn der Server dauerhaft Verzögerungen aufweist.
• Wechseln Sie zu einer einfacheren Map (Grid Map oder Industrial) für bessere Leistung bei hohen Spielerzahlen.
• Entfernen Sie unnötige Client-Mods aus Resources/Client/, um Download-Zeiten und Speicherverbrauch zu reduzieren.
• Überprüfen Sie die Ressourcennutzungsgrafiken in GPanel — wenn CPU oder RAM dauerhaft am Limit sind, erwägen Sie ein Upgrade Ihres Serverplans. Eröffnen Sie ein Support-Ticket, um Optionen zu besprechen.

Server erscheint nicht im Browser

• Stellen Sie sicher, dass Private in Ihrer Konfiguration auf false gesetzt ist.
• Überprüfen Sie, ob der Authentifizierungsschlüssel gültig ist und nicht von einem anderen Server verwendet wird.
• Warten Sie 1–2 Minuten nach dem Start, damit sich der Server beim BeamMP-Backend registrieren kann.
• Überprüfen Sie die Konsole auf Fehler im Zusammenhang mit der Master-Server-Verbindung.

Verwandte Artikel

• BeamMP Server-Einrichtungsanleitung — Ersteinrichtung, Authentifizierungsschlüssel, Konfiguration und Verbindungsanweisungen
• So finden Sie Ihre Server-IP und den Port
• Dateien per SFTP hochladen
• Server-Startanleitung — Allgemeine Anleitung zum Starten eines beliebigen Gameservers bei Legion Hosting

Weitere Hilfe benötigt?

Wenn Sie Probleme haben, die in dieser Anleitung nicht behandelt werden, steht Ihnen unser Support-Team zur Verfügung. Eröffnen Sie ein Ticket unter legionhosting.net/submitticket.php mit Ihren Serverdetails, einer Beschreibung des Problems und relevanten Fehlermeldungen aus der GPanel-Konsole.