Bedienung & Ingame-Funktionen

Das System bietet zwei Hauptkomponenten im Spiel:

Das Config-Tablet für Administratoren und Bearbeiter zum Verwalten aller Säulen, Dienste und Einstellungen.
Das Bedienfeld an der Säule für alle Spieler zum Absetzen von Notrufen.

Das Config-Tablet (`/notruf_config`)

Das Tablet besitzt eine moderne NUI-Oberfläche im vertrauten HM_ELSPlus-Design. Es öffnet sich über den Chatbefehl /notruf_config, ein konfiguriertes Inventar-Item oder einen Keybind.

Mit ESC schließt sich zunächst das jeweils aktive Unterfenster bzw. Modal und beim erneuten Drücken das gesamte Tablet.

Verfügbare Tabs

Tab	Zugriff	Inhalt & Funktionen
Notrufsäulen	`editor`, `admin`	Liste aller aktiven Säulen mit Suchfunktion, Status, Position, Prop und Diensten. Aktionen: GPS-Wegpunkt setzen, Bearbeiten, Position im Spiel ändern, Löschen.
Karte	`editor`, `admin`	Live-Satellitenkarte mit allen Säulen als Marker, Zoom/Pan, Koordinatenanzeige, Detailansicht und Kalibrierungs-Werkzeug.
Notrufdienste	`admin`	Übersicht aller Notruforganisationen mit Rufnummer, Dispatch-Adapter, Cooldown und Job-Zuweisung. Formular zum Erstellen und Bearbeiten.
Templates	`editor`, `admin`	Vorlagen aus Prop, 3D-Offset, Ausrichtung und Notrufdiensten. Änderungen an einem Template wirken sofort auf alle zugewiesenen Säulen.
Rechte	`admin`	Links: Online-Spielerliste (ein Klick vergibt Editor- oder Admin-Rechte). Rechts: Bestehende Rechte-Liste mit Level-Umschalter und Löschfunktion.
Info	Alle mit Zugriff	Statistiken (Anzahl Säulen, Dienste), eigenes Berechtigungslevel, Script-Version, Befehlsübersicht und geladene Dispatch-Adapter.

Interaktive Karte & Kalibrierung

Der Karten-Tab erlaubt die visuelle Kontrolle aller Standorte in ganz San Andreas.

Navigation: Mit dem Mausrad zoomen, per gedrückter linker Maustaste die Karte verschieben.
Koordinatenanzeige: Unten rechts werden die Ingame-Weltkoordinaten unter dem Mauszeiger live angezeigt.
Marker: Notrufsäulen werden als Icon (saeule.svg) auf einer dunklen Plakette gerendert.
- Orange: Normale, aktive Säule.
- Grau: Außer Betrieb.
- Weiß mit orangem Rand: Aktuell ausgewählte Säule.
Eigene Position: Der eigene Standort wird alle zwei Sekunden aktualisiert und mit eigen_gps.svg angezeigt. Ein Klick auf „Meine Position“ zentriert die Karte auf deinen Aufenthaltsort.

Karte im Spiel einmessen (Kalibrierung)

Falls die Marker nach dem Einsetzen eines eigenen Kartenbilds leicht verschoben wirken, kann die Karte direkt im Spiel ohne mühsames Raten von Koordinaten kalibriert werden:

Ersten Referenzpunkt ansteuern:
Stelle dich im Spiel an eine markante, auf dem Satellitenbild eindeutig erkennbare Stelle (z. B. eine Straßenkreuzung oder Kaikante).
Eigenen Punkt übernehmen:
Klicke im Karten-Tab auf Kalibrieren und anschließend auf „Meine Position übernehmen“.
Punkt auf der Karte markieren:
Zoome in die Karte hinein und klicke exakt auf dieselbe Stelle im Bild.
Zweiten Referenzpunkt setzen:
Wiederhole den Vorgang für einen zweiten Punkt, der möglichst weit vom ersten Punkt entfernt liegt.
Übernehmen:
Klicke auf „Übernehmen“. Das Script berechnet automatisch Maßstab und Verschiebung und speichert diese in data/map.json.

Notrufdienste & Behörden-Logos

Jeder Dienst verfügt über eine eindeutige ID, Bezeichnung, Rufnummer, Dispatch-Adapter samt Meldecode, zugeordnete Jobs, Priorität, Cooldown und einen Schalter für anonyme Notrufe.

Eigene SVG-Logos für Organisationen

Standardmäßig nutzt das Script Font-Awesome-Klassen (z. B. fa-solid fa-shield-halved). Über die Option Eigenes SVG wählen kann stattdessen ein Behördenlogo (z. B. Wappen der Polizei oder Feuerwehr) hinterlegt werden:

Echtzeit-Verteilung: Das SVG wird direkt in data/services.json gespeichert. Es wird kein Serverneustart benötigt – das Logo erscheint sofort bei allen Spielern auf dem Säulen-Bedienfeld und im Tablet.
Integrierte Sicherheitsprüfung: Der Server validiert hochgeladene SVGs automatisch:
- Maximalgröße 48 KB (Config.Tablet.iconMaxBytes).
- Strikte Validierung auf valides <svg> und Blockieren potenzieller Sicherheitsrisiken (<script>, onload=, javascript:, <foreignObject>, <iframe>, <embed>, <object>, XML-Entities).

Templates & 3D-Editor

Ein Template bündelt alle Eigenschaften einer Säulenart:

Prop / 3D-Model (z. B. hm_notrufsaeule)
Zugewiesene Notrufdienste (z. B. Polizei, Feuerwehr, Rettungsdienst, ADAC)
3D-Offset und Rotationskorrektur (X, Y, Z sowie Pitch, Roll, Yaw)
Boden-Snap-Verhalten

Beim Aufstellen einer neuen Säule wählst du nur das Template – alle Einstellungen werden übernommen. Anpassungen an einem Template aktualisieren sofort alle damit verbundenen Säulen.

3D-Prop-Editor (Im Spiel ausrichten)

Klickst du im Template auf „Im Spiel ausrichten“, startet der visuelle 3D-Editor. Der Prop wird 2,5 m vor dir über einem Bodenmarker gerendert:

Taste	Funktion
`W` `A` `S` `D`	Position X / Y verschieben
`Einfg` / `Entf`	Höhe Z anpassen
`Pfeiltasten`	Neigung (Pitch / Roll)
`Q` / `E`	Drehung um die eigene Achse (Yaw)
`Shift` / `Alt`	Feine Schritte (0,001 m) / Grobe Schritte (0,05 m)
`Leertaste`	Auto: auf Boden (berechnet Unterkante via Bounding Box)
`R`	Alle Offsets auf `0` zurücksetzen
`ENTER`	Werte übernehmen und im Template speichern
`Backspace`	Vorgang abbrechen

Säulen platzieren (Ingame-Placer)

Wenn du im Tablet auf „Neue Notrufsäule platzieren“ klickst, startet der Ingame-Placer:

Taste	Funktion
`W` `A` `S` `D`	Säule verschieben (relativ zur Blickrichtung der Kamera)
`Einfg` / `Entf`	Höhe anpassen (deaktiviert automatisch den Boden-Snap)
`Q` / `E`	Säule drehen
`←` / `→`	Feindrehung um 0,5°
`Shift` / `Alt`	Feine Schritte (0,005 m) / Grobe Schritte (0,25 m)
`G`	Säule direkt an den aktuellen Kamerablickpunkt setzen
`Leertaste`	Boden-Snap an/aus
`N`	Prop-Offset automatisch berechnen und speichern
`ENTER`	Säule fest platzieren und speichern
`Backspace`	Platzieren abbrechen

Direkt an der Säule bearbeiten

Spieler mit der Berechtigung editor oder admin sehen an Notrufsäulen im ox_target-Menü zwei zusätzliche Optionen (für normale Spieler unsichtbar):

Säule bearbeiten: Öffnet direkt das Bearbeitungsmodal dieser Säule, ohne das komplette Tablet aufzurufen.
Säule versetzen: Startet den Placer an der aktuellen Position, um Standort oder Drehung schnell zu korrigieren.

(Einstellbar über Config.Interaction.edit.enabled).

Das Bedienfeld an der Säule

Nähert sich ein Spieler der Säule und betätigt ox_target bzw. die Taste E (TextUI), öffnet sich das interaktive Bedienfeld im authentischen Look einer Notrufsäule:

Echtes Autobahn-Design: Oranger Korpus, perforierte Lautsprecherblende, Beschriftungsschild (Autobahn, Kilometer, Notrufsäulen-Nr) und Straßenname.
Farbige Tastenkappen: Automatisch nach Fachbereich eingefärbt (Polizei blau, Feuerwehr/Rettung dunkelrot, Pannenhilfe gelb, Allgemein sandfarben, Sonstige grau).
Leitstellen-Kommunikation: Antworten der Leitstelle erscheinen in einer Sprechblase oberhalb des Bedienfelds.

Ablauf eines Notrufs

Dienst-Taste drücken:
Die gewählte Taste pulsiert im Ruftakt. Die Sprechblase signalisiert den Verbindungsaufbau: „Verbindung zu 110…“ (Dauer aus Config.Call.connectTime).
Gesprächsannahme:
Die Leitstelle meldet sich („Notruf, was ist passiert?“). Es erscheint ein Eingabefeld für die Situationsbeschreibung sowie optional eine Checkbox für „Anonym melden“.
Meldung durchgeben:
Nach dem Absenden bestätigt die Leitstelle den Eingang der Meldung. Nach wenigen Sekunden schließt sich das Fenster automatisch.
Auflegen:
Über den Button „Auflegen“ kann das Gespräch vorzeitig beendet werden, um beispielsweise einen anderen Dienst auszuwählen.

Was wird an die Leitstelle übertragen?

Die Notrufmeldung setzt sich automatisch aus den Säulendaten und dem Spielereingaben zusammen:

Melder: Frank Wolf | Notrufsäule: A1 Nord | BAB 1, km 184,3 | Säulen-Nr 15723 | Ort: Senora Fwy | Meldung: Auffahrunfall auf der linken Spur

Einstellungen im Tablet (Admin-Reiter)

Administratoren können globale Grundeinstellungen direkt im Spiel anpassen, ohne die Datei config.lua bearbeiten oder den Server neustarten zu müssen:

Notruf-Parameter: Cooldown pro Spieler, Cooldown pro Säule, Rufdauer (Verbindungsaufbau), Höchstabstand zur Säule, Maximallänge der Meldung, anonyme Meldungen und Beschriftungsanzeige auf Tasten.
Alarmierung: Standard-Dispatch-Adapter, Redundanz-Benachrichtigung und Dienstprüfung.
Props zur Auswahl: Liste der 3D-Props, die in Template-Dropdowns auswählbar sind.

Alle hier vorgenommenen Änderungen werden in data/settings.json abgelegt und überschreiben die Standardwerte der config.lua zur Laufzeit. Über den Button „Zurücksetzen“ kann jederzeit auf die Standardwerte der config.lua zurückgekehrt werden.