Log in to reply

Basic Ped YMT Editing - Components, Clothes, Textures

  • Introduction

    The Ped ymt files are manifest files containing metadata about your Peds, allowing you to customize models by changing their physical features and clothing where applicable. Not to be confused with the single file called peds.ymt.

    Changing clothes and outfits is easily done with trainer mods like Menyoo and Simple Trainer. The trainers use what are called native functions to allow you to make these wardrobe changes in game. For example the native function:
    void SET_PED_COMPONENT_VARIATION(Ped ped, int componentId, int drawableId, int textureId, int paletteId)

    There are 12 wardrobe components, described in the Native Name column of the table below. They are numbered from 0 to 11. The drawables refer for example to a shirt, or a sweater, or a tshirt. A texture on the other hand could allow one tshirt to be red or black or sport a cool logo. These different texture options are called texture variations. Together with the drawables they are called component variations.

    Native Name Description Menyoo Name
    PV_COMP_HEAD 0. Head Head
    PV_COMP_BERD 1. Masks Beard/Mask
    PV_COMP_HAIR 2. Hair Styles Hair
    PV_COMP_UPPR 3. Torsos Torso
    PV_COMP_LOWR 4. Legs Legs
    PV_COMP_HAND 5. Hands/Bags/Parachutes Hands/Back
    PV_COMP_FEET 6. Shoes Shoes
    PV_COMP_TEEF 7. Accessories Teeth/Scarf/Necklace
    PV_COMP_ACCS 8. Undershirts Accessory/Tops
    PV_COMP_TASK 9. Body Armor Task/Armour
    PV_COMP_DECL 10. Decals Emblem
    PV_COMP_JBIB 11. Tops Tops2 (Outer)

    YMT files need to be decrptyed and exported as xml (text) files before they can be modified or edited. There are two principal tools that will allow you to do this: The Meta Toolkit and CodeWalker's RPF Explorer. Both have their advantages and disadvantages.

    Exporting YMT to XML
    As stated above, ymt files can't be edited directly. In summary, this is how the two tools work.

    1. Meta Toolkit. Export the ymt file to your desktop or any folder from OpenIV. Then just drag the ymt file on top of the executable MetaTool.exe and it will automatically generate your xml file.

    2. RPF Explorer. Run the explorer and let it scan your game installation. When ready, right click your file and select export to xml.

    The two tools use different terminology, one is more cryptic than the other but you will quickly familiarize yourself with either tool as you edit your exported xml file.

    Component Meta Toolkit RPF Explorer
    Components <hash_E2489C4F> CPVComponentData
    Drawables <hash_68AC8351> CPVDrawblData
    Texture Variations <hash_4A92222A> CPVTextureData
    Available Items <hash_B29BE228>0 255 1 2 3 4 255 5 6 255 255 255</hash_B29BE228> See Below
    Available Items See Above <availComp>00FF01020304FF0506FFFFFF</availComp>

    Of course CPVTextureData is much easier to understand and relate to than <hash_4A92222A>, but you will definitely get used to the jargon in no time at all.
    When 255 appears it means that Item is not being used by the model, RPF Explorer uses the hex FF instead. The single digits in Meta Toolkit refer to the item numbers, 0 being the head and 1 the hair. RPF Explorer uses 00 and 01 for the same items respectively.

    Editing the ymt file can allow you, depending on the models, to add both drawables ( a new jacket for example) and new textures. Another example is to combine an original model with a retextured one so that you have all the clothing options in one model instead of two or more.

    Textures will generally be found in the YTD file. You can add textures or modify them and import them easily with OpenIV.

  • How to Export from YMT to XML

    The video below shows the simple steps to export your ymt to xml for editing with each of the two tools described in previous post. The output of the files is different, the terminology isn't the same for the 2 methods, as we can see in the table above.

  • Application Example

    In the video below, for personal use and as an example only, we combine 4 texture variations from an original mod and a re-textured version of this mod. Only texture variations are changed, not the Drawables, as this is a very simple example. Of course, you can also create your own drawables and/or your own textures. In fact I changed the original white pants (too bright for my liking) to black in the original mod. You can't create components however AFAIK.

    Warning: before playing with these files, backup your original files, the slightest error will either keep the ped from spawning, cause texture losses in scenery, or possibly crash your game.

    Note: you can do this for your own use, on your own system, but you will not be able to upload the mod without permission from the authors.


  • Editing the XML from the YMT

    In this video we look at adding a texture variation to the Hair Component. A texture variation in this case involves adding blonde hair to the default black hair. A drawable variation, not displayed in the video, would be for example adding a new hair style (not just the colour) but it's essentially the same process.

    The video has two examples. One with the more cryptic terminology name scheme from Meta Toolkit. The other one with the easier to understand name from RPF Explorer. Why use Meta Toolkit you ask? Much faster if you have a complex game folder structure (which is my case).

    In the video, hair is in the second component. Since numbering starts at 0, Hair will be 1 when using the Meta Toolkit and it will be 01 when using RPF Explorer.

  • Converting XML to YMT

    In this short video, with a kickass soundtrack and copyright claim, from Canadian Rock band Trooper, we will see how easy it is to convert our edited XML (from YMT) back to YMT using both tools, Meta Toolkit and RPF Explorer.

  • Importing Additional Textures

    In this last video we will look at importing the additional textures. In the previous videos we already added the extra slot for the hair. In this video we will look at adding the hair texture. It is important to rename the textures so they aren't duplicated.

    In this example both the original and the re-textured had the hair imaged named as:

    We kept the original as hair_diff_000_a_whi.dds and we renamed the re-textured one:

    What if we added a third texture? It would be hair_diff_000_c_whi.dds and what if we added a new drawable instead of just a new texture?

    For example a different hair style. It would be hair_diff_001_a_whi.dds. This time the number is incremented, from diff_000 to diff_001, rather than the letter a to b.

  • The YDD File

    Now let's look at the three other files that are generally packaged with ymt for a Normal ped (as opposed to a streaming ped). The YDD file is the drawable dictionary and can be viewed from OpenIV. The .ydd file will show us the available components, which in the .ymt were described like this:

    <hash_B29BE228>0 255 1 2 3 4 255 5 6 255 255 255</hash_B29BE228> Meta Toolkit
    <availComp>00FF01020304FF0506FFFFFF</availComp> RPF Explorer

    From the viewer for the .ydd file we see the 7 components being used (i.e. available) in alphabetical order. Remember that in the Meta Toolkit version of ymt, these 7 are displayed in numerical order: 0, 1, 2, 3, 4, 5, and 6. In RPF Explorer version of ymt, these are 00, 01, 02, 03, 04, 05, and 06.

    A word of caution for new scripters. The terminology above applies to available components and is different from the one used for the native function. Here, slot 1 is hair whereas in the native function, 2 is hair. Remember that 255 or FF means a component isn't available, so the numbering scheme for our tools skips over and increments by one. The native functions don't skip any numbers, 3 is always the torso for example.

    This can be confusing when editing the xml file from the ymt. You need to look at the order of the slots rather than their number to understand what you're editing, particularly since the xml tags will not give you any clue.

    alt text


  • The YTD File

    Now let's look at the YTD file which is the texture dictionary and can also be viewed from OpenIV. This file contains the textures for the model, although textures can also be embedded. The content and naming of the files is consistent with what we saw with the YDD file, but here you can also view texture variations.

    Here we can see the head_diff, hair_diff, lowr_diff (pants), and uppr_diff (top/torso) that we added in our videos.

    alt text

  • The YFT File
    Which brings us to the last of the 4 common files used with Normal peds. The YFT, or fragment file, contains the 3D model itself. It is best viewed from the CodeWalker Ped Viewer. In the tabs there is valuable information about the model.

    In the case of our model Faith, it is based on the story mode game model named IG_Michelle.
    Here you can see the 7 components again and this can help you number them, remembering to skip the blanks:

    1. head, 2. hair, 3. upper, 4. lowr, 5. hand, 6. teef, 7. accs

    alt text


  • The YLD File

    Although not discussed within the scope of editing ymt files, for those who are curious you may also see on occasion a yld file, which is the cloth dictionary file - it defines the cloth physics available in certain models. It isn't very common.

    alt text

  • Breaking Convention

    And for those who finally got comfortable with the naming conventions used in GTA5 such as WTF do they call it Teef or Jbib, you will sometimes be surprised with terminology that uses words such as face or jacket. For example this model below.

    Actually when it comes to respecting rules and conventions, this tutorial describes those the game peds adhere to. Addon ped mods however are another matter as mod creators often make up their own rules. For example, some will use legs to display glasses - not very intuitive to say the least.

    However, the YMT file structure remains the same even for these rebels. Which brings us to one unfortunate point. Despite your best efforts, patience, and attention to detail, there is absolutely no guarantee changes you make will work with the model you are working on. Unless you can examine the model itself, ideally in Zmodeler (the tool most frequently used to create 3rd party peds), you can never fully understand the underlying structure of the model.

    alt text

  • A Note About Streamed Peds

    Contrary to popular belief streamed peds are not peds with their own Twitch channels. Streamed peds differ from Normal peds in that they have a folder containing many ytd and ydd files, 1 file for each different texture variation. Contrast that with Normal peds which only have 1 ytd file and 1 ydd file as containers for all the textures.

    Streamed Peds however only have 1 ymt and 1 yft files as is the case for their Normal ped counterparts. Examples of Streamed Peds are player_zero (Michael), player_one (Franklin), and player_two (Trevor). The MP male and MP shemale are also streamed peds.


  • Peds.ymt

    The .ymt files described in this tutorial should not be confused with the file called peds.ymt. This file is also an xml file but it isn't encrypted so it can be easily edited from OpenIV (or a text editor). It contains metadata for all vanilla peds. If you are using @ReNNie's addonpeds template then you will edit a similar file for addon peds but the file is called peds.meta.

    You will find peds.ymt at \update\update.rpf\x64\data and \mods\update\update.rpf\x64\data

    Examples of the medatdata, which is quite extensive and very different from the ymt files in this tutorial:

          <IsStreamedGfx value="false"/>
          <AmbulanceShouldRespondTo value="true"/>
          <CanRideBikeWithNoHelmet value="false"/>
          <CanSpawnInCar value="false"/>
          <IsHeadBlendPed value="false"/>
          <bOnlyBulkyItemVariations value="false"/>
          <FUpOffset value="0.00000000"/>
          <RUpOffset value="0.00000000"/>
          <FFrontOffset value="0.00000000"/>
          <RFrontOffset value="0.14700000"/>
          <MinActivationImpulse value="20.00000000"/>
          <Stubble value="0.00000000"/>
          <HDDist value="3.00000000"/>
          <TargetingThreatModifier value="1.00000000"/>
          <KilledPerceptionRangeModifer value="-1.00000000"/>
          <Age value="0"/>
          <MaxPassengersInCar value="0"/>
          <DefaultRemoveRangeMultiplier value="1.00000000"/>
          <AllowCloseSpawning value="false"/>

  • Hello!
    This is all very interesting information, now my question is, how do you enable YLDs for a specific ped YMT?
    I noticed some peds can't have YLD associated with them such as mp_m_freemode_01

  • @Quechus13 model needs to allow for cloth physics. Very late reply!


  • This post is deleted!

Log in to reply

Looks like your connection to GTA5-Mods.com Forums was lost, please wait while we try to reconnect.