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 mitgelieferte fxmanifest.lua, bevor du die Ressource in server.cfg einträgst. Das Manifest kann Skripte, Dateien und Abhängigkeiten ausweisen; die Dokumentation des Erstellers sollte die benötigten Ressourcen für Framework, Inventar, Targeting, Menü, Benachrichtigungen, Audio und Datenbank nennen. Nutze bei einer unklaren Anweisung die offizielle Cfx.re-Referenz zum Ressourcenmanifest.
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
- Sichere den Server und die Datenbank, dann erstelle eine Staging-Kopie.
- Starte nur die MLO und ihre dokumentierten Kartenabhängigkeiten.
- Überprüfe Eingänge, Türen, Kollisionen, Beleuchtung und Fahrzeugzugang.
- Suche nach überlappenden YMAP-, MLO- oder Vegetationsressourcen am selben Ort.
- 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
- Wähle die Geschäftslogik und das Framework.
- Installiere das lizenzierte MLO auf einem Testserver und weise anschließend nach, dass kein Kartenkonflikt besteht.
- Wähle ein Job-Skript mit expliziter Unterstützung für dein Framework und deinen Abhängigkeitsstapel.
- Füge Management-, Inventar- oder Interaktionsressourcen nur hinzu, wenn der gewählte Job sie erfordert.
- 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
FiveM MLO-Kompatibilitätsleitfaden: Frameworks, Konflikte & Tests