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)).)*Blend.*\s*\]

Tip

Whether the section name is lowercase/uppercase does not matter

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, the name of the section has a bit more flexibility to follow the following pattern. However, you need to specify what mod you are trying to fix by using the --defaultType option

(see Command Options for details about more command line options and names for mods to specify in the options)

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

Tip

Whether the section name is lowercase/uppercase does not matter

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         ]