Wie man Addon-Klamotten/Props (FiveM-Modelle) streamt

Das Hinzufügen von benutzerdefinierten Klamotten und Props als Addons für MP-Freemode-Modelle in FiveM ermöglicht es dir, deinen Spielern persönlichere und einzigartigere Inhalte zu bieten. Diese Anleitung zeigt dir Schritt für Schritt, wie du Klamotten und Props mit YMTEditor und OpenIV streamst, um benutzerdefinierte Modelle nahtlos ins Spiel zu integrieren.

Wichtiger Hinweis: Du musst einen Patreon-Schlüssel zu deiner server.cfg hinzufügen – So funktioniert das: Wie man einen Patreon-Schlüssel zum FiveM-Server hinzufügt

Inhaltsverzeichnis

• Wichtige Begriffe
• Voraussetzungen
• Dateien vorbereiten
  • YMTEditor konfigurieren
  • Meta-Dateien erstellen
  • FXManifest einrichten
  • Testen und Fehlerbehebung
  • FAQ

Wichtige Begriffe

Um diesem Tutorial erfolgreich zu folgen, ist es wichtig, einige grundlegende Konzepte des FiveM-Moddings zu verstehen:

• Komponente: Bezieht sich auf verschiedene Körperteile oder Kleidungsslots des Charakters, wie head, torso oder legs. Es gibt 12 verschiedene Komponenten, jede mit einem spezifischen Slot für Anpassungen (z.B. uppr für Oberkörper, lowr für Beine).
• Prop: Accessoires, die der Charakter tragen kann, wie Hüte oder Brillen. Es gibt 13 Prop-Slots, aber nur 5 werden für MP-Modelle verwendet (p_head, p_eyes, p_ears, p_lwrist, p_rwrist).
• Drawable: Eine .ydd-Datei, die ein Modell darstellt. Jede Komponente oder Prop kann mehrere Drawables haben (z.B. jbib_000_u und jbib_001_u für zwei verschiedene Oberkörpervarianten).
• Textur: Eine .ytd-Datei, die auf ein Drawable-Modell angewendet wird. Texturen müssen korrekt benannt sein, damit das Spiel sie erkennt, z.B. xxxx_diff_###_a_uni.
• YMT-Datei: Definiert, wie viele Komponenten, Drawables und Texturen das Spiel für die Charakteranpassung verwendet.

---

Voraussetzungen

Stelle vor dem Start sicher, dass du folgende Tools und Ressourcen hast:

• YMTEditor: Zum Bearbeiten von .ymt-Dateien. YMTEditor herunterladen.
• OpenIV: Unverzichtbar für die Arbeit mit .ydd- und .ytd-Dateien. OpenIV herunterladen.
• Kleidungs- und Prop-Modelle: Besorge dir die Kleidungs- oder Prop-Mods, die du hinzufügen möchtest. Mods findest du auf GTA5-Mods.

---

Dateien vorbereiten

1. Kleidungs- oder Prop-Mods herunterladen: Sammle die .ydd- und .ytd-Dateien für deine Klamotten und Props. Stelle sicher, dass diese Dateien für MP-Freemode-Modelle gedacht sind. Wenn es Einzelspieler-Modelle sind, kann eine Konvertierung erforderlich sein.
2. Dateien organisieren: Lege alle heruntergeladenen Dateien in einem Ordner ab. Wenn die Dateien Präfixe wie mp_m_freemode_01 enthalten, entferne diese, um die Dateinamen einfach zu halten (z.B. mp_m_freemode_01_jbib_003 zu jbib_000 umbenennen).
3. Dateien umbenennen: Standardisiere die Nummerierung beginnend bei 000 und erhöhe sie von dort aus (z.B. jbib_000, jbib_001). Das hilft, Konflikte zu vermeiden und alles übersichtlich zu halten.
4. Benutzerdefiniertes Präfix hinzufügen: Es empfiehlt sich, deinen Dateien ein Präfix hinzuzufügen, das dem Namen deines Projekts entspricht. Wenn deine YMT-Datei z.B. mp_f_freemode_01_customclothes heißt, sollten deine Dateien entsprechend umbenannt werden (z.B. mp_f_freemode_01_customclothes_jbib_000).

---

YMTEditor konfigurieren

1. Eine neue YMT-Datei erstellen:
   • Öffne YMTEditor und wähle Neu.
   • Wähle den MP-Charakter aus, für den du moddest (z.B. weiblich).
   • Benenne deine YMT-Datei (z.B. mp_f_freemode_01_customclothes). Stelle sicher, dass der Name vollständig in Kleinbuchstaben ist.
   • Die verwendeten Komponenten aktivieren:
     • Klappe die Komponentenliste in YMTEditor auf und aktiviere die relevanten (z.B. jbib für Oberkörper, lowr für Hosen).
     • Füge für jede Komponente neue Einträge für die hinzugefügten Modelle und Texturen hinzu.
     • Texturen für jedes Drawable hinzufügen:
       • Wenn du z.B. Hosen (lowr) hinzufügst, beginnst du vielleicht mit Drawable 000 und fügst Texturen bis y hinzu (insgesamt 25 Texturen).
       • Konfiguriere die Drawables mit dem passenden Suffix _u für universal oder _r für rassenspezifisch.
       • Prop-Mask-Werte setzen:
         • Wenn das Modell freie Haut zeigt, musst du den Prop-Mask-Wert in YMTEditor auf 17, 19 oder 21 ändern. Dies stellt sicher, dass das Spiel die Hautdaten erkennt.
         • Die YMT-Datei speichern:

           • Speichere deine Änderungen mit Datei > Speichern (YMT). Stelle sicher, dass der Dateiname konsistent bleibt.

             ---

             Meta-Dateien erstellen

             Erstelle eine .meta-Datei, die definiert, wie deine Addon-Klamotten und Props ins Spiel integriert werden.

             1. Die Meta-Datei erstellen:
                • Verwende einen Texteditor, um eine neue Datei namens mp_f_freemode_01_customclothes.meta zu erstellen.
                • Folgende XML-Struktur hinzufügen:

                        <?xml version="1.0" encoding="UTF-8"?>
                        <ShopPedApparel>
                          <pedName>mp_f_freemode_01</pedName>
                          <dlcName>customclothes</dlcName>
                          <fullDlcName>mp_f_freemode_01_customclothes</fullDlcName>
                          <eCharacter>SCR_CHAR_MULTIPLAYER_F</eCharacter>
                          <creatureMetaData>MP_CreatureMetadata_customclothes</creatureMetaData>
                          <pedOutfits></pedOutfits>
                          <pedComponents></pedComponents>
                          <pedProps></pedProps>
                        </ShopPedApparel>

---

FXManifest einrichten

1. Die FXManifest-Datei erstellen:
   • Erstelle im Ordner mit deinen YMT- und .meta-Dateien eine neue Datei namens fxmanifest.lua.
   • Folgenden Inhalt hinzufügen:

fx_version 'cerulean'

                        game 'gta5'

                        files {
                          'mp_f_freemode_01_customclothes.meta'
                        }

data_file 'SHOP_PED_APPAREL_META_FILE' 'mp_f_freemode_01_customclothes.meta'

1. Stelle sicher, dass Dateipfade und Namen mit denen in deinem Projekt übereinstimmen.
2. Deine Ressource zur server.cfg hinzufügen:
   • Öffne die server.cfg deines Servers.
   • Füge die Zeile start customclothes hinzu (oder den Namen deines Projektordners).

                                [Vollständiges Tutorial: FXManifest](https://vertexmods.com/blog/setting-up-fxmanifest-lua-fivem)

---

Testen und Fehlerbehebung

1. Deinen Server laden:
   • Starte den Server und verbinde dich in FiveM.
   • Verwende einen Charakter-Editor (z.B. vMenu), um zu den neuen Kleidungskomponenten zu navigieren.
   • Nach Problemen suchen:
     • Wenn Klamotten nicht erscheinen, stelle sicher, dass alle Dateinamen konsistent sind.
     • Überprüfe, ob die YMT-Datei alle Drawables und Texturen korrekt referenziert.
     • Überprüfe FXManifest und .meta-Dateien auf Tippfehler oder fehlende Einträge.
     • Häufige Probleme:

       • Klamotten werden nicht angezeigt: Stelle sicher, dass die YMT-Datei korrekt gespeichert ist und das FXManifest alle notwendigen Dateien enthält.

       • Texturen werden nicht geladen: Überprüfe die Namenskonvention der Texturen und stelle sicher, dass sie mit den Drawable-Dateinamen übereinstimmen.

       • Hauttonfehler: Wenn das Modell Haut enthält, stelle sicher, dass du den Prop-Mask-Wert auf 17, 19 oder 21 gesetzt hast.

         ---

         FAQ

         F: Welche Dateien werden für Klamotten/Props benötigt?

                                                A: Klamotten verwenden .ydd/.ytd; Props verwenden .ydr/.ytd. Lege sie in stream/ ab.

F: Muss ich ped.ymt bearbeiten? A: Bevorzuge Frameworks wie mpclothes für Freemode-Slots. Das direkte Bearbeiten von ped.ymt ist fehleranfällig.

F: Wie sollte die Ressource strukturiert sein?

                                                A: /resources/[stream]/deine_klamotten/stream/* mit einer fxmanifest.lua. Füge files-Einträge hinzu, wenn der Typ es erfordert.

F: Funktioniert das mit QBCore und ESX?

                                                A: Das Streaming ist identisch; die Verwendung hängt von deinem Kleidungsskript je nach Framework ab.

F: Warum sind Texturen schwarz oder unsichtbar?

                                                A: Falsche Materialien/UVs, fehlende Mipmaps oder zu große Texturen. Exportiere als DDS (BC3/BC7) mit Mipmaps.

F: Props werden nicht angezeigt – was ist die Ursache? A: Falsche LODs, fehlende Kollisionen oder falsche Modellnamen/-pfade. Überprüfe die Konsolenfehler.

F: Wie aktualisiere ich sicher auf Live-Servern?

                                                A: Lade in einen [test]-Ordner, prüfe mit wenigen Spielern, dann verschiebe in [stream] und starte außerhalb der Stoßzeiten neu.

F: Benennungs-Best-Practices? A: Kleingeschriebene Ressourcennamen, keine Leerzeichen, keine versionierten Ordner, führe ein Änderungsprotokoll und Vorschaubilder.

---

Wenn du diese Schritte befolgst, solltest du in der Lage sein, erfolgreich benutzerdefinierte Klamotten und Props als Addons für MP-Freemode-Modelle in FiveM zu streamen. Das gibt deinem Server eine einzigartige Note und ermöglicht es den Spielern, ihre Charaktere mit einer breiteren Auswahl an Optionen anzupassen.

                                                Kontaktiere uns gerne für weitere Hilfe oder teile deine benutzerdefinierten Inhalte mit der [FiveM-Community](https://vertexmods.com/blog/how-to-find-fivem-communities/)!