File Requirements

Note

If you know your mods are auto-generated using the standard scripts provided by GIMI, you can probably skip this section. The content below is dedicated to mods with custom made .ini files.

For those who stayed, let us continue.

Basic Assumptions

• Assume you are fixing a mod with the name YourModName

• Your mod works before even using the fix

Definitions

Mod Objects

A mod is usually split into many different objects/parts (eg. an object for the mod’s head, an object for the mod’s body, etc…). We will be referring to these objects as mod objects. Luckly the mod objects for a type of mod are usually standardized to be the same. See GIMI Assets for more info about the mod objects for a particular mod.

Ini Files

Blend Sections

The root sections that reference some sort of Blend.buf is recommended to be named based off the following Regex format:

\s*\[\s*TextureOverride.*YourModName((?!(RemapBlend|CN)).)*Blend.*\s*\]

eg.
For the following .ini file named blendNameExample.ini, the highlighted line is the name where you need to pay attention to the naming.

blendNameExample.ini

[TextureOverrideYourModNameBlend]
...
if $swapvar == 0
    Run = AnyNameYouWantHere
    vb1 = ResourceBoo
else
    Run = AnotherSectionName
endif

[AnyNameYouWantHere]
vb1 = ResourceToBlend
Run =

[AnotherSectionName]
vb1 = ResourceFreeToNameThisWhateverYouWant
Run = ThisIsALeaf

[ThisIsALeaf]
vb1 = ResourceHello

[ResourceToBlend]
filename = BelloBlend.buf

[ResourceFreeToNameThisWhateverYouWant]
filename = BananaBlend.buf

[ResourceBoo]
filename = PoopayeBlend.buf

[ResourceHello]
filename = BeeDooBeeDooBlend.buf

Normal Blend Naming Examples

[TextureOverrideKeqingBlend]

[TextureOverrideOhNoRaidenShogunInTheKitchenBlender]

[      TextureOverride.Fun.With.SpacesShenheBlend         ]

If you ran the command line with the --all option (see Command Options for more command line options), the name of the section has a bit more flexibility to follow the following pattern

\s*\[\s*TextureOverride.*Blend.*\s*\]

All Option Blend Naming Examples

[TextureOverridePierrotLunaireBlend]

[     TextureOverrideDerKrankeMondBlenderDerMondfleck       ]

Mod Object Sections

Tip

See Mod Objects for how we define a mod object

• Assume we are referring to a mod object by the name YourModObject

The root sections that reference some soft of Blend.buf is recommended to be named based off the following Regex format:

\s*\[\s*TextureOverride.*YourModObject\]

eg.
For the following .ini file named modObjectNameExample.ini, the highlighted line is the name where you need to pay attention to the naming.

modObjectNameExample.ini

[TextureOverrideKeqingBody]
...
if $swapvar == 0
    Run = AnyNameYouWantHere
    vb1 = ResourceBoo
else
    Run = AnotherSectionName
endif

[AnyNameYouWantHere]
vb1 = ResourceToBlend
Run =

[AnotherSectionName]
vb1 = ResourceFreeToNameThisWhateverYouWant
Run = ThisIsALeaf

[ThisIsALeaf]
vb1 = ResourceHello

[ResourceToBlend]
filename = BelloBody.dds

[ResourceFreeToNameThisWhateverYouWant]
filename = BananaBody.dds

[ResourceBoo]
filename = PoopayeBody.dds

[ResourceHello]
filename = BeeDooBeeDooBody.dds

Mod Object Naming Examples

[TextureOverrideJeanHead]

[TextureOverrideWhatABeautifulDress]

[      TextureOverride.Fun.With.SpacesCelestialBody         ]