The skinned mesh of a character skin, and how each of its submeshes is shaded. Every character skin embeds one, so champions, map units and TFT companions all use it.
Material per submesh. The client picks a material for each submesh of the mesh. The first rule that matches wins:
| # | Condition | The submesh draws with |
|---|---|---|
| 1 | A materialOverride entry names the submesh and sets Material |
the entry's material |
| 2 | A materialOverride entry names the submesh and does not set Material |
LIT_UBER, built from the entry's textures |
| 3 | Material is set |
Material |
| 4 | None of the above | LIT_UBER, built from this object's textures |
LIT_UBER is the engine's built-in shader for skinned meshes
(SkinnedMesh/LIT_UBER_VS and LIT_UBER_PS). It is not a
StaticMaterialDef: it takes its textures from the texture
fields of this class, and which of them are set selects its shader variant. A submesh that
resolves to a material (rules 1 and 3) does not use LIT_UBER; the material's own samplers
shade it.
In shipped data about one skin in five sets Material, and about two in three override
entries set textures only.
Four extra constants for LIT_UBER. The client sets them on the LIT_UBER material of every
submesh that has no Material (rules 2 and 4):
| Field of the linked object | LIT_UBER constant | Value when unset |
|---|---|---|
0xed8edf74 |
albedoNewMin |
0.1 |
0xdba24ad6 |
albedoNewMax |
1 |
RimOffset |
rimOffset |
0.2 |
0xe9552339 |
modelHeight |
275 |
A materialOverride entry that sets its own 0x8881ee77 uses that object for its
submesh instead. When neither is set, the client uses the values in the last column.
Vec3 = [90, 0, 0] Direction of the mesh's rim light, as three rotation angles in degrees. The client rotates
the vector (0, 0, -1) by these angles and passes the result as the RIM_LIGHT_DIR shader
constant.
F32 = 0 Contrast of the mesh's rim light. The client passes it as the RIM_LIGHT_CONTRAST shader
constant.
Bool = true Turns the mesh's rim light on or off. The client passes it as the w component of the
RIM_LIGHT_COLOR shader constant: 1 when true, 0 when false.
String = "" A list of submesh names in the same format as initialSubmeshToHide. The client turns it
into a submesh set when it builds the mesh.
Bool = true When false, the client discards the triangle data of the mesh's collision object after
it builds it. A ray test against the triangles of this mesh then never hits. The per-bone
bounding spheres of the collision object are still built.
Bool = false A flag the mesh instance exposes to the renderer. The code that reads it is not yet identified.
String = "" A list of submesh names in the same format as initialSubmeshToHide. The client turns it
into a submesh set when the mesh instance is created.
The StaticMaterialDef for every submesh that no
materialOverride entry names (rule 3). When it is unset, those submeshes draw with
LIT_UBER and this object's textures.
Submeshes that draw a second time with an outline material. For each entry whose
category is set, the client finds the submeshes named in Submeshes (same list format
as initialSubmeshToHide). When those submeshes draw, the client draws them again with the
entry's materialOverride or, if that is unset, with the Material of the entry's
category.
Bool = false When true, each vertex keeps only its two largest bone weights instead of four. The two
weights are scaled so that they add up to 1, and the other two are set to zero. This is
done when the .skn is loaded.
Vec3 = [1, 1, 1] No documentation available yet. Click "Add documentation" to contribute!
File = "0x0" String File Packed roughness, metallic and ambient-occlusion map for LIT_UBER. Setting it selects the
metallic-roughness variant (FEATURE_ROUGHNESS_METALLIC) and changes the shading model
from SkinnedStandardShadingModel to
SkinnedPbrShadingModel. This texture is the only
thing that selects between the two for LIT_UBER.
The skin's sockets: named points on the skeleton that a lookup by bone name can find when no joint has that name.
F32 = 150 Height, in world units, of the bounding cylinder stored with boundingCylinderRadius.
F32 = 50 Radius, in world units, of the bounding cylinder the client stores on the mesh's collision
object, together with boundingCylinderHeight.
Option<F32> = null Radius, in world units, of a bounding sphere stored on the mesh's collision object. When it is unset, the stored radius marks the sphere as absent.
F32 = 0.25 Stored with the built mesh. The code that reads it is not yet identified.
Bool = true When false, the client skips the mesh in its skinned-mesh shadow pass, including the
draw with the SkinnedMesh/SHADOW_MAP shaders, so the unit casts no shadow.
File = "0x0" String File Passed to LIT_UBER together with the other textures. How the shader uses it is not yet identified.
F32 = 0 Strength of the fresnel term of LIT_UBER. The shader receives 0.1 + 4.9 * fresnel in the
w component of vFresnel and FRESNEL, with fresnelColor in x, y and z.
Color = [0, 0, 0, 255] Colour of the fresnel term of LIT_UBER. The red, green and blue channels go to the x,
y and z components of vFresnel and FRESNEL, from 0 to 1. The alpha channel is
not used.
File = "0x0" String File Gloss map for LIT_UBER's reflective variant (REFLECTIVE). On the high-quality path,
LIT_UBER binds this texture as its gloss map and reflectionMap as its reflection map. On
the other path neither is bound. Shipped values are gloss maps (_tx_gm.tex).
assets/characters/amumu/skins/skin16/amumu_skin16_tx_gm.texString = "" A list of submesh names in the same format as initialSubmeshToHide. The client turns it
into a submesh set when the mesh instance is created.
String = "" Submeshes that do not cast shadows, as a list in the same format as
initialSubmeshToHide. The client builds the unit's shadow submesh set from everything
not in this list.
String = "" Submeshes that are hidden when the mesh instance is created. The value is a list of
submesh names separated by spaces, commas, | or :, matched without case. A name that
matches no submesh is ignored.
RecallAn object that changes the materials of this mesh per unit. When it is set, the client gives the controller a copy of the submesh materials of each unit that uses the mesh when the mesh is set up, and again on updates when the controller asks for them.
Per-submesh exceptions to Material and to this object's textures. Each entry names one
submesh in submesh:
Material shades its submesh with that material (rule 1).Material shades its submesh with LIT_UBER, built from the entry's
own texture, glossTexture, RoughnessMetallicAoTexture and normalMapTexture
(rule 2).Entries come before the top-level Material, so a texture-only entry keeps its submesh on
LIT_UBER even when Material is set.
File = "0x0" String File Normal map for LIT_UBER. Setting it selects the shader's tangent-frame variant
(FEATURE_TANGENT).
Option<Vec3> = null Size of the mesh's bounding box on the x, y and z axes, in world units. When it is
unset, the client uses the size of the bounds in the .skn.
F32 = 1 Fresnel strength of LIT_UBER's reflective variant (REFLECTIVE). The shader receives
0.1 + 4.9 * reflectionFresnel in the x component of vReflection.
Color = [255, 255, 255, 255] Colour of the reflection fresnel of LIT_UBER's reflective variant. The red, green and blue
channels go to vReflectionFColor, from 0 to 1, with w set to 1. The alpha channel
is not used.
File = "0x0" String File Reflection map for LIT_UBER's reflective variant, bound together with glossTexture on
the high-quality path only. Shipped values are cube maps (_cubemap.dds).
assets/characters/blitzcrank/skins/base/blitzcrank_base_cubemap.ddsF32 = 0 Reflection opacity for LIT_UBER's reflective variant, passed in the y component of
vReflection. How the shader uses it was not checked.
F32 = 1 Reflection opacity for LIT_UBER's reflective variant, passed in the z component of
vReflection. How the shader uses it was not checked.
Rig pose modifiers for the skeleton: springs, dynamics chains and other changes to the pose after the animation. The client adds each entry to the mesh instance when it sets the instance up for a character skin.
F32 = 0 Self-illumination level of the mesh. When a submesh is drawn, the client writes this value
to the SELF_ILLUMINATION shader constant (as x, y and z). The client can replace it
at run time with an override value for the draw.
String = "" Path of the skinned mesh (.skn). The client builds the mesh from this file together with
skeleton. If the file does not load, the mesh is not built.
The built mesh, with its materials and submesh lists, is kept in a cache. For a character the cache key is this path plus the character name and skin number, compared without case, so every unit of the same character and skin shares one copy.
ASSETS/Characters/KhaZix/Skins/Skin11/Khazix_Skin11.sknString = "" Path of the skeleton (.skl) the mesh is skinned to. The client loads it when it builds
the mesh. If the skeleton does not load, the mesh is not built, and a character skin that
uses this object does not load.
ASSETS/Characters/KhaZix/Skins/Skin11/Khazix_Skin11.sklF32 = 1 Uniform scale factor for the mesh. The client sets it as the scale of the mesh instance on all three axes, and multiplies the size of the mesh's local bounding box by it.
String = "" Draw order of the submeshes, as a list of submesh names in the same format as
initialSubmeshToHide. The client first draws every submesh that is not in the list, in
the order of the .skn. Then it draws the listed submeshes, in the order of the list.
When it is unset, all submeshes draw in the order of the .skn.
File = "0x0" String File Base colour texture for LIT_UBER. Shipped values are the skin's colour maps
(_tx_cm.tex).
assets/characters/aatrox/skins/skin26/aatrox_skin26_tx_cm.texBool = false Selects the name the client uses for the unit's audio. When true, it uses the unit's
skin name. When false, it uses the character record's charAudioNameOverride if that is
set, and the character name if not.
Embed<SkinMeshDataProperties> Embed<SkinMeshDataProperties> Embed<SkinMeshDataProperties> Embed<SkinMeshDataProperties> Embed<SkinMeshDataProperties> Embed<SkinMeshDataProperties>