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)

   Ersetze BENUTZER durch deinen System-User (z.B. fivem oder root):

   # Schreibrechte rekursiv vergeben
   chmod -R 775 resources/HM_ELSPlus/config/

   Windows (Explorer)
   1. Rechtsklick auf den Ordner config/ -> Eigenschaften.
   2. Reiter Sicherheit -> Bearbeiten.
   3. Wähle den Benutzer aus, der den Server startet.
   4. Aktiviere den Haken bei Vollzugriff oder Schreiben.
   5. Mit OK bestätigen.

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 (Optional)

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.