Documentation

2025-09-23T08:33:44Z

Platonic:

Assorted information about things from the games and how they work goes here!

== Models ==
* [[Ex Data]]
* [[Shaders]]
* [[Materials]]

== Stages ==

* [[Stage Effects]]

== Script ==
* [[DivaScript]]

Materials

2025-09-18T23:15:33Z

Platonic: /* Material Flags */

Materials hold data about how certain parts of a model should render. They hold the textures, color data, shader flags, and blend flags.

== Textures ==
=== Arcade Textures ===
Project DIVA games that follow Arcade's structure ([https://docs.divamodarchive.com/Games#:~:text=External%20Link*-,Hatsune%20Miku%3A%20Project%20DIVA%20Arcade,-June%2023%2C%202010 Arcade], [https://docs.divamodarchive.com/Games#:~:text=External%20Link*-,Hatsune%20Miku%3A%20Project%20DIVA%20Dreamy%20Theater,-June%2024%2C%202010 Dreamy Theater]/[https://docs.divamodarchive.com/Games#:~:text=Hatsune%20Miku%3A%20Project%20DIVA%20Dreamy%20Theater%202nd 2nd]/[https://docs.divamodarchive.com/Games#:~:text=Hatsune%20Miku%3A%20Project%20DIVA%20Dreamy%20Theater%20Extend Extend], [https://docs.divamodarchive.com/Games#:~:text=Hatsune%20Miku%3A%20Project%20DIVA%20Arcade%20Future%20Tone Arcade Future Tone], [https://docs.divamodarchive.com/Games#:~:text=Hatsune%20Miku%3A%20Project%20DIVA%20Future%20Tone Future Tone], [https://docs.divamodarchive.com/Games#:~:text=External%20Link-,Hatsune%20Miku%3A%20Project%20DIVA%20Mega%20Mix,-February%2013%2C%202020 Mega Mix]/[https://docs.divamodarchive.com/Games#:~:text=Hatsune%20Miku%3A%20Project%20DIVA%20Mega%20Mix%2B +]) support the following textures:
{| class="wikitable"
!Texture Type
!Use
!Example
!Flag
|-
|
====== Color ======
|The base color of the model (Also known as "Diffuse" or "Albedo" textures). The Alpha channel can be used for the transparency of the model. If second Color map is present, it is treated as a [[wikipedia:Lightmap|lightmap]].
|[insert]
|Color, ColorL1
|-
|
====== Normal ======
|[[wikipedia:Normal_mapping#:~:text=on%20the%20left.-,Calculation,-%5Bedit%5D|Normal Map]] for baked details
|[insert]
|Normal, NormalAlt
|-
|
====== Specular ======
|Controls the [[wikipedia:Specularity|Specular]] reflection color and intensity, with the Alpha channel controlling Environment intensity
|[insert]
|Specular
|-
|
====== Translucency ======
|Controls blending of the skin color in the [[Shaders#TIGHTS|TIGHTS]] shader. (Unused on the [[Shaders#HAIR|HAIR]] shader)
|[insert]
|Translucency
|-
|
====== Transparency ======
|Controls the transparency of the model
|[insert]
|Transparency
|-
|
====== EnvironmentCube ======
|[[wikipedia:Cube_mapping|Cubemap]] used for reflective surfaces
|[insert]
|Environment
|}
=== F Textures ===
Project DIVA games that follow F's structure ([https://docs.divamodarchive.com/Games#:~:text=External%20Link-,Hatsune%20Miku%3A%20Project%20DIVA%20F,-March%207%2C%202013 F], [https://docs.divamodarchive.com/Games#:~:text=Hatsune%20Miku%3A%20Project%20DIVA%20F%202nd F2nd], [https://docs.divamodarchive.com/Games#:~:text=Hatsune%20Miku%3A%20Project%20DIVA%20X X]) support the following textures:
{| class="wikitable"
!Texture Type
!Use
!Example
!Flag
|-
|Color
|The base color of the model (Also known as "Diffuse" or "Albedo" textures). The Alpha channel can be used for the transparency of the model.
If second Color map is present on the [[Shaders#BLINN|BLINN]] shader, it is treated as a [[wikipedia:Lightmap|lightmap]].
If the texture is RGB8 and has the 0x000500E0 Sampler flag, it is treated as a [https://panthavma.com/articles/shading/toonshading/ Toon Curve] texture.

(Note: the toon curve texture has 4 lines of data, the top line is unused, the 2nd line controls the [[wikipedia:Fresnel_equations|fresnel]], the 3rd line controls the [[wikipedia:Specularity|specular]], and the 4th line controls the diffuse)
|[insert]
|Color, ColorL1
|-
|Specular
|Controls the [[wikipedia:Specularity|Specular]] reflection color and intensity
|[insert]
|Specular
|-
|EnvironmentCube
|[[wikipedia:Cube_mapping|Cubemap]] used for reflective surfaces. Only supported on the [[Shaders#BLINN|BLINN]] shader
|[insert]
|Environment
|}
=== X (Ps4) Textures ===
Project DIVA X on the Playstation 4 features [https://miku.sega.com/divax/game.html#:~:text=The%20PlayStation%C2%AE4%20version%20has%20enhanced%20graphics%20and%20full%20HD%20resolution! upgraded graphics], and has support for different textures as such:
{| class="wikitable"
!Texture Type
!Use
!Example
!Flag
|-
|Color
|The base color of the model (Also known as "Diffuse" or "Albedo" textures). The Alpha channel can be used for the transparency of the model.
|[insert]
|Color, ColorL1
|-
|Normal
|[[wikipedia:Normal_mapping#:~:text=on%20the%20left.-,Calculation,-%5Bedit%5D|Normal Map]] for baked details. The alpha channel controls the [[wikipedia:Ambient_occlusion|Ambient Occlusion]] of the model.
|[insert]
|Normal, NormalAlt
|-
|Specular
|Material texture, where:
The Red channel is [[wikipedia:Reflection_(computer_graphics)#:~:text=metallic%20object%20itself.-,Blurry%20reflection,-%5Bedit%5D|roughness]],

The Green channel is [[wikipedia:Fresnel_equations|fresnel reflectance]] (and the material is treated as metal if the value is over 0.999),

The Blue channel controls where [[wikipedia:Self-shadowing|Self-Shadowing]] should take place,

The Alpha channel controls the brightness of the [[wikipedia:Fresnel_equations|fresnel]] effect of the model.
|[insert]
|Specular
|-
|Height
|Controls the [[wikipedia:Emissivity|emmision]] of the model, with the Alpha channel acting as a Specular map
|[insert]
|
|-
|Translucency
|[https://panthavma.com/articles/shading/toonshading/ Toon Curve] texture, with 4 lines of data:
The top line is unused,
The 2nd line controls the [[wikipedia:Fresnel_equations|fresnel]] ramp

The 3rd line controls the [[wikipedia:Specularity|specular]] ramp
The 4th line controls the diffuse ramp
|[insert]
|
|-
|Transparency
|[[wikipedia:Cube_mapping|Cubemap]] used for reflective surfaces
|[insert]
|Environment
|-
|(not indexed)
|[[wikipedia:Lightmap|Lightmap]] for baked lighting (Used in the '''OBJM_H''' shader)
|[insert]
|
|}
<nowiki>*</nowiki>Material texture use from Skyth

== Blend Flags ==
Blend flags are material settings that specifically affect how a model is drawn.
{| class="wikitable"
!Flag
!Input
!Use
|-
|Alpha texture
|'''True''', '''False'''
|Enables the transparency of a model to be driven by the Alpha channel of the color or transparency texture.
|-
|Alpha material
|'''True''', '''False'''
|Enables the transparency of a model to be driven by the Alpha value of the material.
|-
|Punch through
|'''True''', '''False'''
|Discards alpha values below 0.5, resulting in sharper transparency
|-
|Double sided
|'''True''', '''False'''
|Disables [[wikipedia:Back-face_culling|Backface Culling]] when true
|-
|Normal direction light
|'''True''', '''False'''
|Unused(?)
|-
|Source blend factor
|'''String'''
|Used to determine blending behaviour
|-
|Destination blend factor
|'''String'''
|Used to determine blending behaviour
|-
|Blend Operation
|'''Value'''
|Unused(?)
|-
|Z bias
|'''0-15'''
|Unused
|-
|Ignore fog
|'''True''', '''False'''
|Material will not be affected by fog if true
|}

== General ==
The main material settings, controlling how the model looks overall
{| class="wikitable"
!Flag
!Input
!Use
|-
|Flags
|'''String'''
|See [https://docs.divamodarchive.com/Materials#:~:text=fog%20if%20true-,Material%20Flags Material Flags]
|-
|Shader name
|'''String'''
|See [[Shaders]]
|-
|Shader Flags
|'''Hex'''
|Combination of shader flags (handled by MMM)
|-
|Blend Flags
|'''Hex'''
|Combination of blend flags (handled by MMM)
|-
|Diffuse
|'''RGBA'''
|Controls the diffuse color of material, alpha controls transparency
|-
|Ambient
|'''RGBA'''
|Controls edge color of Anisotropic [[Shaders#CLOTH|CLOTH]], and alpha controls edge intensity of [[Shaders#TIGHTS|TIGHTS]], subsurface scattering of [[Shaders#CLOTH|CLOTH]]
|-
|Specular
|'''RGBA'''
|Controls the color of specular reflection, alpha controls environment intensity
|-
|Emmision
|'''RGBA'''
|Controls emmision color, alpha controls shadow intensity
|-
|Shininess
|'''0-128'''
|Controls focus of specular reflection
|-
|Intensity
|'''0-100'''
|Unused(?)
|-
|Bump Depth
|'''0-1'''
|Controls normal map strength
|}
<nowiki>*</nowiki>Material research by Samyuu. Skyth, korenkonder, Platonic

=== Material Flags ===
{| class="wikitable"
|+
!Flag
!Use
|-
|Color
|Enables [https://docs.divamodarchive.com/Materials#:~:text=The%20base%20color%20of%20the%20model%20(Also%20known%20as%20%22Diffuse%22%20or%20%22Albedo%22%20textures).%20The%20Alpha%20channel%20can%20be%20used%20for%20the%20transparency%20of%20the%20model.%20If%20second%20Color%20map%20is%20present%2C%20it%20is%20treated%20as%20a%20lightmap. color map] for material
|-
|Color Alpha
|Enables alpha from [https://docs.divamodarchive.com/Materials#:~:text=The%20base%20color%20of%20the%20model%20(Also%20known%20as%20%22Diffuse%22%20or%20%22Albedo%22%20textures).%20The%20Alpha%20channel%20can%20be%20used%20for%20the%20transparency%20of%20the%20model.%20If%20second%20Color%20map%20is%20present%2C%20it%20is%20treated%20as%20a%20lightmap. color map]
|-
|ColorL1
|Enables second color map to act as a [[wikipedia:Lightmap|lightmap]]
|-
|ColorL1Alpha
|Unused(?)
|-
|ColorL2
|Unused(?)
|-
|ColorL2Alpha
|Unused(?)
|-
|Transparency
|Enables transparency from [https://docs.divamodarchive.com/Materials#:~:text=Controls%20the%20transparency%20of%20the%20model transparency map]
|-
|Specular
|Enables [https://docs.divamodarchive.com/Materials#:~:text=Controls%20the%20Specular%20reflection%20color%20and%20intensity%2C%20with%20the%20Alpha%20channel%20controlling%20Environment%20intensity specular map]
|-
|Normal
|Enables [https://docs.divamodarchive.com/Materials#:~:text=Normal-,Normal%20Map%20for%20baked%20details,-%5Binsert%5D normal map]
|-
|NormalAlt
|Unused(?)
|-
|Environment
|Enables [https://docs.divamodarchive.com/Materials#:~:text=Transparency-,EnvironmentCube,Cubemap%20used%20for%20reflective%20surfaces,-%5Binsert%5D environment map]
|-
|ColorL3
|Unused(?)
|-
|ColorL3Alpha
|Unused(?)
|-
|Translucency
|Enables [https://docs.divamodarchive.com/Materials#:~:text=Translucency-,Transparency,Controls%20the%20transparency%20of%20the%20model,-%5Binsert%5D translucency map]
|-
|Flag14
|Unused(?)
|-
|OverrideIBL
|Enables or disables environment
|}

Materials

2025-09-18T22:56:25Z

Platonic:

Materials hold data about how certain parts of a model should render. They hold the textures, color data, shader flags, and blend flags.

== Textures ==
=== Arcade Textures ===
Project DIVA games that follow Arcade's structure ([https://docs.divamodarchive.com/Games#:~:text=External%20Link*-,Hatsune%20Miku%3A%20Project%20DIVA%20Arcade,-June%2023%2C%202010 Arcade], [https://docs.divamodarchive.com/Games#:~:text=External%20Link*-,Hatsune%20Miku%3A%20Project%20DIVA%20Dreamy%20Theater,-June%2024%2C%202010 Dreamy Theater]/[https://docs.divamodarchive.com/Games#:~:text=Hatsune%20Miku%3A%20Project%20DIVA%20Dreamy%20Theater%202nd 2nd]/[https://docs.divamodarchive.com/Games#:~:text=Hatsune%20Miku%3A%20Project%20DIVA%20Dreamy%20Theater%20Extend Extend], [https://docs.divamodarchive.com/Games#:~:text=Hatsune%20Miku%3A%20Project%20DIVA%20Arcade%20Future%20Tone Arcade Future Tone], [https://docs.divamodarchive.com/Games#:~:text=Hatsune%20Miku%3A%20Project%20DIVA%20Future%20Tone Future Tone], [https://docs.divamodarchive.com/Games#:~:text=External%20Link-,Hatsune%20Miku%3A%20Project%20DIVA%20Mega%20Mix,-February%2013%2C%202020 Mega Mix]/[https://docs.divamodarchive.com/Games#:~:text=Hatsune%20Miku%3A%20Project%20DIVA%20Mega%20Mix%2B +]) support the following textures:
{| class="wikitable"
!Texture Type
!Use
!Example
!Flag
|-
|
====== Color ======
|The base color of the model (Also known as "Diffuse" or "Albedo" textures). The Alpha channel can be used for the transparency of the model. If second Color map is present, it is treated as a [[wikipedia:Lightmap|lightmap]].
|[insert]
|Color, ColorL1
|-
|
====== Normal ======
|[[wikipedia:Normal_mapping#:~:text=on%20the%20left.-,Calculation,-%5Bedit%5D|Normal Map]] for baked details
|[insert]
|Normal, NormalAlt
|-
|
====== Specular ======
|Controls the [[wikipedia:Specularity|Specular]] reflection color and intensity, with the Alpha channel controlling Environment intensity
|[insert]
|Specular
|-
|
====== Translucency ======
|Controls blending of the skin color in the [[Shaders#TIGHTS|TIGHTS]] shader. (Unused on the [[Shaders#HAIR|HAIR]] shader)
|[insert]
|Translucency
|-
|
====== Transparency ======
|Controls the transparency of the model
|[insert]
|Transparency
|-
|
====== EnvironmentCube ======
|[[wikipedia:Cube_mapping|Cubemap]] used for reflective surfaces
|[insert]
|Environment
|}
=== F Textures ===
Project DIVA games that follow F's structure ([https://docs.divamodarchive.com/Games#:~:text=External%20Link-,Hatsune%20Miku%3A%20Project%20DIVA%20F,-March%207%2C%202013 F], [https://docs.divamodarchive.com/Games#:~:text=Hatsune%20Miku%3A%20Project%20DIVA%20F%202nd F2nd], [https://docs.divamodarchive.com/Games#:~:text=Hatsune%20Miku%3A%20Project%20DIVA%20X X]) support the following textures:
{| class="wikitable"
!Texture Type
!Use
!Example
!Flag
|-
|Color
|The base color of the model (Also known as "Diffuse" or "Albedo" textures). The Alpha channel can be used for the transparency of the model.
If second Color map is present on the [[Shaders#BLINN|BLINN]] shader, it is treated as a [[wikipedia:Lightmap|lightmap]].
If the texture is RGB8 and has the 0x000500E0 Sampler flag, it is treated as a [https://panthavma.com/articles/shading/toonshading/ Toon Curve] texture.

(Note: the toon curve texture has 4 lines of data, the top line is unused, the 2nd line controls the [[wikipedia:Fresnel_equations|fresnel]], the 3rd line controls the [[wikipedia:Specularity|specular]], and the 4th line controls the diffuse)
|[insert]
|Color, ColorL1
|-
|Specular
|Controls the [[wikipedia:Specularity|Specular]] reflection color and intensity
|[insert]
|Specular
|-
|EnvironmentCube
|[[wikipedia:Cube_mapping|Cubemap]] used for reflective surfaces. Only supported on the [[Shaders#BLINN|BLINN]] shader
|[insert]
|Environment
|}
=== X (Ps4) Textures ===
Project DIVA X on the Playstation 4 features [https://miku.sega.com/divax/game.html#:~:text=The%20PlayStation%C2%AE4%20version%20has%20enhanced%20graphics%20and%20full%20HD%20resolution! upgraded graphics], and has support for different textures as such:
{| class="wikitable"
!Texture Type
!Use
!Example
!Flag
|-
|Color
|The base color of the model (Also known as "Diffuse" or "Albedo" textures). The Alpha channel can be used for the transparency of the model.
|[insert]
|Color, ColorL1
|-
|Normal
|[[wikipedia:Normal_mapping#:~:text=on%20the%20left.-,Calculation,-%5Bedit%5D|Normal Map]] for baked details. The alpha channel controls the [[wikipedia:Ambient_occlusion|Ambient Occlusion]] of the model.
|[insert]
|Normal, NormalAlt
|-
|Specular
|Material texture, where:
The Red channel is [[wikipedia:Reflection_(computer_graphics)#:~:text=metallic%20object%20itself.-,Blurry%20reflection,-%5Bedit%5D|roughness]],

The Green channel is [[wikipedia:Fresnel_equations|fresnel reflectance]] (and the material is treated as metal if the value is over 0.999),

The Blue channel controls where [[wikipedia:Self-shadowing|Self-Shadowing]] should take place,

The Alpha channel controls the brightness of the [[wikipedia:Fresnel_equations|fresnel]] effect of the model.
|[insert]
|Specular
|-
|Height
|Controls the [[wikipedia:Emissivity|emmision]] of the model, with the Alpha channel acting as a Specular map
|[insert]
|
|-
|Translucency
|[https://panthavma.com/articles/shading/toonshading/ Toon Curve] texture, with 4 lines of data:
The top line is unused,
The 2nd line controls the [[wikipedia:Fresnel_equations|fresnel]] ramp

The 3rd line controls the [[wikipedia:Specularity|specular]] ramp
The 4th line controls the diffuse ramp
|[insert]
|
|-
|Transparency
|[[wikipedia:Cube_mapping|Cubemap]] used for reflective surfaces
|[insert]
|Environment
|-
|(not indexed)
|[[wikipedia:Lightmap|Lightmap]] for baked lighting (Used in the '''OBJM_H''' shader)
|[insert]
|
|}
<nowiki>*</nowiki>Material texture use from Skyth

== Blend Flags ==
Blend flags are material settings that specifically affect how a model is drawn.
{| class="wikitable"
!Flag
!Input
!Use
|-
|Alpha texture
|'''True''', '''False'''
|Enables the transparency of a model to be driven by the Alpha channel of the color or transparency texture.
|-
|Alpha material
|'''True''', '''False'''
|Enables the transparency of a model to be driven by the Alpha value of the material.
|-
|Punch through
|'''True''', '''False'''
|Discards alpha values below 0.5, resulting in sharper transparency
|-
|Double sided
|'''True''', '''False'''
|Disables [[wikipedia:Back-face_culling|Backface Culling]] when true
|-
|Normal direction light
|'''True''', '''False'''
|Unused(?)
|-
|Source blend factor
|'''String'''
|Used to determine blending behaviour
|-
|Destination blend factor
|'''String'''
|Used to determine blending behaviour
|-
|Blend Operation
|'''Value'''
|Unused(?)
|-
|Z bias
|'''0-15'''
|Unused
|-
|Ignore fog
|'''True''', '''False'''
|Material will not be affected by fog if true
|}

== General ==
The main material settings, controlling how the model looks overall
{| class="wikitable"
!Flag
!Input
!Use
|-
|Flags
|'''String'''
|See Material Flags
|-
|Alpha material
|'''True''', '''False'''
|Enables the transparency of a model to be driven by the Alpha value of the material.
|-
|Punch through
|'''True''', '''False'''
|Discards alpha values below 0.5, resulting in sharper transparency
|-
|Double sided
|'''True''', '''False'''
|Disables [[wikipedia:Back-face_culling|Backface Culling]] when true
|-
|Normal direction light
|'''True''', '''False'''
|Unused(?)
|-
|Source blend factor
|'''String'''
|Used to determine blending behaviour
|-
|Destination blend factor
|'''String'''
|Used to determine blending behaviour
|-
|Blend Operation
|'''Value'''
|Unused(?)
|-
|Z bias
|'''0-15'''
|Unused
|-
|Ignore fog
|'''True''', '''False'''
|Material will not be affected by fog if true
|}

=== Material Flags ===
{| class="wikitable"
|+
!Flag
!Use
|-
|Color
|Enables [https://docs.divamodarchive.com/Materials#:~:text=The%20base%20color%20of%20the%20model%20(Also%20known%20as%20%22Diffuse%22%20or%20%22Albedo%22%20textures).%20The%20Alpha%20channel%20can%20be%20used%20for%20the%20transparency%20of%20the%20model.%20If%20second%20Color%20map%20is%20present%2C%20it%20is%20treated%20as%20a%20lightmap. color map] for material
|-
|Color Alpha
|Enables alpha from [https://docs.divamodarchive.com/Materials#:~:text=The%20base%20color%20of%20the%20model%20(Also%20known%20as%20%22Diffuse%22%20or%20%22Albedo%22%20textures).%20The%20Alpha%20channel%20can%20be%20used%20for%20the%20transparency%20of%20the%20model.%20If%20second%20Color%20map%20is%20present%2C%20it%20is%20treated%20as%20a%20lightmap. color map]
|-
|ColorL1
|Enables second color map to act as a [[wikipedia:Lightmap|lightmap]]
|-
|ColorL1Alpha
|Unused(?)
|-
|ColorL2
|Unused(?)
|-
|ColorL2Alpha
|Unused(?)
|-
|Transparency
|Enables transparency from [https://docs.divamodarchive.com/Materials#:~:text=Controls%20the%20transparency%20of%20the%20model transparency map]
|-
|Specular
|Enables [https://docs.divamodarchive.com/Materials#:~:text=Controls%20the%20Specular%20reflection%20color%20and%20intensity%2C%20with%20the%20Alpha%20channel%20controlling%20Environment%20intensity specular map]
|-
|Normal
|Enables [https://docs.divamodarchive.com/Materials#:~:text=Normal-,Normal%20Map%20for%20baked%20details,-%5Binsert%5D normal map]
|-
|NormalAlt
|Unused(?)
|-
|Environment
|Enables [https://docs.divamodarchive.com/Materials#:~:text=Transparency-,EnvironmentCube,Cubemap%20used%20for%20reflective%20surfaces,-%5Binsert%5D environment map]
|-
|ColorL3
|Unused(?)
|-
|ColorL3Alpha
|Unused(?)
|-
|Translucency
|Enables [https://docs.divamodarchive.com/Materials#:~:text=Translucency-,Transparency,Controls%20the%20transparency%20of%20the%20model,-%5Binsert%5D translucency map]
|-
|Flag14
|Unused(?)
|-
|OverrideIBL
|Enables or disables environment
|}

2025-09-17T04:17:08Z

Platonic: /* Expression Blocks (EXP) */

== Overview ==
Ex Data exists in Project DIVA to add bones that aren't present in the original DIVA skeleton, allow expression-driven animation, and to add physics to bone strands. It can be edited in [[MikuMikuModel]], and are usually referred to as "blocks." Most of the Ex Data system was seemingly based on [[wikipedia:Autodesk_Softimage|AutoDesk's SoftImage]]

== Expression Blocks (EXP) ==
Expression Blocks are the main way to add non-standard bones to a model, and provide a way to add simple animations and math-driven animation.
{| class="wikitable"
|+Expression Block
!'''Expressions'''
|(Collection)
|Collection of expression strings (see below)
|-
!'''Name'''
|[Name of Block]
|Name of the expression block internally
|-
!'''ParentName'''
|[Name of Parent]
|Name of the parent
|-
!'''Position'''
|[Position in [https://help.autodesk.com/view/MAYAUL/2024/ENU/?guid=GUID-A63AC5C8-8822-42AC-827E-164B5266DA03#:~:text=Local%20space%20is%20similar%20to%20object%20space%2C%20however%20it%20uses%20the%20origin%20and%20axes%20of%20the%20object%E2%80%99s%20parent%20node%20in%20the%20hierarchy%20of%20objects.%20This%20is%20useful%20when%20you%20haven%E2%80%99t%20transformed%20the%20object%20itself%2C%20but%20it%20is%20part%20of%20a%20group%20that%20is%20transformed. Local Space]]
|[X,Y,Z]
|-
!'''Rotation'''
|[Rotation in [[wikipedia:Radian|Radians]] and [https://help.autodesk.com/view/MAYAUL/2024/ENU/?guid=GUID-A63AC5C8-8822-42AC-827E-164B5266DA03#:~:text=Local%20space%20is%20similar%20to%20object%20space%2C%20however%20it%20uses%20the%20origin%20and%20axes%20of%20the%20object%E2%80%99s%20parent%20node%20in%20the%20hierarchy%20of%20objects.%20This%20is%20useful%20when%20you%20haven%E2%80%99t%20transformed%20the%20object%20itself%2C%20but%20it%20is%20part%20of%20a%20group%20that%20is%20transformed. Local Space]]
|[X,Y,Z]
|-
!'''Scale'''
|[Scale of Block]
|[X,Y,Z]
|-
!'''Signature'''
|EXP
|(Not Editable)
|}
Expressions themselves are formatted as such:
= [Component] [Instruction]
Here is the full list of [[Expression Components and Instructions|Components and Instructions]]

== Osage Blocks (OSG) ==
Osage Blocks are how Project DIVA determines what bones should receive real-time physics. It is important to note that an Osage Block generally applies to a whole chain of bones, instead of individual bones. The Osage block itself holds;
{| class="wikitable"
|+Osage Block
!'''ExternalName'''
|[Name of Osage]
|Name of the Osage block externally
|-
!'''Name'''
|[Name of Block]
|Name of the Osage block internally
|-
!'''Nodes'''
|(Collection)
|Collection of bones (nodes) for the Osage strand
|-
!'''ParentName'''
|[Name of Parent]
|Name of the parent
|-
!'''Position'''
|[Position in [https://help.autodesk.com/view/MAYAUL/2024/ENU/?guid=GUID-A63AC5C8-8822-42AC-827E-164B5266DA03#:~:text=Local%20space%20is%20similar%20to%20object%20space%2C%20however%20it%20uses%20the%20origin%20and%20axes%20of%20the%20object%E2%80%99s%20parent%20node%20in%20the%20hierarchy%20of%20objects.%20This%20is%20useful%20when%20you%20haven%E2%80%99t%20transformed%20the%20object%20itself%2C%20but%20it%20is%20part%20of%20a%20group%20that%20is%20transformed. Local Space]]
|[X,Y,Z]
|-
!'''Rotation'''
|[Rotation in [[wikipedia:Radian|Radians]] and [https://help.autodesk.com/view/MAYAUL/2024/ENU/?guid=GUID-A63AC5C8-8822-42AC-827E-164B5266DA03#:~:text=Local%20space%20is%20similar%20to%20object%20space%2C%20however%20it%20uses%20the%20origin%20and%20axes%20of%20the%20object%E2%80%99s%20parent%20node%20in%20the%20hierarchy%20of%20objects.%20This%20is%20useful%20when%20you%20haven%E2%80%99t%20transformed%20the%20object%20itself%2C%20but%20it%20is%20part%20of%20a%20group%20that%20is%20transformed. Local Space]]
|[X,Y,Z]
|-
!'''Scale'''
|[Scale of Block]
|[X,Y,Z]
|-
!'''Signature'''
|OSG
|(Not Editable)
|}
Note: '''ExternalName''' is what is used in the [[Skin Param]] to set settings for the Osage strand, not '''Name.'''

=== Osage Nodes ===
An Osage block holds a collection of nodes, the bones that belong to the Osage block. The collection of nodes is as such:
{| class="wikitable"
|+Osage Node
!'''Length'''
|[Length of Node]
|Actual length of the bone
|-
!'''Name'''
|[Name of Node]
|Name of the bone
|-
!'''Rotation'''
|[Rotation in [[wikipedia:Radian|Radians]] and [https://help.autodesk.com/view/MAYAUL/2024/ENU/?guid=GUID-A63AC5C8-8822-42AC-827E-164B5266DA03#:~:text=Local%20space%20is%20similar%20to%20object%20space%2C%20however%20it%20uses%20the%20origin%20and%20axes%20of%20the%20object%E2%80%99s%20parent%20node%20in%20the%20hierarchy%20of%20objects.%20This%20is%20useful%20when%20you%20haven%E2%80%99t%20transformed%20the%20object%20itself%2C%20but%20it%20is%20part%20of%20a%20group%20that%20is%20transformed. Local Space]
|[X,Y,Z]
|-
!'''SiblingMaxDistance'''
|[Distance from Sibling]
|Distance the node can travel from the Sibling
|-
!'''SiblingName'''
|[Name of Sibling]
|Name of the Sibling node
|}
Note: An Osage block can hold multiple Osage Nodes

== Constraint Blocks (CNS) ==
Constraint blocks are the best way to copy the direction or orientation of another bone without using expressions, and are best used on bones that need to maintain an offset while being affected by another bone. A great example of this system is [https://gamebanana.com/mods/385283 Skyth's Sonic Modules], being able to copy the DIVA skeleton while keeping the original model's armature intact.

=== Direction Constraint Block ===
This is the main way to point a bone towards another bone.
{| class="wikitable mw-collapsible"
|+Direction Constraint Block
!Coupling
|[Rigid or Soft]
|[https://download.autodesk.com/global/docs/softimage2014/en_us/userguide/index.html?url=files/constraints_OverviewofWorkingwithConstraints.htm,topicNumber=d30e162219 Coupling method]
|-
!'''Data'''
|MikuMikuLibrary.Objects.Extra.Blocks.PositionConstraintData
|[https://download.autodesk.com/global/docs/softimage2014/en_us/userguide/index.html?url=files/constraints_OverviewofWorkingwithConstraints.htm,topicNumber=d30e162219 Direction Constraint]
|-
!ConstrainedObject
|MikuMikuLibrary.Objects.Extra.Blocks.AttachPointData
|Always AttachPointData(?)
|-
!'''AffectedByOrientation'''
|[True or False]
|Constrained bone uses orientation if true
|-
!'''AffectedByScaling'''
|[True or False]
|Constrained bone uses scale if true
|-
!Offset
|[X, Y, Z]
|Offset of constrained bone
|-
!'''ConstrainingObject'''
|MikuMikuLibrary.Objects.Extra.Blocks.AttachPointData
|Always AttachPointData(?)
|-
!'''AffectedByOrientation'''
|[True or False]
|Constraining bone uses orientation if true
|-
!'''AffectedByScaling'''
|[True or False]
|Constraining bone uses scale if true
|-
!Offset
|[X, Y, Z]
|Offset of constraining bone
|-
!Type
|Position
|Not Editable
|-
!UpVector
|MikuMikuLibrary.Objects.Extra.Blocks.UpVectorData
|Always UpVectorData(?)
|-
!Active
|[True or False]
|Constrained bone uses Up Vector if true
|-
!AffectedAxis
|[X, Y, Z]
|Determines which axis is used as the [https://download.autodesk.com/global/docs/softimage2014/en_us/userguide/index.html?url=files/constraints_OverviewofWorkingwithConstraints.htm,topicNumber=d30e162219 Up Vector]
|-
!Name
|[Name]
|
Editors' Note: I can't find this used anywhere
|-
!PointAt
|[X, Y, Z]
|Where the [https://download.autodesk.com/global/docs/softimage2014/en_us/userguide/index.html?url=files/constraints_OverviewofWorkingwithConstraints.htm,topicNumber=d30e162219 Up Vector] should point
|-
!Roll
|[Value]
|Roll of the [https://download.autodesk.com/global/docs/softimage2014/en_us/userguide/index.html?url=files/constraints_OverviewofWorkingwithConstraints.htm,topicNumber=d30e162219 Up Vector](?)
|-
!Name
|[Name of Block]
|Name of Constraint Block
|-
!ParentName
|[Name of Parent]
|Name of Parent
|-
!Position
|[Position in [https://help.autodesk.com/view/MAYAUL/2024/ENU/?guid=GUID-A63AC5C8-8822-42AC-827E-164B5266DA03#:~:text=Local%20space%20is%20similar%20to%20object%20space%2C%20however%20it%20uses%20the%20origin%20and%20axes%20of%20the%20object%E2%80%99s%20parent%20node%20in%20the%20hierarchy%20of%20objects.%20This%20is%20useful%20when%20you%20haven%E2%80%99t%20transformed%20the%20object%20itself%2C%20but%20it%20is%20part%20of%20a%20group%20that%20is%20transformed. Local Space]]
|[X,Y,Z]
|-
!Rotation
|[Rotation in [[wikipedia:Radian|Radians]] and [https://help.autodesk.com/view/MAYAUL/2024/ENU/?guid=GUID-A63AC5C8-8822-42AC-827E-164B5266DA03#:~:text=Local%20space%20is%20similar%20to%20object%20space%2C%20however%20it%20uses%20the%20origin%20and%20axes%20of%20the%20object%E2%80%99s%20parent%20node%20in%20the%20hierarchy%20of%20objects.%20This%20is%20useful%20when%20you%20haven%E2%80%99t%20transformed%20the%20object%20itself%2C%20but%20it%20is%20part%20of%20a%20group%20that%20is%20transformed. Local Space]]
|[X,Y,Z]
|-
!Scale
|[Scale]
|[X,Y,Z]
|-
!Signature
|CNS
|Not Editable
|-
!SourceNodeName
|[Name of Source Node]
|Constraining bone
|}
Note: Much of this is sourced from [https://download.autodesk.com/global/docs/softimage2014/en_us/userguide/index.html?url=files/constraints_OverviewofWorkingwithConstraints.htm,topicNumber=d30e162219 Softimage 2014's Manual]

=== Orientation Constraint Block ===
This is the main way to copy a bone's orientation.
{| class="wikitable mw-collapsible"
|+Orientation Constraint Block
!Coupling
|[Rigid or Soft]
|[https://download.autodesk.com/global/docs/softimage2014/en_us/userguide/index.html?url=files/constraints_OverviewofWorkingwithConstraints.htm,topicNumber=d30e162219 Coupling method]
|-
!'''Data'''
|MikuMikuLibrary.Objects.Extra.Blocks.OrientationConstraintData
|[https://download.autodesk.com/global/docs/softimage2014/en_us/userguide/index.html?url=files/constraints_OverviewofWorkingwithConstraints.htm,topicNumber=d30e162219 Orientation Constraint]
|-
!Offset
|[X, Y, Z]
|Offset of rotation
|-
!'''Type'''
|Orientation
|Not Editable
|-
!Name
|[Name of Block]
|Name of Constraint Block
|-
!ParentName
|[Name of Parent]
|Name of Parent
|-
!Position
|[Position in [https://help.autodesk.com/view/MAYAUL/2024/ENU/?guid=GUID-A63AC5C8-8822-42AC-827E-164B5266DA03#:~:text=Local%20space%20is%20similar%20to%20object%20space%2C%20however%20it%20uses%20the%20origin%20and%20axes%20of%20the%20object%E2%80%99s%20parent%20node%20in%20the%20hierarchy%20of%20objects.%20This%20is%20useful%20when%20you%20haven%E2%80%99t%20transformed%20the%20object%20itself%2C%20but%20it%20is%20part%20of%20a%20group%20that%20is%20transformed. Local Space]]
|[X,Y,Z]
|-
!Rotation
|[Rotation in [[wikipedia:Radian|Radians]] and [https://help.autodesk.com/view/MAYAUL/2024/ENU/?guid=GUID-A63AC5C8-8822-42AC-827E-164B5266DA03#:~:text=Local%20space%20is%20similar%20to%20object%20space%2C%20however%20it%20uses%20the%20origin%20and%20axes%20of%20the%20object%E2%80%99s%20parent%20node%20in%20the%20hierarchy%20of%20objects.%20This%20is%20useful%20when%20you%20haven%E2%80%99t%20transformed%20the%20object%20itself%2C%20but%20it%20is%20part%20of%20a%20group%20that%20is%20transformed. Local Space]]
|[X,Y,Z]
|-
!Scale
|[Scale]
|[X,Y,Z]
|-
!Signature
|CNS
|Not Editable
|-
!SourceNodeName
|[Name of Source Node]
|Constraining bone
|}

== Clothing Block (CLS) ==
Also referred to as "soft body physics", this is the best way to add physics to complex meshes, like Luka's skirt on her default module. '''Unfortunately, [[MikuMikuModel]] does not support this block in its entirety yet, and can't properly import models that make use of it.'''
{| class="wikitable mw-collapsible"
|+Clothing Block
!BackFaceName
|[Name of Mesh]
|Name of the mesh used for backfaces
|-
!'''Field08'''
|[Value]
|Undocumented
|-
!Field10
|[Value]
|Undocumented
|-
!'''Field14'''
|[Value]
|Undocumented
|-
!Field18
|[Matrix4x4 Array]
|Undocumented
|-
!Field1C
|[Collection]
|Undocumented
|-
!Field20
|[Collection]
|Undocumented
|-
!Field24
|uInt16 Array
|Undocumented (Array length is same as vertex count?)
|-
!Field28
|uInt16 Array
|Undocumented (Array length is same as vertex count?)
|-
!Field30
|[Value]
|Undocumented
|-
!Name
|[Name of Mesh]
|Name of the mesh
|-
!Signature
|CLS
|Not Editable
|}

== Motion Block (MOT) ==
Motion blocks are able to animate bones on a character, but are only used in Project DIVA F, Project DIVA F2nd, and Project DIVA X.
{| class="wikitable"
|+Motion Block
!'''Name'''
|[Name of Block]
|Name of the motion block internally
|-
!'''Nodes'''
|(Collection)
|Collection of bones
|-
!'''ParentName'''
|[Name of Parent]
|Name of the parent
|-
!'''Position'''
|[Position in [https://help.autodesk.com/view/MAYAUL/2024/ENU/?guid=GUID-A63AC5C8-8822-42AC-827E-164B5266DA03#:~:text=Local%20space%20is%20similar%20to%20object%20space%2C%20however%20it%20uses%20the%20origin%20and%20axes%20of%20the%20object%E2%80%99s%20parent%20node%20in%20the%20hierarchy%20of%20objects.%20This%20is%20useful%20when%20you%20haven%E2%80%99t%20transformed%20the%20object%20itself%2C%20but%20it%20is%20part%20of%20a%20group%20that%20is%20transformed. Local Space]]
|[X,Y,Z]
|-
!'''Rotation'''
|[Rotation in [[wikipedia:Radian|Radians]] and [https://help.autodesk.com/view/MAYAUL/2024/ENU/?guid=GUID-A63AC5C8-8822-42AC-827E-164B5266DA03#:~:text=Local%20space%20is%20similar%20to%20object%20space%2C%20however%20it%20uses%20the%20origin%20and%20axes%20of%20the%20object%E2%80%99s%20parent%20node%20in%20the%20hierarchy%20of%20objects.%20This%20is%20useful%20when%20you%20haven%E2%80%99t%20transformed%20the%20object%20itself%2C%20but%20it%20is%20part%20of%20a%20group%20that%20is%20transformed. Local Space]]
|[X,Y,Z]
|-
!'''Scale'''
|[Scale of Block]
|[X,Y,Z]
|-
!'''Signature'''
|MOT
|(Not Editable)
|}

== Unused Blocks (ITM, LGT) ==
There are two unused Ex Data signatures in Arcade Future Tone's data, being ITM and LGT. Both act as a CNS block internally.

Expression Components and Instructions

2025-09-17T04:15:06Z

Platonic: Created page with "== Components == The component portion of an expression is what will be affected. For example, = 0 [Instructions] will take the value of the [Instructions] portion, and push it onto the X position of the Expression bone, while; = 4 [Instructions] will take the value of the [Instructions] portion, and push it onto the Y rotation of the bone. {| class="wikitable" |+ !Component !Value |- |0 |X Position |- |1 |Y Position |- |2 |Z Position |- |3 |X Rotation |- |4 |Y Rotati..."

== Components ==
The component portion of an expression is what will be affected. For example,
= 0 [Instructions]
will take the value of the [Instructions] portion, and push it onto the X position of the Expression bone, while;
= 4 [Instructions]
will take the value of the [Instructions] portion, and push it onto the Y rotation of the bone.
{| class="wikitable"
|+
!Component
!Value
|-
|0
|X Position
|-
|1
|Y Position
|-
|2
|Z Position
|-
|3
|X Rotation
|-
|4
|Y Rotation
|-
|5
|Z Rotation
|-
|6
|X Scale
|-
|7
|Y Scale
|-
|8
|Z Scale
|}

== Instructions ==
Instructions are the math portion of expressions. The following operations are allowed:

=== Number ===
n [value]
The '''n''' instruction pushes a number to the stack, for example:
= 6 n 1
sets the X Scale of the bone to 1

=== Variable ===
v [variable]
The '''v''' instruction gets a variable, then pushes it to the stack. The variable can either be:<blockquote>[Component].[Bone] (eg, 4.j_kao_wj, 2.kl_mune_b_wj, 6.j_ude_l_wj)

or

the '''t''' instruction (time elapsed) </blockquote>For example:
= 1 v 4.j_kao_wj
This would set the Y position of the bone to the Y rotation of j_kao_wj, or:
= 2 v t
This would set the Z position of the bone to the value of time elapsed

=== Function ===
f [function]
The '''f''' instruction gets the value on the stack, applies the function, then pushes the value. The function used can be:
{| class="wikitable"
|+
|neg
|Negate the value
|-
|sin
|[[wikipedia:Sine_and_cosine|Sine]] function (in degrees)
|-
|cos
|[[wikipedia:Sine_and_cosine|Cosine]] function (in degrees)
|-
|tan
|[[wikipedia:Trigonometric_functions#tangent|Tangent]] function (in degrees)
|-
|abs
|[[wikipedia:Absolute_value|Absolute Value]] function
|-
|sqrt
|[[wikipedia:Square_root|Square Root]]
|-
|av
|Multiplies value by 0.1
|-
|floor
|Outputs the [[wikipedia:Floor_and_ceiling_functions|floor]] (lowest integer) of a value
|-
|ceil
|Outputs the [[wikipedia:Floor_and_ceiling_functions|ceiling]] (highest integer) of a value
|-
|round
|[[wikipedia:Rounding|Rounds]]<nowiki/>the value
|-
|asin
|[[wikipedia:Inverse_trigonometric_functions|Inverse Sine]] function
|-
|acos
|[[wikipedia:Inverse_trigonometric_functions|Inverse Cosine]] function
|-
|atan
|[[wikipedia:Inverse_trigonometric_functions|Inverse Tangent]] function
|-
|log
|[[wikipedia:Logarithm|Logarithm]] function
|-
|exp
|[[wikipedia:Exponentiation|Exponentation]] function
|-
|rand_0_1
|Unimplemented, makes value 0. (It is meant to randomly generate between 0 and 1)
|}
For example:
= 0 v 1 f av
would set the X position of the bone to 0.1 (since the 1 is multiplied by 0.1)

=== Secondary Functions ===
g [function]
The '''g''' instruction gets two values from the stack, applies the function provided, then pushes the result. The function used can be:
{| class="wikitable"
|+
| +
|Adds the values
|-
| -
|Subtracts X from Y
|-
|*
|Multiplies the values
|-
|/
|Divides X by Y
|-
|%
|Takes a portion of X by Y
|-
|==
|Outputs 1 if values are equal, else 0
|-
|>
|Outputs 1 if X is greater, else 0
|-
|>=
|Outputs 1 if X is greater or equal, else 0
|-
|<
|Outputs 1 if X is lesser, else 0
|-
|<=
|Outputs 1 if X is lesser or equal, else 0
|-
|!=
|Outputs 1 if values are not equal, else 0
|-
|&&
|Outputs 1 if both values are 1, else 0
|-
|<nowiki>||</nowiki>
|Outputs 1 if one value is 1, else 0
|-
|min
|Outputs the lowest value
|-
|max
|Outputs the highest value
|-
|fmod
|Divides X by Y, and outputs the remainder
|-
|pow
|X to the power of Y
|}
For example:
= 6 n 1 n 3 g +
would set the X scale of the bone to 4 (since it adds 3 and 1)