Skip to content

Import FFXIV Model

Jump to bottom
wikid24 edited this page Feb 19, 2024 · 12 revisions
Image Sections
image - Import FFXIV .fbx File
- Load Sample
- Initialize MMD Struture
- TexTools 'Saved' Folder
- Anamnesis .chara File Read
- Anamnesis .chara File Apply To Model
- Color Swatches

Import FFXIV .fbx File

  • Imports a FFXIV Model's .fbx file into Blender, using these paramaters:

    • primary_bone_axis='X'
    • secondary_bone_axis='Y'
    • use_manual_orientation=True
    • axis_forward='Y'
    • axis_up='Z'

  • Rotates the armature 90 degrees from the origin point, and presses 'Apply all transformations' so that Blender will treat this orientation as the 'rest' position. It's Important to apply transforamtions before importing VMD animation files, as it starts using this data for keyframes.

  • Moves all 'Group' objects to an empty object called 'FFXIV Empty Groups'

  • Update all material properties:

    • Fixes the alpha blend mode so that all the textures can be viewed properly (blend_method = 'HASHED')
    • Turns on backface culling (use_backface_culling = True)

  • Update meshes:

    • Adds the"mmd_bone_order_override" armature modifier to the FIRST mesh on n_root (as per the MMD Tools instructions)
    • Renames the meshes objects to something that is more human-readable

  • Adds custom object/data properties:

    • Armature object:

      • ModelRaceType (used by various functions in this addon for automating settings such as Auto-Applying the MekTools Rig)
      • original_root_name (MMD Tools moves the armature to a new object called 'New MMD Model' upon converting it, so it's useful to know the original name sometimes)
      • image

    • Edit bone data: <-- This is captured to that if you change an edit bone's position you can reset the edit bone at any time

      • the head bone local position
      • the tail bone local position
      • the matrix local position
        image

    • Mesh data:

      • ModelID - Parsed from original object name
      • ModelRaceID - Parsed from original object name
      • ModelNumberID - Parsed from original object name
      • ModelTypeID - Parsed from original object name
      • MeshPartNumber - Parsed from original object name
      • original_mesh_name - Parsed from original object name
      • original_material_name - Parsed from active material name
      • MaterialType - Parsed from active material name
      • ModelName - Parsed from FFXIV TexTools folder (if folder name found in TexTools 'Saved' Folder)
      • material_filepath - Parsed from FFXIV TexTools folder (if folder name found in TexTools 'Saved' Folder)
        image

Load Sample

  • Import an example .fbx model that is included with the plugin, and applies the same transformations that Import FFXIV .fbx File does:
    • AuRa Female
    • Elezen Female
    • Hrothgar Male
    • Hyur Highlander Female
    • Hyur Midlander Female
    • Lalafell Female
    • Miqote Female
    • Roegadyn Female
    • Viera Female

Useful if you need to quickly compare and diagnose your own .fbx file vs one I created for my testing, or you just need a test out each race really quickly.

Initialize MMD Struture

Shortcut to the MMD Tools addon's Convert Model feature:

  • Convert the model to an MMD Model's format adding all the properties and data needed to convert and use as a MMD Model.
  • Moves your FFXIV Character's armature n_root from it's original object (your character's .fbx file name) to a new root object called 'New MMD Model'

image image

TexTools 'Saved' Folder

Saved' Folder where TexTools exports all textures and models by default. Used for pulling in extra custom properties details upon .FBX Import:

  • Mesh data:
    • ModelName - Parsed from FFXIV TexTools folder (if folder name found in TexTools 'Saved' Folder)
    • material_filepath - Parsed from FFXIV TexTools folder (if folder name found in TexTools 'Saved' Folder)

Anamnesis .chara File Read:

Reads the .chara file and outputs to the results to Blender's System Console:

image

  1. DIAGNOSIS: If an armature is selected, it compares the selected armature against the .chara file to see if it has all the correct equipment attached from TexTools. Useful if you made any mistakes exporting gear out of TexTools (such as the wrong equipment)

  2. Outputs the following data used for TexTools .fbx export:

    • Skin Color (hex value) - Colors vary depending on the Race, Tribe and Gender of the what is in the .Chara file
    • Hair Color (hex value) - Colors vary depending on the Race, Tribe and Gender of the what is in the .Chara file
    • Hair Highlights Color (hex value) - If hair highlights is disabled, will output the hair color
    • Iris Color (hex value)
    • Lip/Fur Color: (hex value)
    • Tattoo/Limbal Color: (hex value)
    • Race, Tribe, Gender
    • Face Model: modelID (can be copy & pasted directly to TexTools search bar)
    • Hair Model: modelID (can be copy & pasted directly to TexTools search bar)
    • Tail Model: modelID (can be copy & pasted directly to TexTools search bar)
    • Body Gear: equipment ID (cannot parse the model variation if the model is shared in TexTools)
    • Legs Gear: equipment ID (cannot parse the model variation if the model is shared in TexTools)
    • Head Gear: equipment ID (cannot parse the model variation if the model is shared in TexTools)
    • Hand Gear: equipment ID (cannot parse the model variation if the model is shared in TexTools)
    • Feet Gear: equipment ID (cannot parse the model variation if the model is shared in TexTools)
    • Earring Gear: accessory ID (cannot parse the model variation if the model is shared in TexTools)
    • Necklace Gear: accessory ID (cannot parse the model variation if the model is shared in TexTools)
    • Wrists Gear: accessory ID (cannot parse the model variation if the model is shared in TexTools)
    • Ring Left Gear: accessory ID (cannot parse the model variation if the model is shared in TexTools)
    • Ring Right Gear: accessory ID (cannot parse the model variation if the model is shared in TexTools)

Sample Video:

Desktop.2023.10.27.-.00.30.34.12.Dvr-00.00.04.000-00.02.04.199.v2.mp4

Anamnesis .chara File Apply To Model:

In addition to what .chara File Read does, also:

  1. Applies the Facial Deformation Shape Keys (shp_brw_a, etc) to the all the meshes attached to the selected armature with a matching shape key name by setting the values to 1.0. Values are mapped in the Chara File Dictionary

    image

  2. Adds the FFXIV Race's MMD Facial Expression Bone Morphs (eye blink, smile, etc.) to the model (only works if the model has been converted to MMD Format).

    image

  3. Adds .chara file custom properties to the armature object:

    • Facial Deformation ID (based on the FFXIV tribe & gender's face part selectors in-game)
      • Eyes
      • Eyebrows
      • Mouth
      • Nose
      • Jaw
    • Body Type IDs
      • ObjectKind
      • Race
      • Tribe
      • Gender
      • Head
      • Hair
      • TailEarsType
      • Bust
      • EnableHighlights (hair)
    • Equipment Gear IDs
      • HeadGear
      • Body
      • Hands
      • Legs
      • Feet
      • Ear (earrings)
      • Neck (necklace)
      • Wrists
      • LeftRing
      • RightRing
    • Colors (hex)
      • Skintone
      • HairTone
      • Highlights
      • LimbalEyes
      • REyeColor
      • LipsToneFurPattern
      • FacePaintColor
    • Random Stuff
      • SkinGloss (rgb)? I dunno.
      • BustScale (x,y,z)
      • FacialFeatures (Facial Checkbox flags)

    image

Color Swatches

image

Various colors displayed for the colors from the .chara file. Color Swatches are based on the FFXIV Color Hex Reference Guide.

Displays for:

Clone this wiki locally