Hoe add-on kleding\/props te streamen (FiveM-modellen)

Het toevoegen van aangepaste kleding en rekwisieten als add-ons voor MP Freemode-modellen in FiveM stelt je in staat om meer gepersonaliseerde en unieke inhoud aan te bieden aan de spelers van je server. Deze gids laat je stap voor stap zien hoe je kleding en rekwisieten kunt streamen met YMTEditor en OpenIV, en helpt je om aangepaste modellen gedocumenteerd in het spel te integreren.

Belangrijke mededeling: Je moet een Patreon-sleutel toevoegen aan je server.cfg – Zo werkt het:
Hoe voeg je een Patreon-sleutel toe aan je FiveM-server

Belangrijke termen

Om deze tutorial succesvol te volgen, is het belangrijk om enkele kernconcepten te begrijpen die worden gebruikt in FiveM modding:

• Onderdeel: Verwijst naar verschillende lichaamsdelen of kledingslots van het personage, zoals head, torso, of legs. Er zijn 12 verschillende componenten, elk met een specifiek slot voor aanpassingen (bijv., uppr voor de romp, lowr voor de benen).
• Prop: Accessoires die door het personage kunnen worden gedragen, zoals hoeden of brillen. Er zijn 13 prop-slots, maar slechts 5 worden gebruikt voor MP-modellen (p_head, p_eyes, p_ears, p_lwrist, p_rwrist).
• Drawable: A .ydd bestand dat een model vertegenwoordigt. Elk component of prop kan meerdere drawables hebben (bijv., jbib_000_u En jbib_001_u voor twee verschillende rompvarianten).
• Texture: A .ytd bestand toegepast op een drawable model. Texturen moeten correct worden benoemd om door het spel te worden herkend, zoals xxxx_diff_###_a_uni.
• YMT Bestand: Definieert hoeveel componenten, drawables en texturen het spel gebruikt voor karakteraanpassing.

---

Voorwaarden

Voordat je begint, zorg ervoor dat je de volgende tools en bronnen hebt:

• YMTEditor: Gebruikt voor het bewerken van .ymt bestanden. Download YMTEditor.
• OpenIV: Essentieel voor het werken met .ydd En .ytd files. Download OpenIV.
• Kleding- en Prop Modellen: Verkrijg de kleding- of prop mods die je wilt toevoegen. Je kunt mods vinden op GTA5-Mods.

---

Uw bestanden voorbereiden

1. Download de Kleding- of Prop Mods: Verzamel de .ydd En .ytd bestanden voor je kleding en props. Zorg ervoor dat deze bestanden bedoeld zijn voor MP Freemode modellen. Als het single-player modellen zijn, kan enige conversie nodig zijn.
2. Organiseer de Bestanden: Plaats alle gedownloade bestanden in een map. Als de bestanden voorvoegsels bevatten zoals mp_m_freemode_01, verwijder deze om de bestandsnamen eenvoudig te houden (bijv. verander mp_m_freemode_01_jbib_003 naar jbib_000).
3. Hernoem de Bestanden: Standaardiseer de nummering om te beginnen bij 000 en verhoog vanaf daar (bijv., jbib_000, jbib_001). Dit helpt conflicten te voorkomen en houdt dingen georganiseerd.
4. Voeg een aangepast voorvoegsel toe: Het is een goede gewoonte om een voorvoegsel aan je bestanden toe te voegen dat overeenkomt met de naam van je project. Als je YMT-bestand bijvoorbeeld de naam mp_f_freemode_01_customclothes, dan moeten je bestanden dienovereenkomstig worden hernoemd (bijv., mp_f_freemode_01_customclothes_jbib_000).

---

YMTEditor configureren

1. Maak een nieuw YMT-bestand:
   • Open YMTEditor en selecteer Nieuw.
   • Kies het MP-personage waarvoor je een mod maakt (bijv., vrouwelijk).
   • Geef je YMT-bestand een naam (bijv., mp_f_freemode_01_customclothes). Zorg dat de naam geheel in kleine letters is.
2. Schakel de componenten in die je gaat gebruiken:
   • Vouw de lijst met componenten uit in YMTEditor en schakel de relevante in (bijv., jbib voor de romp, lowr voor broeken).
   • Voeg voor elk component nieuwe vermeldingen toe voor de modellen en texturen die je toevoegt.
3. Voeg texturen toe voor elke drawable:
   • Bijvoorbeeld, als je broeken toevoegt (lowr), kun je beginnen met drawable 000 en texturen toevoegen tot y (25 texturen in totaal).
   • Configureer de drawables met het juiste achtervoegsel _u voor universeel of _r voor racespecifiek.
4. Prop Mask Waarden instellen:
   • Als het model blootgestelde huid heeft, moet u de prop mask waarde wijzigen naar 17, 19 of 21 in YMTEditor. Dit zorgt ervoor dat het spel de huidgegevens herkent.
5. Sla het YMT Bestand op:
   • Sla je wijzigingen op door te selecteren Bestand > Opslaan (YMT). Zorg ervoor dat de bestandsnaam consistent blijft.

---

Metabestanden aanmaken

Maak een .meta bestand om te definiëren hoe je addon-kleding en props integreren in het spel.

1. De Meta File aanmaken:
   • Gebruik een teksteditor om een nieuw bestand te maken met de naam mp_f_freemode_01_customclothes.meta.
2. Voeg de volgende XML Structuur toe:

<?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 instellen

1. Maak het FXManifest-bestand:
   • In de map met uw YMT en .meta bestanden, maak een nieuw bestand aan met de naam fxmanifest.lua.
2. Voeg de volgende inhoud toe:

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. Zorg ervoor dat de bestandspaden en -namen overeenkomen met die in uw project worden gebruikt.
2. Voeg je Resource toe aan server.cfg:
   • Open uw server's server.cfg bestand.
   • Voeg de regel toe start customclothes (of gebruik de naam van uw projectmap).

---

Testen en Probleemoplossing

1. Laad je server:
   • Start de server en verbinden in FiveM.
   • Gebruik een character editor (zoals vMenu) om naar de nieuwe kledingcomponenten te navigeren.
2. Controleer op problemen:
   • Als kleding niet verschijnt, zorg er dan voor dat alle bestandsnamen consistent zijn.
   • Controleer of het YMT-bestand correct verwijst naar alle drawables en texturen.
   • Verifieer de FXManifest en .meta bestanden op typefouten of ontbrekende vermeldingen.
3. Veelvoorkomende problemen:
   • Kleding wordt niet weergegeven: Zorg ervoor dat het YMT-bestand correct is opgeslagen en dat de FXManifest alle benodigde bestanden bevat.
   • Texturen laden niet: Controleer de naamgevingsconventie van de texturen en zorg ervoor dat deze overeenkomen met de bestandsnamen van de drawables.
   • Problemen met huidskleur: Als het model skins bevat, zorg er dan voor dat je de prop mask-waarde hebt ingesteld op 17, 19 of 21.

---

FAQ

V: Welke bestanden zijn nodig voor kleding/props?
A: Kleding gebruikt .ydd/.ytd; props gebruiken .ydr/.ytd. Plaats ze in stream/.

V: Moet ik ped.ymt bewerken?
A: Geef de voorkeur aan frameworks zoals mpclothes voor freemode slots. Het direct bewerken van ped.ymt is fragiel.

V: Hoe moet de resource gestructureerd worden?
A: /resources/[stream]/your_clothes/stream/* met een fxmanifest.lua. Voeg bestanden toe indien vereist per type.

V: Werkt op QBCore en ESX?
A: Streaming is hetzelfde; het gebruik is afhankelijk van je garderobe/kledingscript per framework.

V: Waarom zijn texturen zwart of onzichtbaar?
A: Verkeerde materialen/UVs, ontbrekende mipmaps, of te grote textures. Exporteer als DDS (BC3/BC7) met mipmaps.

V: Props worden niet weergegeven - wat is de oorzaak?
A: Onjuiste LODs, ontbrekende collisies of verkeerde modelnamen/paden. Controleer consolefouten.

V: Hoe update ik veilig op live servers?
A: Laad in een [test] map, controleer met een paar spelers, verplaats dan naar [stream] en herstart tijdens daluren.

V: Naamgevingspraktijken?
A: Gebruik kleine letters voor resourcenamen, geen spaties, vermijd versienummers in mappen, houd een wijzigingslogboek en miniaturen bij.

---

Door deze stappen te volgen, zou je in staat moeten zijn om succesvol aangepaste kleding en props te streamen als add-ons voor MP Freemode modellen in FiveM. Dit geeft je server een unieke touch en stelt spelers in staat om hun personages aan te passen met een breder scala aan opties.

Neem gerust contact op voor verdere hulp of deel uw aangepaste inhoud met de FiveM-gemeenschap!