FJX Studios Dokumentation

Installation

FJX BMA einrichten — von den Dateien bis zur ersten scharfen Anlage.

Zuletzt aktualisiert: 22. August 2026

Voraussetzungen

Komponente Pflicht Hinweis
oxmysql Ja Einzige harte Abhängigkeit. Muss vor fjx_bma starten.
ESX oder QBCore Nein Wird automatisch erkannt. Ohne Framework läuft das Script standalone.
ox_target oder qb-target Nein Alternativ 3D-Text über Config.TargetSystem.
Dispatch-System Nein emergencydispatch, cd_dispatch, ps-dispatch, qs-dispatch oder ein eigenes Event.
Feuersystem Nein z_fire oder smartfires — nur für die Brandsimulation.
Inventar Nein ox_inventory, ESX oder QBCore — nur nötig, wenn Config.Items.enabled = true.

Einrichtung

Dateien kopieren

Entpacke das Archiv nach resources/[fjx]/fjx_bma. Der Ordnername muss fjx_bma lauten — andere Scripts sprechen die Ressource unter diesem Namen an.

server.cfg ergänzen

fjx_bma startet nach dem Framework und nach oxmysql.

cfg
ensure oxmysql
ensure es_extended
ensure ox_target
ensure fjx_bma
cfg
ensure oxmysql
ensure qb-core
ensure qb-target
ensure fjx_bma
cfg
ensure oxmysql
ensure ox_target
ensure fjx_bma

Datenbank

Es muss nichts von Hand importiert werden. Beim ersten Start legt das Script diese Tabellen selbst an und ergänzt bei Updates fehlende Spalten:

fjx_bma_buildings · fjx_bma_handmelder · fjx_bma_rauchmelder · fjx_bma_laufkarten · fjx_bma_alarms

Creator-Berechtigung vergeben

Standardmäßig läuft die Rechteprüfung über Ace-Permissions (Config.UseAcePermission = true).

cfg
add_ace group.admin fjx_bma.creator allow

Wer den Creator ohne Berechtigung öffnet, bekommt ein Hinweisfenster mit der passenden, kopierbaren add_ace-Zeile für seinen eigenen Identifier.

Server starten und Konsole prüfen

Nach dem Start meldet sich das Script mit einer Übersicht der aktiven Module.

Überprüfung

Rund drei Sekunden nach dem Start steht das in der Server-Konsole:

Server-Konsole
text
[fjx_bma] ------------------------------------------
[fjx_bma] Items:   AUS (System: auto)
[fjx_bma] Wartung: AUS | Intervall 24h | Job "mechanic" | min. 1 online | Wirkung: ue
[fjx_bma] Anlagenbau: AUS | Jobs: mechanic
[fjx_bma] ------------------------------------------

Ist der Wartungsmodus aktiv, kommt eine Zeile dazu, die zeigt, wie viele Gebäude tatsächlich daran teilnehmen — etwa 3 von 5 Gebaeuden in der Wartung (Status im Creator, Tab "Anlage").

Steht der Block in der Konsole und kommen keine roten Fehler, ist die Installation abgeschlossen. Der Block zeigt immer den echten Zustand — wenn ein Modul scheinbar nichts tut, steht es hier meist schlicht auf AUS.

Läuft zusätzlich das Feuerwehrschlüsseldepot, erscheint außerdem:

Server-Konsole
text
[fjx_bma] FSD-Addon erkannt — Schnittstelle aktiv.

Befehle

Befehl Wer Zweck
/bmacreator Creator-Berechtigung Anlagen anlegen, bearbeiten, scharf schalten
/feuertrigger Creator-Berechtigung Feuer an einem Gebäude auslösen, wahlweise mit Alarm
/wartungstrigger Creator-Berechtigung Störung an einer Anlage auslösen
/bmatechnik Job aus Config.Install.jobs Techniker-Menü zum Bauen und Warten

Die beiden letzten Befehle lassen sich über Config.Maintenance.command und Config.Install.command umbenennen. Das Techniker-Menü gibt es nur, wenn Config.Install.enabled = true gesetzt ist.

Erste Anlage anlegen

Creator öffnen

/bmacreator eingeben und links auf das Plus klicken.

Position setzen

Namen vergeben, dann die Brandmeldezentrale im Spiel platzieren. Die Pfeiltasten verschieben, STRG mit Pfeiltasten dreht, SHIFT beschleunigt, K holt das Prop vor den Spieler.

Handmelder hinzufügen

Im Tab Handmelder mindestens einen Melder anlegen und platzieren. Ohne Handmelder lässt sich die Anlage nicht scharf schalten.

Scharf schalten

Oben rechts auf Scharf schalten. Erst jetzt erscheinen die Props für alle Spieler und die Anlage ist bedienbar.

Escrow

Der Code ist über FiveM Escrow geschützt. Diese Dateien bleiben offen und dürfen bearbeitet werden:

config.lua · config_server.lua · shared/locale.lua · shared/bridge.lua · locales/*.json · html/**/* · stream/**/*

Änderungen an anderen Dateien sind nicht möglich. Fehlt dir eine Einstellung, melde dich im Support — meistens lässt sie sich in die config.lua nachziehen.

Häufige Installationsprobleme

Die Props sind unsichtbar oder erscheinen als roter Würfel

Der Ordner stream/ muss vollständig mitkopiert worden sein. Nach dem Kopieren ist ein kompletter Server-Neustart nötig — ein restart fjx_bma lädt Streaming-Assets nicht neu. Clients, die schon verbunden waren, müssen ihren Cache leeren.

Es kommen Datenbankfehler beim Start

oxmysql muss vor fjx_bma starten. Prüfe die Reihenfolge in der server.cfg und ob die Verbindungszeichenfolge in der oxmysql-Konfiguration stimmt. Das Script legt seine Tabellen selbst an — ein manueller Import ist nicht nötig und nicht vorgesehen.

Der Creator öffnet sich nicht

Ohne Berechtigung erscheint statt des Creators ein Hinweisfenster mit der passenden add_ace-Zeile. Diese Zeile in die server.cfg eintragen und den Server neu starten. Steht Config.UseAcePermission auf false, entscheidet stattdessen die Framework-Gruppe aus Config.CreatorGroup.

Am Prop erscheint keine Aktion

Prüfe Config.TargetSystem. Steht dort ox_target, muss ox_target auch laufen. Ohne Target-Script 3dtext eintragen — dann erscheint stattdessen ein Tastenhinweis im Bild.

Der Dispatch kommt nicht an

Config.Dispatch.system muss zum installierten Leitstellen-Script passen, und die Jobs unter emergencyDispatch.jobs müssen den echten Job-Namen entsprechen. Für ein eigenes System system = 'custom' setzen und in customEvent den Namen des eigenen Server-Events eintragen.