# FAQ & Fehlerbehebung

***

### Häufige Fragen und Fehlerbehebung für FJX BMA

***

### Häufige Fragen

#### Welche Frameworks werden unterstützt?

ESX Legacy, QB-Core und Standalone. Das Framework wird automatisch erkannt wenn `Config.Framework = 'auto'` gesetzt ist.

#### Welche Dependencies brauche ich?

Nur **oxmysql** ist Pflicht. Alles andere (ox\_target, qb-target, z\_fire, SmartFires, Dispatch-Systeme) ist optional.

#### Muss ich die SQL manuell importieren?

Nein. Alle Tabellen werden beim ersten Start automatisch erstellt. Updates fügen neue Spalten automatisch hinzu (Auto-Migration).

#### Kann ich mehrere Gebäude anlegen?

Ja, unbegrenzt. Jedes Gebäude hat eigene Einstellungen für Alarm, Audio, Feuer und Job-Zugang.

#### Können mehrere Alarme gleichzeitig aktiv sein?

Ja. Jedes Gebäude hat unabhängiges Audio, eigene Alarm-States und eigene Dispatch-Logik. Mehrere Gebäude können gleichzeitig Alarm haben.

#### Wie funktioniert der Dispatch bei ÜE ab?

Wenn ÜE ab aktiviert ist, wird kein Dispatch gesendet — weder beim Alarm noch bei der Zurückstellung. Feuer wird über natives GTA-Feuer gespawnt statt über z\_fire/SmartFires (die haben eigene Dispatch-Systeme).

#### Warum kommt trotz ÜE ab ein Dispatch?

Wenn du z\_fire oder SmartFires verwendest und das Feuer **nicht** über `/feuertrigger` sondern manuell ausgelöst wird, kann z\_fire intern einen eigenen Dispatch senden. Das ist nicht unser Code. Du kannst die Dispatch-Funktion in z\_fire's eigener Config deaktivieren.

#### Wie funktioniert viewOnly?

Bei Zugriffsmodus „Nur ansehen" kann der Spieler die BMA öffnen und die Meldergruppe durchschalten, aber keine Buttons wie „BMZ zurückstellen", „Akustische Signale ab" oder „ÜE ab" verwenden. Der BMA-Handmelder (Glasscheibe) kann weiterhin ausgelöst werden. Normale Handmelder (Props) sind immer für jeden zugänglich.

***

### Fehlerbehebung

#### `/bmacreator` — "Keine Berechtigung"

**Ursache:** Der Spieler hat nicht die nötige Berechtigung.

**Lösung:**

* Bei `Config.UseAcePermission = true`: Füge die Ace Permission in der `server.cfg` hinzu:

  ```
  add_ace identifier.license:xxxxxx fjx_bma.creator allow
  ```
* Bei `Config.UseAcePermission = false`: Der Spieler muss die ESX-Gruppe haben die in `Config.CreatorGroup` steht.

#### Props erscheinen nicht

**Ursache:** Das Gebäude ist nicht scharfgeschaltet oder die Prop-Modelle fehlen.

**Lösung:**

1. Prüfe ob das Gebäude im Creator auf **Scharf** steht
2. Prüfe ob die `.ydr` und `.ytyp` Dateien im `stream/` Ordner liegen
3. Prüfe ob `Config.Props.bma` und `Config.Props.handmelder` mit den Dateinamen übereinstimmen
4. Starte die Resource oder den Server neu

#### Props haben falsche Rotation

**Ursache:** Normal bei Custom-Props. Das Script verwendet Quaternion-Rotation was mit den meisten Props funktioniert.

**Lösung:** Nutze die Rotationssteuerung im Creator (STRG + Pfeiltasten) um die Rotation anzupassen.

#### Kein Alarm-Sound

**Ursache:** Audio-Datei fehlt oder Audio-Zentrum nicht gesetzt.

**Lösung:**

1. Prüfe ob `html/audio/alarm.ogg` existiert
2. Prüfe im Creator unter „Audio" ob Zentrum & Radius gesetzt sind
3. Prüfe ob du dich innerhalb des Radius befindest

#### "Akustische Signale ab" wurde gedrückt

Wenn jemand „Akustische Signale ab" gedrückt hat, wird der Sound für **alle Spieler** gestoppt. BMZ zurückstellen setzt das zurück.

#### Error: `attempt to index a nil value (global 'lib')`

**Ursache:** `ox_lib` ist nicht installiert aber das Script versucht `lib.notify` zu verwenden.

**Lösung:** Wurde in der aktuellen Version behoben. Das Script fällt automatisch auf ESX/QBCore/Native Notifications zurück. Falls der Fehler weiterhin auftritt, aktualisiere das Script.

#### Error: `Server Callback does not exist`

**Ursache:** Der Server-Code konnte nicht geladen werden (Lua Syntax-Error).

**Lösung:**

1. Prüfe die Server-Konsole auf rote Fehlermeldungen **über** dieser Meldung
2. Stelle sicher dass `oxmysql` korrekt läuft und die Datenbank erreichbar ist
3. Starte die Resource mit `ensure fjx_bma` neu

#### Dispatch kommt nicht an

**Ursache:** Dispatch-System falsch konfiguriert oder nicht installiert.

**Lösung:**

1. Prüfe `Config.Dispatch.enabled = true`
2. Prüfe `Config.Dispatch.system` — muss zum installierten System passen
3. Prüfe ob die Jobs in `Config.Dispatch.emergencyDispatch.jobs` mit den Jobs in deinem Dispatch-System übereinstimmen
4. Prüfe ob ÜE ab aktiviert ist — wenn ja, wird kein Dispatch gesendet

#### BMA Creator zeigt "BMA Position muss gesetzt sein"

Das Gebäude kann erst scharfgeschaltet werden wenn:

1. Eine BMA-Position gesetzt ist (Tab „BMA")
2. Mindestens 1 Handmelder hinzugefügt ist (Tab „Handmelder")

#### Feuer wird nicht gespawnt

**Prüfe folgendes:**

1. Im Creator unter „Fehlalarm" → „Brandsimulation bei Alarm" aktiviert?
2. Mindestens eine Feuer-Position gesetzt?
3. `Config.Fire.system` korrekt? (`'z_fire'` oder `'smartfires'`)
4. Ist z\_fire / SmartFires installiert und gestartet?
5. Bei ÜE ab wird natives GTA-Feuer verwendet — das ist Absicht

***

### Performance

Das Script ist performance-optimiert:

* Props werden nur gespawnt wenn das Gebäude scharfgeschaltet ist
* Audio-Updates nur alle 100ms
* Keine permanenten Loops wenn kein Alarm aktiv
* Alle States werden serverseitig verwaltet
* Cooldowns verhindern Spam


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://fjx.gitbook.io/fjx-docs/bma-system/faq-and-fehlerbehebung.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.