FF14 Asset Reference Document
This Document contains information sourced from and annotated from the FF14 Textooles Reference Document by Sel. It has been updated in some places and had some annotations added by me, however most of the information credit must go to it's original creator.
This Doc will only contain Dawntrail-specific information, until the last page which will have anything from Endwalker that changed as a reference, but the information in that page should not be used outside of comparison's sake. I will try to keep this as up to date with the GSheets as I can, but for the fastest updates and an Excel spreadsheet format, please check the original document.
- (Dawntrail) Shader Reference Table
- Attribute Reference Tables
- Shapes Reference Table
- Visibility Reference Tables
- (Dawntrail) Colorset Values reference table
- Dye templates and Tile References
- Racial Scaling tree (wip, outdated)
- Bone list and Bone Scaling notes.
- Outdated tables (cross-reference only)
(Dawntrail) Shader Reference Table
This page is a list of tables with explinations/annotations of how the New shaders in dawntrail work. Most of this page has been adapted from the Textools Reference Document by Sel. Extra information is added based on research and conversations in modding creation discords, mainly the Textools and Bibo+ Discords.
This page is partially incomplete as we still do not fully understand every shader. Shaders with entirely blank boxes are those that we know exist, but do not understand how they work. Any important notes or observations about these shaders will be notated below their shader tables in Red.
The following explains how each color/data channel is used in each shader.
Channels are listed by their Default Behavior whenever variable.
Channels listed in Purple are variable and affected by shader keys. These will be listed Below each main table for the shader, before any notes or annotations.
SubSurface Scattering (SSS) and Fur Settings are controlled by the same channels/fields when applicable
Please note that all textures making use of an alpha channel for non-transparency should be saved as either .DDS or .TGA when bringing it in/out of an art program. PNG frequently gets mishandled by programs and ends up "eating" the alpha channel or forcing it as transparency, which destroys the data used.
FFXIV uses the OpenGL format for Normal map direction (Y+ up if you are using a software with diffuse to normal generation capabilities)
This is the standard shader used for most things you would mod (gear, minions, mounts, weapons) that are not options tied to the CHaracter creator. This shader will probbaly be the one you look at most often. There are a few other things that this shader can do based on keys, and I will explain them below.
This shader can make use of a field named "Effect ID". There appear to be 5 total shader effects, and number 3 Is what's used for a holographic/iridescent effect seen on some new gear. In order to utilize these effects, you must also set a value for "Effect Opacity". 0 means there will be no effect, 1 is full effect, and over 1 appears to be multiplicative. This effect is only possible on gear with the new Character shader, and not Character Legacy (the endwalker compatability version of this shader).
Number 1 seems to apply a "clear vinyl overlayer" effect
This is the Character Legacy shader. It is a port of the old endwalker shader for compatability with old assets that have not been updated by Square Enix. It is Not reccommended to continue creating anything for this shader, as it is not able to do all the things that the new Character shader can. Most Assets will still be using this shader unless updated by Square Enix or a modder. This shader is to our knowledge, not capable of handling some of the extra shader effects that the new Character shader can.
This is the Shader used for Body skin, Faces, and Hrothgar Skin with Fur.
- As a note, When both Skin influence and Hair influence are set, Skin influence wins out.
When working with this shader for body mods, Keep in mind that as of writing this, Body mods on the Female base (bibo, tf gen 3, etc) use skin type Body/standard skin. However, Male body mods (TBSE) Use the Hrothgar shader key for skin to allow for body hair that changes with head hair color. As such, authoring of maps for these two may differ slightly.
You can create a faux metallic effect on skin by confusing the Subsurface shader (though be careful). To do this, set the blue channel of the mask to a value close to 255. This creates an effect that is both metallic and subsurface at the same time. This method should only be done by Power users who know what they are doing. All other users should instead use the shader ID 10 method listed below for metal on skin.
While skin has an opacity mask, This can not be used to create a semitransparent body part, as the opacity has a "clamp" on it's values, effectively turning it from a scaled value into a yes/no. More research is needed to see if this can be changed.
As emissive is a shader key on the same level as hrothgar (body hair on skin) you cannot use both emissive and dyeable body hair on skin at the same time using vanilla shaders. this is non-negotiable.
- When Shader ID is set to 10 (default value is 1) this activates "proper" metal on skin, and changes the Mask blue from Subsurface/Fur parallax to Metalness. When authoring with this shader ID for metalness, all skin/non metal must be PURE BLACK in the blue channel (causing it to look yellow in RGB mode). The closer the value is to white, the more metalness it has. The Green roughness channel must also be given special consideration. values closer to black cause the metal to be more shiny/polished looking, but due to how 14 has implemented this, it will also pick up more color from the skybox/environment lighting, to the point where it will change the color of the metal entirely if the roughness value is too low. To avoid skybox discoloration but keep the metal looking shiny, it is reccommended to keep the value closer to a midtone grey. The skybox tinting effect with low roughness is more pronounced and visible on any metallic bits facing up towards the sky, so anything on the chest, or if the arms are bent at a 90 degree angle (such as folded at the chest).
This is the hair Shader. Many things have changed and unlike character, there is no legacy version of this shader. All old hair mods must be converted to use the channels described in this section. Hair is also used for Miqo'te tails.
At this time, the shader does not seem to be responsive to whatever value appearance plugins and tools such as Anamnesis, Glamourer, and Ktisis used to use for their "hair glow" parameter. This indicates something was shuffled around, but we are currently unsure as to what.
This is the iris, or new eye shader. There is no legacy version of this shader that can be used on players, so ALL eye mods must be thrown through a converter such as Loose Texture Compiler or Textools' Eye saver. This is non-negotiable.
The new iris shader allows for Sclera and Iris to be on the same map, allowing for some interesting effects
A large thing to note compared to old eye mods is that the catchlight is no longer an editable texture, and is now permanently part of the shader. All catchlight mods or edits can no longer be used. If you want to create a fake catchlight, you can draw this onto the diffuse, but it will be static and not move around. This is not fixable, and we do not currently know if catchlight will ever be editable, even using shader parameters.
Likewise, Au Ra limbal rings are also part of a shader now, and no longer part of a texture. Any mods that altered the Au Ra limbals must be scrapped. While shape cannot be changed, there is a shader constant that allows them to be turned on and off, and this is availible for all eyes, not just au ra. The parameters to change are
| 7DABA471- g_IrisRingEmissive |
0-1 (au ra at 0.8) |
||
| 58DE06E2-Limbal Color |
Red (0-1) |
Green (0-1) |
Blue (0-1) |
Furthermore, Sclera can either be changed by drawing on the diffuse, OR by changing shader constant 11C90091-g_ White Eyes Color. the 3 values are RGB going from 0-1 in each box.
Emissive is now included in the eye shader for ALL eyes, but in order to activate it, you need to mask out where you want glow on the mask RED channel, AND turn the shader constant 3BA64362-g_Emissive color on by changing the 3 values to not 0. the three editable boxes are RGB values that you may choose, that go from 0-1. emissive strangth is not known how or if it can be edited.
Finally, due to the eyeball now being a diffuse texture, it is possible to get multicolored eyes without having to sacrifice heterochromia. This both makes them more compatible with a variety of heads, and allows for more than 2 colors. because FF14 overlays the eye color closest to the layer style Multiply, it is best to check how colors will interact by simulating in an art program. You can either draw with color on the iris portion of the diffuse, and then allow eye color influence to change those colors, or draw with color on the diffuse, and then mask off the same areas/gradients on the Mask Blue channel, to stop those portions from changing with your eye color.
This is an example of simulating how placing colors on the diffuse and then allowing the game to put color on top can change the colors. This is a simulation in an art program, but it's enough to show what the effect will do when you do not mask out the colored parts on the multi.
There isn't much to edit about this shader, but it is important to keep in mind, as Facial ETC textures have multiple materials that all point to the same textures, but have different shader keys and parameters. Before changing any, please check this table, or make the texture path for the specific one you want to change unique.
As of 7.1 This shader is being adapted to player gear which allows us to research it more. This shader is nearly identical to the character (gear) shader, with a few exceptions. The main thing is that this shader utilizes UV channel 3 to copy and put skin underneath the "stockings" using only one mesh instead of the double layer mesh technique previously used. This is hardcoded to skin material A however, which means it will always be the symmetrical skin.
Texture wise, "opacity" on the normal map's blue channel is no longer overall opacity, but determines where and how much skin is shown "underneath".
Do NOT enable transparency in the material flags for this shader though, as it will crash your game.
The "nylon" texture and effect used on most gear with this shader is tile material 43, and you can get a nice stocking effect using a negative sheen value. Finally as of current research, sphere maps (like the holographic effect) seem to be disabled for this shader.
As of current research (12/03/2024) It seems that there is a strange link to material A used for this shader. When a modded skin mat A is loaded via textools into the game, the modded mat A shows correctly underneath the stockings, however when a modded skin mat A is loaded via penumbra, it does not. we are currently looking into why this is and how to cause the textools behavior on penumbra. The mod type (ttmp2 vs pmp) used does not change this behavior, nor can the penumbra behavior be circumvented via using textools' attach to penumbra system. for now a partial sort of fix is to have your modded skin in the default collection (this will mean everyone has your skin) in order for the stockings' mat A to properly reflect your skin. we don't know why this is the case, but it is likely due to how penumbra handles loading files vs textools. This has been tested on and works well on middie based ladies, but we could not get it to work on men. if you would like to test, please do and post a comment on this page of the results. (thank you to Virgo on discord for this research)
There isn't much to say about this shader.
According to recent testing, Passthrough visibility is conditional on dithering being active. That is, if the dithering key is not present (alongside the additional data bit value "00 80 00 00" being enabled), the passthrough effect will not do anything, even if the key is toggled on. To fully activate dithering, the shader key must be enabled, AND the bit value in the additional data section of the material editor must be enabled. (thank you arghblargh for this info)
This shader is still being researched. We have a general idea of how it works, but not enough for any automatic texture conversions to look good. If you have any observations or are willing to research it, please let us know.
This is a new shader introduced in 7.2, first seen on the Historia Chokers. It is assumed that it acts similarly to the standard character shader but uses a few additional shader keys for better transparency effects.
When these shaders are overlaid with certain other effects (like byakko's falling VFX) Character Glass will dither, but Character Transparency will hide completely. This could be a reason to use one shader over the other.
According to recent testing, Passthrough visibility is conditional on dithering being active. that is, if the dithering key is not present (alongside the additional data bit value "00 80 00 00" being enabled), the passthrough effect will not do anything, even if the key is toggled on. To fully activate dithering, the shader key must be enabled, AND the bit value in the additional data section of the material editor must be enabled. (thank you arghblargh for this info)
This shader is new and not properly researched. Any information here is tentative, and we would appreciate comments about this shader if you know more.
So far, we know that this shader does not seem to utilize vertex color for anything special, and seems to utilize a mask map for the special effects. (Thank you to Ulli for this information)
This shader has been in the game since 7.0, but was first used in 7.2. We do not have any information on this shader and will be updating this portion when more information is found.
This shader is not fully understood.
This shader is not fully understood.
Notes courtesy of Vincent on discord:
Keys:
9A696A17 - Velocity of the scroll. Positive values are left & up direction. Parameter 1 & 2 are Diffuse A's X & Y scroll respectively, and 3 & 4 are the same for Diffuse B.
Emissive, Diffuse, etc. - Affects these values on Diffuse A (the overlay layer.)
MultiEmissive, MultiDiffuse, etc. - Affects these values on Diffuse B (the base photo layer.)
BFE9D12D - A master emissive multiplier. Setting this to 0 turns off the lights on the whole thing.
The apparent 50% opacity on the Diffuse A overlay seems to be hard-coded. None of the other constants seemed to do anything at all.
Changing the alpha threshold parameter or alpha of the images had no effect.
This shader is used on the Phasmascapes.
We are assuming that this shader works the same as the non-dyeable furniture shader, with the addition of a second diffuse and scrolling parameters.
Additional Data Values Table
|
Additional Data bit Value |
Function |
Relevant Shader |
Bit Interactions |
Other Notes |
|
00 80 00 00 |
Enable Dithering |
Glass, Transparency |
Glass often has this enabled and shadows disabled. Assumed that this also affects transparency in character shader. |
|
|
00 40 00 00 |
Disable Shadows |
Global (?) Glass, Transparency, Character |
||
Attribute Reference Tables
This page is based off the "attribute reference table" in the textools reference doc by sel. This information has not been validated to have been changed in dawntrail, so while nothing on here should have changed, it is possible that some information is outdated or missing.
Mesh parts in FF14 have many types of Attributes, and these determine when and what parts of a mesh should be hidden.
Every Mesh part (X.0, X.1, etc) Has it's own list of attributes that will change what is and is not hidden when the correct metadata is combined with it. for example a mesh part with the upper arm attribute will be hidden if the item is paired with long gloves.
This is especially important when replacing the mesh parts of one model with another's, or when you are making/altering a mesh that needs to hide certain parts. If the mesh part numbers are different, then unwanted parts may hide when something is equipped. If you ever have a mod where something goes invisible when another gear piece is worn (usually long gloves) then that means that an attribute was incorrectly placed on a mesh part. likewise, if a part of the mesh does not hide when the corresponding piece is worn (like long gloves) then that means that mesh part does not have the attribute set.
Some gear uses special "Variant Attributes" such as atr_tv_a. these attributes are special as they are not decided by what other gear you have on, but rather are decided by what item variant you have equipped. What variants hide/show what items is determined by thier IMC values, which can be found in the metadata editing tabs of your chosen mod editor.
Variant attributes go from a to j (so atr_xv_b for example) with a total of 10 possible variant attributes per item, at the time of writing this.
Other variant attributes may exist for other model types, but most other model types do not have IMC files, so they will not be gone over here.
Unlisted model types have no unique attributes. Ex: Tail (til) and Ear (zir)
Shapes Reference Table
This page was adapted from the Textools Reference doc by Sel. This information has not been updated or re-researched since pre-dawntrail, so some information may be missing or outdated.
It is assumed that a shape can be created for any otherwise unlisted attribute and will be triggered if the attribute associated with it is hidden, however this has not yet been tested.
Visibility Reference Tables
This page is an adaptation of the Textools Reference document by Sel. This data has not been tested since the release of dawntrail, so some information may be missing/outdated.
|
Visibility Flag |
Controlling Slot |
Attribute |
Shape |
Notes |
|
|
Byte 0 |
EnableBodyFlags |
Body (top) |
-- |
-- |
Must be enabled for the rest of the body flags to work correctly. |
|
BodyHideWaist |
Body (top) |
atr_kod |
shp_kod, shp_kos(?) |
||
|
Bit2 |
Body (top) |
??? |
??? |
||
|
BodyHideShortGloves |
Body (top) |
atr_arm |
atr_arm |
Has something to do with glove settings based on the type of glove equipped. |
|
|
BodyGloveUnknown2 |
Body (top) |
??? |
??? |
||
|
BodyHideMidGloves |
Body (top) |
atr_arm |
shp_arm |
Ex. HideLongGloves will only hide atr_arm on long gloves. |
|
|
BodyHideLongGloves |
Body (top) |
atr_arm |
shp_arm |
But not on Mid Gloves. |
|
|
BodyHideGorget |
Body (top) |
atr_inr |
shp_inr |
||
|
Byte 1 |
BodyShowLeg |
Body (top) |
-- |
-- |
When body gear hides other slots, the visibility parameters from that slot in the same set as the body gear |
|
BodyShowHand |
Body (top) |
-- |
-- |
is used for determining down-stream visibility settings. (Ex. Should Shoes be shown/hidden) |
|
|
BodyShowHead |
Body (top) |
-- |
-- |
||
|
BodyShowNecklace |
Body (top) |
-- |
-- |
If either of equipped body or head gear hides necklace, it will be hidden. |
|
|
BodyShowBracelet |
Body (top) |
-- |
-- |
If either of equipped body or glove gear hides bracelet, it will be hidden. |
|
|
BodyShowTail |
Body (top) |
-- |
-- |
If either of equipped body or leg gear hides tail, it will be hidden. |
|
|
BodyTriggersomeShapeData |
Body (top) |
??? |
??? |
||
|
Bit15 |
Body (top) |
??? |
??? |
||
|
Byte 2 |
EnableLegFlags |
Leg (dwn) |
-- |
-- |
Must be enabled for the rest of the leg flags to work correctly. |
|
LegHideKneePads |
Leg (dwn) |
atr_lpd |
shp_lpd |
||
|
LegHideShortBoot |
Leg (dwn) |
atr_leg |
shp_leg |
Like gloves, the atr_leg triggers are dependent upon the equipped boot's visibility settings. (Long boots cannot be hidden) |
|
|
LegHideHalfBoot |
Leg (dwn) |
atr_leg |
shp_leg |
||
|
LegBootUnknown |
Leg (dwn) |
??? |
??? |
Something to do with interactions with half-boots. |
|
|
LegShowFoot |
Leg (dwn) |
-- |
-- |
||
|
LegShowTail |
Leg (dwn) |
??? |
??? |
If either of equipped body or leg gear hides tail, it will be hidden. |
|
|
Bit23 |
Leg (dwn) |
??? |
??? |
||
|
Byte 3 |
EnableHandFlags |
Gloves (glv) |
-- |
-- |
Must be enabled for the rest of the hand flags to work correctly. |
|
HandHideElbow |
Gloves (glv) |
atr_ude |
shp_ude, shp_hij, shp_kat |
When Elbow is set without forearm the glove is marked as a short glove (which will trigger shp_hij). Exact selection of which Shapes are triggered is based on the combination of flags. (Mid glove triggers ude, Long triggers kat) |
|
|
HandHideForearm |
Gloves (glv) |
atr_hij |
shp_ude, shp_hij, shp_kat |
||
|
Bit27 |
Gloves (glv) |
??? |
??? |
||
|
HandShowBracelet |
Gloves (glv) |
-- |
-- |
If either of equipped body or glove gear hides bracelet, it will be hidden. |
|
|
HandShowRingL |
Gloves (glv) |
-- |
-- |
||
|
HandShowRingR |
Gloves (glv) |
-- |
-- |
||
|
Bit31 |
Gloves (glv) |
??? |
??? |
||
|
Byte 4 |
EnableFootFlags |
Shoes (sho) |
-- |
-- |
Must be enabled for the rest of the foot flags to work correctly. |
|
FootHideKnee |
Shoes (sho) |
atr_hiz |
shp_hiz, shp_sne, shp_mom |
When Knee is set without Calf, item is marked as a short boot (Which will hide shp_sne). Exact shapes triggered depends on the combination of the flags. (mid boot triggers hiz, long triggers mom) |
|
|
FootHideCalf |
Shoes (sho) |
atr_sne |
shp_hiz, shp_sne, shp_mom |
||
|
FootHideAnkle |
Shoes (sho) |
??? |
??? |
||
|
Bit36 |
Shoes (sho) |
-- |
-- |
Unused |
|
|
Bit37 |
Shoes (sho) |
-- |
-- |
Unused |
|
|
Bit38 |
Shoes (sho) |
-- |
-- |
Unused |
|
|
Bit39 |
Shoes (sho) |
-- |
-- |
Unused |
|
|
Byte 5 |
EnableHeadFlags |
Head (met) |
-- |
-- |
Must be enabled for the rest of the head flags to work correctly. |
|
HeadHideScalp |
Head (met) |
atr_kam |
shp_kam |
When set alone, hides scalp. When set with HideHair, hides everything. |
|
|
HeadHideHair |
Head (met) |
-- |
-- |
When set alone, hides hair. When set with HideScalp, hides everything. |
|
|
HeadShowHairOverride |
Head (met) |
-- |
-- |
When set, shows hair, regardless of the previous two flags. |
|
|
HeadHideNeck |
Head (met) |
atr_nek |
shp_nek |
||
|
HeadShowNecklace |
Head (met) |
-- |
-- |
If either of equipped body or head gear hides necklace, it will be hidden. |
|
|
Bit46 |
Head (met) |
??? |
??? |
||
|
HeadShowEarrings |
Head (met) |
-- |
-- |
Full earring toggle cannot be disabled without also disabling hair (HeadHideHair) |
|
|
Byte 6 |
HeadShowEarringsHuman |
Head (met) |
-- |
-- |
Everything not Au Ra (?) |
|
HeadShowEarringsAura |
Head (met) |
-- |
-- |
Au Ra Only (?) |
|
|
HeadShowEarHuman |
Head (met) |
atr_mim |
atr_mim |
Hyur/Elezen/Lalafell |
|
|
HeadShowEarMiqo |
Head (met) |
atr_top |
shp_top |
Miqo/Hrothgar |
|
|
HeadShowEarAura |
Head (met) |
atr_hrn |
shp_hrn |
Au Ra (Horns) |
|
|
HeadShowEarViera |
Head (met) |
-- |
-- |
Viera |
|
|
HeadUnknownHelmet1 |
Head (met) |
??? |
??? |
These flags are usually set in place of ShowEarrings[Race] flags on helmet gear. |
|
|
HeadUnknownHelmet2 |
Head (met) |
??? |
??? |
Their purpose is currently unknown, but presumably triggers some shape data. |
|
|
Byte 7 |
HeadShowHrothgarHat |
Head (met) |
-- |
-- |
Allows Hrothgar hats to be shown |
|
HeadShowVieraHat |
Head (met) |
-- |
-- |
Allows Viera hats to be shown |
|
|
Bit58 |
Head (met) |
-- |
-- |
Unused |
|
|
Bit59 |
Head (met) |
-- |
-- |
Unused |
|
|
Bit60 |
Head (met) |
-- |
-- |
Unused |
|
|
Bit61 |
Head (met) |
-- |
-- |
Unused |
|
|
Bit62 |
Head (met) |
-- |
-- |
Unused |
|
|
Bit63 |
Head (met) |
-- |
-- |
Unused |
(Dawntrail) Colorset Values reference table
This page has been adapted from the same from the Textools Reference Doc made by Sel.
Dawntrail colorsets now use an Index Texture/ID map and use TWO channels to complete thier blending. Index red is similar to Endwalker Normal Alpha in that it is divided into 16 blocks; However it cannot be blended.
Instead for Dawntrail each block comes as a pair of rows that can be blended and this blend is controlled by the index Green channel. A pure white value will blend to A and a pure black value will blend to B
for both Red and Green values-
Here is a chart that can be colorpicked from with the corresponding values from the above chart.
Dye templates and Tile References
This page was made as an adaptation of the same in the Textools Reference doc created by sel. This has not been updated for dawntrail, so some information may be outdated or missing.
As of dawntrail, it is now possible to have two dye channels. In order to select and set between the two, you must go to the colorset editing window, and on the row you wish to be connected to the dye channel, select either Channel 1 or Channel 2. There are technically up to 4 channels in the data, but 3 and 4 are unused and cannot be manipulated in game.
There are currently 41 different dye templates in FF14. These templates control how dyes via the in game dye system or anamnesis/ktisis/brio/glamourer/etc affect a colorset row.
Other than selecting a template, you can also select which fields it should effect when dyed such as Diffuse color, Spec color, Emissive color, Gloss, and Spec power. Not all templates contain data for all of the above fields. Furthermore, emissive color can only be dyed using templates #510-522.
A general rule of thumb is as follows:
- (#)#00- dyes "default"
- (#)#01- dyes "darker"
- (#)#02- dyes "lighter"
- (#)#2#- dyes black (220, 420, 221, 421)
Dyed gloss values increase as you go up the 100s bracket from ~1 to ~24
Special templates other than black are:
- Silver- 540
- Gold-550
These templates (and black) will always dye the same color no matter what dye is used.
Tile materials
In addition to basic colors per row, a sub material known as a tile material may be used for microdetail such as linen or leather. ff14 has 64 possible tile materials defined, though only half actually work.
The tile material is a 32x32 px normal map and diffuse map which is mapped onto the UV1 layer of the material. the tile material is also repeated (tiled) a specified amount of times along each axis and can be further skewed to rotate or change the tiling as desired.
The grid version of the tiles and texture paths for them will be updated when found for dawntrail.
Racial Scaling tree (wip, outdated)
this does not include viera male or hrothgar female and must be remade. will update later, here's the old one.
Bone list and Bone Scaling notes.
this has been adapted from the textools reference doc page of the same title, created by sel. this has not been fully updated for dawntrail, and some information IS missing or outdated. I will correct when I can.
As a note. this list is based off the old bone list. Dawntrail completely redid the entire face skeletons, but there is not a complete list of them yet, so they will be added later. Do not use this list for facial bones. Furthermore this is a list of Vanilla bones. any extra bones added by a mod such as IVCS, YAS or Skelomae will not be in this list, and cannot be manipulated or used unless said mod is installed and set up properly.
Bones with <a-e> are multiple bones in sequence, such as sebo (spine) bones. Bones with <l/r> are left and right bones such as leg bones. bones with <f/b/s> are Front, Back, and Side bones, such as skirts. any bone with _ex in it's name is an Extra bone, and will only exist when the associated skeleton metadata is loaded. this is most commonly seen on hair, but has been used on gear on extremely rare occasions.
Main Bones
Dawntrail Face Bones
As a note, not every bone can be manipulated or scaled outside of gpose, (such as with Customize+ for normal gameplay). furthermore, many of the facial bones are kindedriver or "Helper" bones, and are either not meant to be touched on thier own, or are meant to provide small adjustments after moving the main bone. If you are not posing an old NPC head, you should only use the face bones listed here, and not the ones in the above chart.
An example of gpose only bones is eyeprm and irisprm bones. These bones will only ever work in gpose and in cutscenes, and trying to alter them in a non-gpose only setting such as customize+ will cause these bones to immediately revert when leaving gpose. Do not use these for scaling outside of screenshots. This is not fixable and is a game limitation. if you want to dialate or contract your pupils for out of gpose, you will need to look into eye mods
Bone scaling notes
Many in-game models share the same model, but scale the bones to fit the body shape they want. this is a list of known and confirmed scaling values that match up correctly with the in-game versions.
These are meant to be used with posing tools/plugins, with Customize+, or when testing your models in a modeling software to ensure that things don't clip at larger bust scalings.
At this time there is only bust scalings, but we will be happy to add other scalings as people find them. Keep in mind that not all gear pieces are weighted equally to the breast bones. many newer gear pieces are weighted to 50% breast influence instead of 100%. For these you may need to go up another percentage category to have the same effect as your racial starter gear or nude.
Bust sizes- Apply to Mune_l and _r
| Slider Percentage |
X |
Y |
Z |
| 0% |
0.92 |
0.816 |
0.80 |
| 50% |
1 |
1 |
1 |
| 100% |
1.08 |
1.184 |
1.20 |
| 150% |
1.16 |
1.368 |
1.40 |
| 200% |
1.24 |
1.552 |
1.60 |
| 250% |
1.32 |
1.736 |
1.80 |
| 300% |
1.40 |
1.92 |
2 |
As a note, these same values will work in a 3d modeling software like blender or 3ds max. for 3ds max, move the decimal point back 2 spaces.
Outdated tables (cross-reference only)
These are a few pages/tables that are included for cross referencing for the sake of older mods and setups, and should not be used when doing things post dawntrail. they are being saved for archival's sake, but I will not be formatting them in a pretty way, sorry. These are taken from the Textools Reference doc made by sel.
Endwalker shader tables-
|
Standard Gear Shader |
||||||
|
Normal Map |
Multi |
Vertex Color/Alpha |
UV2 |
|||
|
RED |
Standard Tangent Space Normal Map |
RED |
Ambient Occlusion |
RED |
Ambient Occlusion |
Decal Placement, such as Grand Company Logos |
|
GREEN |
Standard Tangent Space Normal Map |
GREEN |
Gloss |
GREEN |
Gloss |
|
|
BLUE |
Opacity [0-128, 128+ is full Opacity] |
BLUE |
Specular Power |
BLUE |
Specular Power |
Specular |
|
ALPHA |
Colorset Row |
ALPHA |
??? |
ALPHA |
Opacity |
Standard Full Color Specular Map |
|
Standard Gear Shader - Monster Preset |
||||||
|
Normal Map |
Multi |
Vertex Color/Alpha(UV3) |
UV2 |
|||
|
RED |
Standard Tangent Space Normal Map |
RED |
Specular Intensity |
RED |
??? |
Decal Placement, such as Grand Company Logos |
|
GREEN |
Standard Tangent Space Normal Map |
GREEN |
Gloss (?) |
GREEN |
??? |
|
|
BLUE |
Opacity [0-128, 128+ is full Opacity] |
BLUE |
??? |
BLUE |
??? |
Specular |
|
ALPHA |
Colorset Row |
ALPHA |
??? |
ALPHA |
??? |
Used as a Multi map (See Multi column) |
|
Glass Shader |
||||||
|
Normal Map |
Multi |
Vertex Color/Alpha(UV3) |
UV2 |
|||
|
RED |
Standard Tangent Space Normal Map |
RED |
Ambient Occlusion |
RED |
??? |
??? |
|
GREEN |
Standard Tangent Space Normal Map |
GREEN |
Gloss |
GREEN |
??? |
|
|
BLUE |
Opacity |
BLUE |
Specular Power |
BLUE |
Z Depth? |
N/A |
|
ALPHA |
Colorset Row |
ALPHA |
??? |
ALPHA |
??? |
|
|
Skin Shader |
||||||
|
Normal Map |
Multi |
Vertex Color/Alpha(UV3) |
UV2 |
|||
|
RED |
Standard Tangent Space Normal Map |
RED |
Player Skin Color Selection Influence |
RED |
Player Muscle Slider Influence |
Decal Placement, such as Legacy Mark or Face Paint. |
|
GREEN |
Standard Tangent Space Normal Map |
GREEN |
Specular Intensity |
GREEN |
??? |
|
|
BLUE |
??? |
BLUE |
Unused |
BLUE |
Angle of Refraction Intensity |
N/A |
|
ALPHA |
??? |
ALPHA |
??? |
ALPHA |
Player Skin Color Selection Influence |
|
|
Skin Shader - Face Presets |
||||||
|
Normal Map |
Multi |
Vertex Color/Alpha |
UV2 |
|||
|
RED |
Standard Tangent Space Normal Map |
RED |
Player Skin Color Selection Influence |
RED |
Player Muscle Slider Influence |
Decal Placement, such as Legacy Mark or Face Paint. |
|
GREEN |
Standard Tangent Space Normal Map |
GREEN |
Specular Intensity |
GREEN |
??? |
|
|
BLUE |
Opacity |
BLUE |
Player Lip Color Selection Influence |
BLUE |
Angle of Refraction Intensity |
N/A |
|
ALPHA |
??? |
ALPHA |
??? |
ALPHA |
Player Skin Color Selection Influence |
|
|
Skin Shader - Skin with Hair Preset |
||||||
|
Normal Map |
Multi |
Vertex Color/Alpha(UV3) |
UV2 |
|||
|
RED |
Standard Tangent Space Normal Map |
RED |
Player Skin Color Selection Influence |
RED |
??? |
Decal Placement, such as Legacy Mark or Face Paint. |
|
GREEN |
Standard Tangent Space Normal Map |
GREEN |
Player Hair Color Selection Influence |
GREEN |
??? |
|
|
BLUE |
??? |
BLUE |
Hair Highlight Color Selection Influence |
BLUE |
??? |
N/A |
|
ALPHA |
??? |
ALPHA |
??? |
ALPHA |
??? |
|
|
Hair Shader |
||||||
|
Normal Map |
Multi |
Vertex Color/Alpha(UV3) |
UV2 |
|||
|
RED |
Standard Tangent Space Normal Map |
RED |
Diffuse Mask |
RED |
Red Color Influence |
Opacity Mapping |
|
GREEN |
Standard Tangent Space Normal Map |
GREEN |
Specular Mask |
GREEN |
Green Color Influence |
|
|
BLUE |
??? |
BLUE |
Unused |
BLUE |
Blue Color Influence |
N/A |
|
ALPHA |
Opacity (see UV2) |
ALPHA |
Highlight Color Influence |
ALPHA |
Opacity |
|
|
Hair Shader - Face Presets |
||||||
|
Normal Map |
Multi |
Vertex Color/Alpha |
UV2 |
|||
|
RED |
Standard Tangent Space Normal Map |
RED |
Brightness |
RED |
Red Color Influence |
Opacity Map |
|
GREEN |
Standard Tangent Space Normal Map |
GREEN |
Specular Intensity |
GREEN |
Green Color Influence |
|
|
BLUE |
??? |
BLUE |
Unused |
BLUE |
Blue Color Influence |
N/A |
|
ALPHA |
Opacity |
ALPHA |
Player Tattoo/Etc* Color Influence |
ALPHA |
Opacity |
|
|
Iris Shader |
||||||
|
Normal Map |
Multi |
Vertex Color/Alpha(UV3) |
UV2 |
|||
|
RED |
Standard Tangent Space Normal Map |
RED |
Diffuse Mask |
RED |
Left Eye Color Influence |
??? |
|
GREEN |
Standard Tangent Space Normal Map |
GREEN |
Specular Mask |
GREEN |
Right Eye Color Influence |
|
|
BLUE |
??? |
BLUE |
Gloss(?) |
BLUE |
??? |
Reflection |
|
ALPHA |
??? |
ALPHA |
??? |
ALPHA |
??? |
Reflection Map ("Catchlight") |
|
Furniture Shader |
||||||
|
Normal Map |
Multi |
Vertex Color/Alpha(UV3) |
UV2 |
|||
|
RED |
Standard Tangent Space Normal Map |
RED |
Diffuse Mask |
RED |
??? |
Emissive Color Mapping (?) |
|
GREEN |
Standard Tangent Space Normal Map |
GREEN |
Specular Mask |
GREEN |
??? |
|
|
BLUE |
Unused |
BLUE |
Gloss |
BLUE |
??? |
Diffuse Note |
|
ALPHA |
Opacity |
ALPHA |
Emissive Mask |
ALPHA |
??? |
Diffuse Alpha is also used for Opacity |
|
Dyeable Furniture Shader |
||||||
|
Normal Map |
Multi |
Vertex Color/Alpha(UV3) |
UV2 |
|||
|
RED |
Standard Tangent Space Normal Map |
RED |
Specular Mask |
RED |
??? |
Emissive Color Mapping (?) |
|
GREEN |
Standard Tangent Space Normal Map |
GREEN |
Roughness |
GREEN |
??? |
|
|
BLUE |
Unused |
BLUE |
Also Specular Mask...? |
BLUE |
??? |
Diffuse Note |
|
ALPHA |
Opacity |
ALPHA |
Emissive Mask |
ALPHA |
??? |
Diffuse Alpha is used for Dyeability |
|
Further Notes |
|||||||
|
SE's Gloss implementation is very unique, and doesn't adhere particularly well to most modern PBR system's assumption of Gloss. (Closer to non-PBR Spec-Gloss) |
|||||||
|
In particular, their Gloss layers in the textures are really more like [Specular + Gloss]. To get a true Gloss-Only variance, your best bet is to blend Colorset Rows. |
|||||||