FiveM Business MLO + Job Script: Kompatibilitäts- und Einrichtungsanleitung

Ein FiveM-Geschäft benötigt meist zwei getrennte Ebenen: Ein MLO liefert Gebäude, Räume und Kollisionen; ein Job-Skript liefert Mitarbeiter, Herstellung, Abrechnung, Lagerbestand, Verkauf und Verwaltung. Der Kauf beider garantiert kein Zusammenspiel. Die Kompatibilität hängt von deinem Framework und den vermittelnden Ressourcen ab.

Schnelle Kompatibilitätsmatrix

Ebene	Was zu überprüfen ist	Häufige Diskrepanz
MLO	Koordinaten-, Tür-, Kollisions- und Kartenkonflikte	Eine andere Karte bearbeitet denselben Ort
Framework	ESX, QBCore, Qbox oder Standalone-Unterstützung	Ein QBCore-Label wird als Nachweis für Qbox-Unterstützung behandelt
Inventar	Artikeldefinitionen, Bilder, Metadaten und Exporte	Das Skript erwartet eine andere Inventar-API
Interaktion	Target-Ressource, Zonen, Markierungen oder Tastenhinweise	Interaktionspunkte sind für ein anderes Zielsystem geschrieben
Geschäftslogik	Jobränge, Dienst, Abrechnung, Gesellschaftskonto und Boss-Menü	Rangnamen oder Kontobezeichner stimmen nicht überein
Datenbank	SQL Änderungen, Eigentum und Persistenz	Tabellen werden ohne Sicherungs- oder Migrationsplan importiert

1. Wähle den Veranstaltungsort und das Gameplay separat

Beginne mit dem Rollenspielablauf: Werkstatt, Restaurant, Café, Autohaus, Nachtclub oder ein anderes Spielergeschäft. Wähle Karte und Skript anschließend unabhängig voneinander. Ein ausgearbeiteter Innenraum liefert keine Rezepte oder Rechnungen, und ein vollständiges Job-Skript verschiebt seine Interaktionspunkte nicht automatisch in ein eigenes Gebäude.

2. Lies die Ressourcen-Manifeste und Abhängigkeitslisten

Öffne jede gelieferte fxmanifest.lua bevor du die Ressource zu server.cfg. hinzufügst. Das Manifest kann Skripte, Dateien und Abhängigkeiten identifizieren, während die Dokumentation des Erstellers das erforderliche Framework, Inventar, Ziel, Menü, Benachrichtigungs-, Audio- und Datenbankressourcen angeben sollte. Verwende die offizielle Cfx.re Ressourcen-Manifest-Referenz wenn eine Anweisung unklar ist.

Gehe bei Qbox nicht davon aus, dass jede QBCore-Ressource kompatibel ist. Lies die Anleitung zu Qbox und QBCore und verlange für das einzelne Produkt eine Aussage zur nativen Qbox-Unterstützung oder einen dokumentierten Integrationsweg über eine Bridge.

3. Installiere zuerst die MLO

1. Sichere den Server und die Datenbank, dann erstelle eine Staging-Kopie.
2. Starte nur die MLO und ihre dokumentierten Kartenabhängigkeiten.
3. Überprüfe Eingänge, Türen, Kollisionen, Beleuchtung und Fahrzeugzugang.
4. Suche nach überlappenden YMAP-, MLO- oder Vegetationsressourcen am selben Ort.
5. Notiere die genauen Koordinaten für Serviceschalter, Lager, Handwerk, Dienst und Verwaltung.

Dies trennt ein Kartenproblem von einem Job-Skript-Problem. Wenn das Gebäude allein nicht funktioniert, erschwert das Hinzufügen von Abrechnungs- und Inventarressourcen die Diagnose.

4. Definiere Jobs, Dienstgrade und Konten

Erstelle die vom Skript erwartete Job- und Dienstgradstruktur. Gleiche interne Namen genau ab: mechanic und mechanic2 sind unterschiedliche Bezeichner. Entscheide, welche Dienstgrade einstellen, Geld abheben, eingeschränkte Gegenstände herstellen oder auf die Verwaltung zugreifen können. Wenn das Skript ein Gesellschafts- oder Geschäftskonto verwendet, überprüfe, ob Ein- und Auszahlungen dieses Konto nach einer erneuten Verbindung und einem Neustart der Ressource erreichen.

5. Inventar, Target-Systeme und Koordinaten zuordnen

Füge jeden benötigten Gegenstand zum Inventar deines Servers hinzu, einschließlich Bildern und Metadaten, wo erforderlich. Ersetze die Standard-Interaktionskoordinaten des Skripts durch die im MLO aufgezeichneten Punkte. Überprüfe dann Zielzonen oder Tastenaufforderungen aus verschiedenen Entfernungen und Spielerpositionen.

Achte bei Restaurant- und Kneipenressourcen besonders auf Rezepte: Zutatennamen, Mengen, erzeugte Gegenstände und Verkaufspreise müssen zur aktiven Wirtschaft passen. Werkstattressourcen benötigen Prüfungen von Fahrzeugbesitz, Reparaturgegenständen und Abrechnung. Autohausressourcen benötigen Ausstellungs-Spawns, Bestand und Kaufvalidierung.

6. Den vollständigen Ablauf für Kunden und Mitarbeiter testen

• Mitarbeiter stempelt ein und kann nur die Aktionen ausführen, die der Dienstgrad erlaubt.
• Kunden können kaufen, eine Rechnung erhalten oder interagieren, ohne den Angestelltenjob zu haben.
• Gegenstände werden genau einmal entfernt und gewährt.
• Geschäftseinnahmen erreichen das richtige Konto.
• Bei vollen Inventaren, abgebrochenen Aktionen oder fehlenden Abhängigkeiten wird der Vorgang sicher abgebrochen.
• Der Zustand überlebt Wiederverbindungen, Skriptneustarts und einen vollständigen Serverneustart.
• Zwei Spieler, die dieselbe Station benutzen, können keine Bestände oder Belohnungen duplizieren.

Empfohlene Einrichtungsreihenfolge

1. Wähle die Geschäftslogik und das Framework.
2. Installiere das lizenzierte MLO auf einem Testserver und weise anschließend nach, dass kein Kartenkonflikt besteht.
3. Wähle ein Job-Skript mit expliziter Unterstützung für dein Framework und deinen Abhängigkeitsstapel.
4. Füge Management-, Inventar- oder Interaktionsressourcen nur hinzu, wenn der gewählte Job sie erfordert.
5. Führe Staging-Tests durch, bevor du das Setup in die Produktion importierst.

Abschließende Checkliste

Vor dem Kauf solltest du in der Lage sein, die Framework-Version, das Inventar, das Zielsystem, die Managementressource, die Methode für Geschäftskonten, Datenbankänderungen und den Kartenstandort zu benennen. Wenn einer davon unbekannt ist, frage den Ersteller oder wähle ein Produkt mit klarerer Dokumentation. Das ist schneller und günstiger, als einen inkompatiblen Geschäftsstack nach dem Start zu reparieren.

Referenzdokumentation

Quelle: docs.qbox.re

FiveM MLO-Kompatibilitätsleitfaden: Frameworks, Konflikte & Tests