Installiere jede Karte oder jedes Fahrzeug als unabhängige Ressource, behalte die ursprüngliche Struktur bei, deklariere nur die benötigten Datendateien und teste es auf einer Staging-Umgebung, bevor du es in Produktion nimmst. Karten und Fahrzeuge teilen sich denselben Ressourcen-Lebenszyklus, aber ihre Assets und Validierungsschritte unterscheiden sich.
Bestätige die Ziel-GTA-Edition, bevor du Assets installierst oder exportierst. Legacy-Pakete sind nicht automatisch Enhanced-ready; befolge die offizielle Anleitung zur Enhanced-Asset-Konvertierung wenn dies dein Ziel ist.
Wähle den richtigen Pfad
| Ressource | Typischer Inhalt | Ausführlichere Anleitung |
|---|---|---|
| Karte/MLO | .ymap, .ytyp, Modelle, Texturen und Kollision |
Füge einen FiveM MLO zu einem Server hinzu |
| Fahrzeug | .yft, .ytd und dokumentierte Fahrzeug-Meta-Dateien |
Befolge die aktuellen Installationshinweise des Pakets. |
Gemeinsame Vorprüfungen
- Überprüfe den Ersteller, die Quelle, die Lizenz, die Version und das unterstützte Spiel-Build/Framework.
- Scanne das Archiv und bewahre das Originalpaket als Rollback-Nachweis auf.
- Sichere die Konfiguration und alle Ressourcen, die das Paket ersetzt.
- Entpacke es in einen dedizierten Ressourcenordner mit
fxmanifest.luaim Stammverzeichnis. - Lies die Abhängigkeiten und Installationshinweise, bevor du das Manifest änderst.
Installiere eine Kartenressource
Behalte die mitgelieferten .ymap, .ytyp, Modell-, Textur- und Kollisionsdateien zusammen. Bewahre das Manifest des Erstellers auf. Verwende this_is_a_map oder eine DLC_ITYP_REQUEST Deklaration nur, wenn das Paket und die aktuelle Cfx.re-Dokumentation sie erfordern; das blinde Hinzufügen von Direktiven kann den eigentlichen Verpackungsfehler verbergen.
Starte die Ressource auf der Staging-Umgebung, fahre die gesamte Grenze ab, inspiziere Innenräume und Kollisionen und überprüfe auf doppelte Kartenplatzierungen oder eine andere Ressource, die denselben Bereich bearbeitet. Teste aus der Ferne und nach dem erneuten Verbinden, nicht nur am Spawn-Punkt.
Installiere eine Fahrzeugressource
Behalte die Modell- und Textur-Assets mit den exakt dokumentierten Metadaten-Dateien. Gängige Pakete verwenden Einträge wie Fahrzeuge, Handling, Fahrzeugvarianten und Fahrzeugfarben, aber die korrekten data_file Typen stammen aus dem Paket und der offiziellen Datenreferenz. Füge nicht jede bekannte Deklaration in jedes Fahrzeugmanifest ein.
Ein Modellname garantiert keinen Spawn-Befehl. Das Spawnen gehört zum installierten Framework, Admin-Menü oder zur Fahrzeugressource. Überprüfe den konfigurierten Modellnamen und verwende den dokumentierten Befehl oder den Garagen-Workflow.
Aktiviere in Abhängigkeitsreihenfolge
Füge einen ensure resource-name Eintrag nach den benötigten Bibliotheken und vor davon abhängigen Ressourcen hinzu. Starte den Staging-Server neu und prüfe Serverkonsole sowie F8-Clientkonsole. Behebe fehlende Dateien, fehlerhafte Manifeste und doppelte Namen, statt lediglich immer wieder neu zu starten.
Teste die vollständige Ressource
- Karte: Platzierung, Portale, Kollision, Okklusion, Beleuchtung, Türen und widersprüchliche IPL-/Kartenbearbeitungen.
- Fahrzeug: Spawn, Texturen, Sitze, Türen, Lichter, Audio, Handling, Schaden und Garagenpersistenz.
- Beide: sauberer Client-Download, erneute Verbindung, Server-Neustart, Ressourcen-Neustart und Protokollausgabe.
Isoliere Konflikte
Deaktiviere andere Ressourcen, die denselben Kartenbereich, Modellnamen oder Metadateneintrag ändern, und aktiviere sie dann einzeln wieder. Ändere nur eine Variable pro Test. Das Umbenennen eines Ressourcenordners löst keine widersprüchlichen Asset-Identifikatoren darin.
Wiederherstellung
Entferne den neuen ensure Eintrag, stelle die vorherigen Dateien/Konfiguration wieder her und mache dokumentierte Datenbankänderungen rückgängig. Starte neu und wiederhole die Basisroute oder den Fahrzeugfluss. Halte die Ressource deaktiviert, bis der Fehler reproduziert und auf dem Staging behoben ist.