How To Stream Addon Clothes/Props (FiveM Models)

Adding custom clothes and props as addons for MP Freemode models in FiveM allows you to offer more personalized and unique content to your server’s players. This guide will show you step-by-step how to stream clothes and props using YMTEditor and OpenIV, helping you integrate custom models seamlessly into the game.

Important notice: You'll need to add a Patreon key to your server.cfg - Here's how this works:
How To Add a Patreon Key to your FiveM server

• Important Terms
• Prerequisites
• Preparing Your Files
  • Configuring YMTEditor
  • Creating Meta Files
  • Setting Up FXManifest
• Testing and Troubleshooting
• FAQ

Important Terms

To follow this tutorial successfully, it’s important to understand some core concepts used in FiveM modding:

• Component: Refers to different character body parts or clothing slots, such as head, torso, or legs. There are 12 different components, each with a specific slot for customizations (e.g., uppr for torso, lowr for legs).
• Prop: Accessories that can be worn by the character, like hats or glasses. There are 13 prop slots, but only 5 are used for MP models (p_head, p_eyes, p_ears, p_lwrist, p_rwrist).
• Drawable: A .ydd file representing a model. Each component or prop can have multiple drawables (e.g., jbib_000_u and jbib_001_u for two different torso variants).
• Texture: A .ytd file applied to a drawable model. Textures must be named properly to be recognized by the game, such as xxxx_diff_###_a_uni.
• YMT File: Defines how many components, drawables, and textures the game uses for character customization.

---

Prerequisites

Before starting, ensure you have the following tools and resources:

• YMTEditor: Used for editing .ymt files. Download YMTEditor.
• OpenIV: Essential for working with .ydd and .ytd files. Download OpenIV.
• Clothing and Prop Models: Obtain the clothing or prop mods you want to add. You can find mods on GTA5-Mods.

---

Preparing Your Files

1. Download the Clothing or Prop Mods: Gather the .ydd and .ytd files for your clothing and props. Make sure these files are intended for MP Freemode models. If they are single-player models, some conversion may be required.
2. Organize the Files: Place all downloaded files into a folder. If the files contain prefixes like mp_m_freemode_01, remove these to keep the file names simple (e.g., change mp_m_freemode_01_jbib_003 to jbib_000).
3. Rename the Files: Standardize the numbering to start at 000 and increment from there (e.g., jbib_000, jbib_001). This helps avoid conflicts and keeps things organized.
4. Add a Custom Prefix: It's good practice to add a prefix to your files that matches the name of your project. For example, if your YMT file is named mp_f_freemode_01_customclothes, then your files should be renamed accordingly (e.g., mp_f_freemode_01_customclothes_jbib_000).

---

Configuring YMTEditor

1. Create a New YMT File:
   • Open YMTEditor and select New.
   • Choose the MP character you are modding for (e.g., female).
   • Name your YMT file (e.g., mp_f_freemode_01_customclothes). Ensure the name is all lowercase.
2. Enable the Components You Will Use:
   • Expand the list of components in YMTEditor and enable the relevant ones (e.g., jbib for torso, lowr for pants).
   • For each component, add new entries for the models and textures you are adding.
3. Add Textures for Each Drawable:
   • For example, if you’re adding pants (lowr), you may start with drawable 000 and add textures up to y (25 textures in total).
   • Configure the drawables with the appropriate suffix _u for universal or _r for race-specific.
4. Set Prop Mask Values:
   • If the model has exposed skin, you need to change the prop mask value to 17, 19, or 21 in YMTEditor. This ensures the game recognizes the skin data.
5. Save the YMT File:
   • Save your changes by selecting File > Save (YMT). Make sure the file name remains consistent.

---

Creating Meta Files

Create a .meta file to define how your addon clothes and props integrate into the game.

1. Create the Meta File:
   • Use a text editor to create a new file named mp_f_freemode_01_customclothes.meta.
2. Add the Following XML Structure:

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

---

Setting Up FXManifest

1. Create the FXManifest File:
   • In the folder containing your YMT and .meta files, create a new file named fxmanifest.lua.
2. Add the Following Content:

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. Make sure the file paths and names match those used in your project.
2. Add Your Resource to server.cfg:
   • Open your server's server.cfg file.
   • Add the line start customclothes (or use the name of your project folder).

Full Tutorial: FXManifest

---

Testing and Troubleshooting

1. Load Your Server:
   • Start the server and connect in FiveM.
   • Use a character editor (such as vMenu) to navigate to the new clothing components.
2. Check for Issues:
   • If clothes don’t appear, ensure all file names are consistent.
   • Check that the YMT file correctly references all drawables and textures.
   • Verify the FXManifest and .meta files for any typos or missing entries.
3. Common Issues:
   • Clothes Not Showing: Ensure the YMT file is saved correctly and that the FXManifest includes all necessary files.
   • Textures Not Loading: Double-check the naming convention of the textures and ensure they match the drawable file names.
   • Skin Color Issues: If the model includes skin, make sure you’ve set the prop mask value to 17, 19, or 21.

---

FAQ

Q: Which files are needed for clothes/props?
A: Clothes use .ydd/.ytd; props use .ydr/.ytd. Place them in stream/.

Q: Do I need to edit ped.ymt?
A: Prefer frameworks like mpclothes for freemode slots. Editing ped.ymt directly is fragile.

Q: How should the resource be structured?
A: /resources//your_clothes/stream/* with an fxmanifest.lua. Add files entries if required by type.

Q: Works on QBCore and ESX?
A: Streaming is the same; usage depends on your wardrobe/clothing script per framework.

Q: Why are textures black or invisible?
A: Wrong materials/UVs, missing mipmaps, or oversized textures. Export as DDS (BC3/BC7) with mipmaps.

Q: Props not showing—what causes it?
A: Incorrect LODs, missing collisions, or wrong model names/paths. Check console errors.

Q: How do I update safely on live servers?
A: Load into a folder, check with few players, then move to and restart during off-peak.

Q: Naming best practices?
A: Lowercase resource names, no spaces, avoid versioned folders, keep a changelog and thumbnails.

---

By following these steps, you should be able to successfully stream custom clothes and props as addons for MP Freemode models in FiveM. This will give your server a unique touch and allow players to customize their characters with a wider range of options.

Feel free to reach out for further help or share your custom content with the FiveM community!