Konfiguration

HM_ELSPlus bietet vielfältige Konfigurationsmöglichkeiten, die über verschiedene Dateien gesteuert werden:

1. Allgemeine Einstellungen (main.lua)

In der config/main.lua findest du die wichtigsten globalen Einstellungen:

• ELSPlus.GroupDefaults: Standardwerte für neue Fahrzeug-Configs (Blitzmuster, Farben).
• ELSPlus.Keys: Tastaturbelegung (Standardmäßig: Blaulicht auf Q, Sirene auf 1-3).
• ELSPlus.Passenger: Steuerung durch Beifahrer aktivieren/deaktivieren.
• ELSPlus.Skins: Definition der verfügbaren HUD-Bedienteil-Skins.

2. Sirenen-System (sirens.lua)

In der config/sirens.lua wählst du zwischen den verfügbaren Systemen:

• WM (WheelMod): Standard-FiveM Sirenen oder gemoddete Soundsets.
• ServerSided (OISS): Serverseitig gestreamte Audio-Dateien mit Preset-System — bessere Reichweite und Qualität.

Kurzbeispiel WM:

ELSPlus.SirenSystem = "WM"
ELSPlus.WM = {
  defaultTones = { [1]="SIREN_ALPHA", [2]="SIREN_BRAVO", [3]="SIREN_CHARLIE" },
  soundset = "DLC_WMSIRENS_SOUNDSET",
  audioBank = "DLC_WMSIRENS\\SIRENPACK_ONE"
}

Kurzbeispiel OISS (Preset-System):

ELSPlus.SirenSystem = "ServerSided"
ELSPlus.DefaultPreset = "LSPD Modern"

ELSPlus.SirenPresets = {
  ["LSPD Modern"] = {
    soundset  = "oiss_ssa_vehaud_lspd_new_soundset",
    audioBank = "DLC_SERVERSIDEAUDIO\\OISS_SSA_VEHAUD_LSPD_NEW",
    tones = {
      "oiss_ssa_vehaud_lspd_new_siren_adam",
      "oiss_ssa_vehaud_lspd_new_siren_boy",
      "oiss_ssa_vehaud_lspd_new_siren_charles",
    },
    horn = "oiss_ssa_vehaud_lspd_new_horn",
  },
  -- weitere Presets: LSSD, BCSO, SAHP, NOOSE, FIB, LSFD, ...
}

Hinweis: Tonnamen sind department-spezifisch (z.B. lspd_new_siren_adam, nicht siren_adam). audioBank ist ein String, keine Table. ELSPlus.ServerSided wird automatisch aus dem DefaultPreset generiert (Abwärtskompatibilität).

Pro Fahrzeug kannst du in der JSON siren.wmTones, siren.tonePresets und siren.range setzen (Details unter Server-Dev / Erweiterung).

3. Blitzmuster und Farben (patterns.lua)

Hier werden alle Blitzmuster und die dazugehörigen Farben definiert:

• ELSPlus.PatternStepMs: Der Grundtakt der Blitzer in Millisekunden.
• ELSPlus.Colors: RGB-Werte für die Env-Lights (Rot, Blau, Gelb, Weiß, Grün).

4. Anbauteile / Attachments (anbauteile.lua)

Hier definierst du Templates für Kennleuchten, die auf beliebige Fahrzeuge aufgesetzt werden können. Jedes Anbauteil kann eigene Blitzmuster und Env-Lights besitzen.

5. In-Game Rechteverwaltung (rechte.json)

Diese Datei wird automatisch vom System verwaltet, wenn du den Rechte-Tab im In-Game Editor nutzt.

• Was wird gespeichert?: Das System speichert die Spieler-Identifier (z.B. license:xxx), den Namen und wer den Zugriff gewährt hat.
• Vorteil: Du musst nicht für jeden neuen Teamler die server.cfg bearbeiten und den Server neu starten.
• Manueller Eingriff: Du kannst Einträge in der rechte.json auch manuell löschen, um den Zugriff wieder zu entziehen.

6. Fahrzeug-Configs (config/fahrzeuge/*.json)

Hier liegen ELS-Fahrzeugkonfigurationen mit allen Funktionen (z. B. primary, secondary, scene, matrix, estelle).

Wichtige Felder:

• spawnName: Fahrzeugname
• layout: zugewiesenes HUD-Layout
• noFlash: Blitzer-Schutz für Einsatzfahrzeuge
• siren.wmTones: Sirenen-Töne pro Fahrzeug
• siren.soundset: Soundset-Override bei ServerSided

7. Attachment-Configs (config/attachments/*.json)

Für Non-ELS-Fahrzeuge werden separate JSON-Dateien gespeichert (z. B. pro Modell oder pro Kennzeichen).

Wichtige Felder:

• type: immer non_els
• anbauteil: Template aus anbauteile.lua
• offset / rot: Position und Rotation
• optional plate: fahrzeugspezifische Zuordnung

8. Layouts (config/layouts/)

Gespeicherte HUD-Layouts werden hier automatisch abgelegt:

• _index.json für Übersicht
• einzelne Layout-Dateien als *.json

9. NoFlash und Blitzer-Integration

NoFlash ist pro Fahrzeug gesetzt, nicht global.

• Schutz aktiv bei noFlash: true und aktivem Blaulicht.
• Für externe Scripts sollten die Exports genutzt werden (siehe Seite Server-Dev / Erweiterung).