Un.mii

2025-08-31T17:00:19Z

172.28.0.1: initial page: what is it, interesting facts, and why they made, why it is the way it is

''un.mii'' is a Mii rendering and parsing library written in C# that was found to be used in [[Pikmin Bloom]]. Presumably, it's also used in [[Mario Kart Tour]], given that it's also using Unity and can render 3D Mii heads.

Info about this library and its namespace hierarchy was found in Pikmin Bloom's ''global-metadata.dat'', which stores metadata about .NET assemblies that were compiled using il2cpp, which is an obfuscation/optimization technique Unity uses when compiling .NET bytecode to native machine code.

In order to read the ''global-metadata.dat'' file, a tool such as this can be used: https://twy.name/Tools/global-metadata/. The un.mii namespace is included in <code>Assembly-CSharp-firstpass.dll</code>, although there are two others with one class each: <code>CoreDataConverter.dll</code>, <code>CharInfoConverter.dll</code>.

The library itself highly resembles [[nn::mii]]. Class names/members, enums, method names, and method parameters are all shared with nn::mii.

==== nn::mii resemblance ====
* There are "CharModel" and "CharModelImpl" classes, which follow the [[wikipedia:Opaque_pointer|"p_Impl" pattern]] that isn't typical in C#.
* There are class members that are prefixed with "m", and argument names prefixed with "p" (pointer). Neither conventions are used in C#. (Look at "Mask")
* Since C# is strictly object-oriented, all methods are now in classes. An example is the "Adjustment" class, taken from "mii_Adjustment.cpp". Names like "un.mii.Adjustment.GetEyeRotateOffset()" would've previously been "nn::mii::detail::GetEyeRotateOffset()", as C++ does not force everything to be in classes.
* un.mii has many enums for every type, e.g.: EyeType, HairType, EyeScale, Ver3BirthPlatform, etc. These enums are also present in nn::mii, but there they're usually isolated to the "mii_ParamCommon.h" or "detail/mii_Ver3Common.h" headers, whereas here they all live in the un.mii namespace.
** The enums are usually just made up of "Min", "Max", "End", sometimes "Empty", and on occasion other values.
* The anonymous namespace of Assembly-CSharp-firstpass.dll contains types from un.mii that are also anonymous in nn::mii. For example: Three "DrawType" enums for faceline/mask/model, DrawTypeImpl also found in nn::mii::detail::CharModelImpl, then types seen in MaskImpl like ExpressionDrawParam, EyeComponent, EyePlaceParam, EyeTexturePair...
* Some classes are "accessors" for data used with Get/Set methods, which are copied from nn::mii (e.g.: Ver3StoreDataRaw, ParamCharInfoAccessor), which are kept the same despite C# having property getter/setters that can be used instead. However, the CharInfo class does use properties with getters/setters.
* There are also structs/enums from libnn_mii_core that had previously unknown fields. For example: Ver3StoreDataMember/Type, Ver3StoreDataTableElement, CommonColorElement, real names for Mask constants, VerifyReason, Ver3BirthPlatform max being 7, RandomMii tables... This makes it a good resource to reverse nn::mii.
Given all of this information, ''un.mii'' seems to be a direct source port of [[nn::mii]] in C# for use with Unity. There are many signs that the C++ code was directly ported without following C#/.NET conventions. There are also, of course, signs that it's only meant to be used with Unity.

==== Unique traits of the library ====

* un.mii does not read any existing [[Mii Resources|Mii resource file formats]], instead opting to store and retrieve shape and texture data from the data.unity3d file, where you can indeed find shapes and textures for Miis in Pikmin Bloom's data.unity3d. The assets are also in the "un.mii" namespace.
** Shapes are categorized as "middle" and "high", as well as having "low" and "middle" textures, once again suggesting the NintendoSDK/nn::mii lineage. The files are named with their internal part names (for example, "FaceT_line06") and may match up with internal tooling Nintendo uses to pack/unpack Mii resources.
** Textures are stored in ASTC6x6, and stretched to the proper shape (e.g. eyes are stored in square shape)
* There are "TextureRendererBehaviour" and "FacelineTextureRendererBehaviour" types, suggesting Mono behaviours. There's also Renderer classes for both, containing a "CreateGameObject" method that clearly refers to the Unity GameObject type. Likewise, CharModel and CharModelImpl have references to the RenderQueue type.
* The "Database" class from nn::mii is kept, albehit just has three methods: GetDefault, GetRandom, and GetRandomVer3StoreData. So it has nothing to do with the [[Mii Database]], but functions are categorized there just like nn::mii did.

Overall, it's just a port of the nn::mii codebase to C# with a few tweaks made for Unity. It's interesting given that nn::mii can be considered a port of FFL, with many pieces of code copy-pasted from it.

Ironically, given that Unity compiles .NET code to C++ anyway, it may have made more sense to just use nn::mii as-is using [https://learn.microsoft.com/en-us/dotnet/standard/native-interop/pinvoke P/Invoke]<sup>, like [https://github.com/ariankordi/FFLSharp FFLSharp].</sup> However, the reasons they couldn't include that all versions of the [[Face Libraries|Face Library]] heavily depend on the system/SDK's graphics API (GX, GX2, nn::gfx) and rely on their respective resource binary format. Interop with C libraries is also inconvenient and avoided in most languages, so combined with the inflexibility mentioned, is why they made the choice they did.

Notably for Miitomo they did go the route of modifying [[Cafe Face Library|FFL]] to remove GX2 calls and made [[Arch Face Library|AFL]], but it accumulated tech debt over time by trying to merge it with libnn_mii_core. It's less likely they would've done this for [[nn::mii]], given that the way it manually manages graphics buffers and pipelines makes it even more dependent on nn::gfx than FFL is on GX2.

== Uses ==
* Pikmin Bloom
** While the global-metadata.dat is visible, it's not clear where all il2cpp types and methods go to.
** The [https://github.com/djkaty/Il2CppInspector/ Il2CppInspector tool] is unable to open its libil2cpp.so.
* Mario Kart Tour(?)
** Its global-metadata.dat is hidden, and libil2cpp.so is reportedly encrypted: https://gameguardian.net/forum/topic/26082-mario-kart-tour/page/38/#comment-110128
** Mii assets also can't be found in its data.unity3d file.
{{FL-Navbox}}
[[Category:Face libraries]]

Miitopia

2025-08-05T00:27:23Z

172.28.0.1:

{{Stub}}

Miitopia is a game released for the [[3DS]], and remade for the [[Switch]].

== On Nintendo Switch ==
its all weird
[[Category:Mii editing software]]

Mii Studio (nintendo.com)

2025-08-04T22:53:25Z

172.28.0.1: /* Rendering */ correction

[[File:Mii Studio Screenshot.png|alt=Editing a Mii in Mii Studio|Editing a [[Mii]] in Mii Studio|thumb|358x358px]]
Accessed at https://studio.mii.nintendo.com, Mii Studio is a web app for any Nintendo account user to edit their associated Miis.

== Implementation ==
Through "reverse engineering" (lol) we have found out this information about Mii Studio:

=== Storage Format ===
[[Mii]]<nowiki/>s are stored in Mii Studio using the browser's local storage. They are encoded in base64.

Here is a [[Kaitai Struct]] definition:<syntaxhighlight line="1">
foo
bar
bar
foo
</syntaxhighlight>

=== Rendering ===
Mii Studio appears to render Mii data through layering. It uses the [https://developer.mozilla.org/en-US/docs/Web/API/Canvas_API Canvas API] to make a series of texture drawings calls with transformations.
[[File:Mii Studio WebGL Debugging.png|alt=A screenshot of Safari's developer tools, showing the steps taken in drawing a Mii head.|left|thumb|432x432px|Debugging Mii Studio's canvas rendering with Safari]]
[[Category:Mii editing software]]

File:Mii Studio Canvas Debugging.png

2025-08-04T22:50:56Z

172.28.0.1:

Debugging Mii Studio's canvas rendering with Safari

Mii Technical Wiki - User contributions [en]

Un.mii

Miitopia

Mii Studio (nintendo.com)

File:Mii Studio Canvas Debugging.png