Installation

Befolge diese strukturierten Schritte, um HM_ELSPlus schnell und sicher auf deinem Server einzurichten.

1. Dateien kopieren: Verschiebe den Ordner HM_ELSPlus in dein resources/-Verzeichnis deines FiveM-Servers.

2. Server.cfg konfigurieren: Füge den Startbefehl in deine server.cfg ein, damit das Script beim Serverstart geladen wird:

   ensure HM_ELSPlus

3. Schreibrechte setzen (WICHTIG): Damit der In-Game Editor Änderungen direkt in den Dateien speichern kann, muss der config/-Ordner für den FiveM-Serverprozess beschreibbar sein.

   Linux (Terminal / SSH)

   Führe folgenden Befehl im Serververzeichnis aus, um die Schreibrechte rekursiv für den Ordner und alle Unterdateien zu vergeben:

   chmod -R 775 resources/HM_ELSPlus/config/

   Benutzerrechte

   Falls dein FiveM-Server unter einem eigenen Linux-Benutzer (z. B. fivem) läuft, stelle sicher, dass dieser auch als Eigentümer eingetragen ist:

   chown -R fivem:fivem resources/HM_ELSPlus/config/

   WinSCP (SFTP)

   Wenn du deinen Linux-Server über WinSCP verwaltest:

   1. Verbinde dich per SFTP mit deinem Server und navigiere zu resources/HM_ELSPlus/.
   2. Mache einen Rechtsklick auf den Ordner config/ und wähle Eigenschaften (oder Taste F9).
   3. Trage unter Rechte oktal den Wert 0775 (oder 0777) ein (bzw. setze Lese-, Schreib- und Ausführungsrechte für Eigentümer und Gruppe).
   4. Wichtig: Aktiviere ganz unten die Checkbox „Rechte, Gruppe und Eigentümer für Unterverzeichnisse und Dateien übernehmen“ (Einschließlich aller Unterordner und Dateien).
   5. Bestätige mit OK.
   FileZilla (SFTP)

   Wenn du deinen Linux-Server über FileZilla verwaltest:

   1. Verbinde dich per SFTP mit deinem Server und navigiere im rechten Fenster zu resources/HM_ELSPlus/.
   2. Mache einen Rechtsklick auf den Ordner config/ und wähle Dateiberechtigungen….
   3. Gib im Feld Numerischer Wert 775 (oder 777) ein.
   4. Wichtig: Setze das Häkchen bei „Unterverzeichnisse einbeziehen“ und wähle die Option „Auf alle Dateien und Verzeichnisse anwenden“.
   5. Bestätige mit OK.
   Windows (Explorer)

   Wenn du einen Windows-Server oder eine lokale Testumgebung nutzt:

   1. Navigiere im Windows-Explorer zum Ordner resources\HM_ELSPlus\.
   2. Mache einen Rechtsklick auf den Ordner config -> Eigenschaften.
   3. Wechsle auf den Reiter Sicherheit und klicke auf Bearbeiten….
   4. Wähle den entsprechenden Windows-Benutzer aus (z. B. deinen Benutzer oder Jeder).
   5. Aktiviere den Haken bei Vollzugriff bzw. Schreiben unter Zulassen.
   6. Klicke auf Übernehmen und OK.

4. Berechtigungen (ACE Permissions): Um den In-Game Config-Editor (/els_config) nutzen zu können, musst du dir oder deiner Admin-Gruppe in der server.cfg Rechte geben:

   # Für eine gesamte Gruppe (z.B. Admins)
   add_ace group.admin els_plus.config allow
   
   # Für einen spezifischen Spieler (Lizenz)
   add_ace identifier.license:DEINE_LICENSE_HIER els_plus.config allow

5. Erster Start & Prüfung: Starte deinen Server und verbinde dich. Teste die Installation mit folgenden Schritten:

   • Öffne den Editor mit /els_config.
   • Setze dich in ein Fahrzeug und prüfe, ob es vom System erkannt wird.
   • Erstelle ein Test-Layout und speichere es ab.

Alternative: In-Game Rechteverwaltung

Wenn du bereits Administrator-Rechte (über ACE Permissions) besitzt, kannst du anderen Teammitgliedern direkt im Spiel Zugriff auf den Editor gewähren:

1. Öffne den Editor mit /els_config.
2. Navigiere zum Tab “Rechte”.
3. Dort siehst du eine Liste aller online befindlichen Spieler.
4. Klicke auf “Zugriff erlauben” neben dem gewünschten Namen.
5. Der Spieler wird permanent in der config/rechte.json gespeichert.

Sirenen-Setup (WM-Sirens & ServerSided)

HM_ELSPlus unterstützt sowohl WM-Sirens (WheelMod / WM-Server Sirenen) als auch ServerSided (OISS) Sirenen-Systeme.

WM-Sirens Einrichtung & Erklärvideo

Für die Einrichtung von WM-Sirens kannst du das folgende Schritt-für-Schritt Erklärvideo nutzen:

Credits

Credits für das Erklärvideo gehen an FiveM Schritt-Für-Schritt Tutorials.

ServerSided Sirenen (OISS)

Bei Nutzung von ServerSided Sirenen: Stelle sicher, dass du ein kompatibles Audio-Pack (z.B. OISS) als eigene Resource installiert und gestartet hast.

Nützliche Server-Befehle

Befehl	Beschreibung
els_reload_configs	Lädt alle Fahrzeug-Konfigurationen im laufenden Betrieb neu.
els_debug_layouts	Zeigt detaillierte Layout-Informationen in der Server-Konsole an.