Property Postinits

Feature

Allows you to modify property lists, without actually modifying the original .prop file, this is primarily useful in maintaining compatibility with other mods.

Usage

All property postinit data is defined inside the prop_postinits folder, so you must first create that folder in your mod.

Create a .prop file with a unique name in the prop_postinits folder.

In that .prop file, add a string8s array, with each entry postinit-ing another .prop file.

string8s postinitList
end

To add a property list postinit, add an entry to that list, each entry has the following format:

"source_proplist target_proplist"

There should be a key property in the same file, with the same name that you used for source_proplist, which tells UPE what .prop file to postinit.

There should also be a key property in the same file, with the same name that you used for target_proplist, which tells UPE what .prop file to for postinit-ing.

As an example, your file might look something like this:

string8s postinitList
	"cl_mouth_filter_01 cl_mouth_filter_01_postinit"
	"cl_mouth_jaw_01 cl_mouth_jaw_01_postinit"
	"cl_mouth_poker_01 cl_mouth_poker_01_postinit"
end
key cl_mouth_filter_01 cell_parts~!cl_mouth_filter_01
key cl_mouth_filter_01_postinit my_postinits!cl_mouth_filter_01

key cl_mouth_jaw_01 cell_parts~!cl_mouth_jaw_01
key cl_mouth_jaw_01_postinit my_postinits!cl_mouth_jaw_01

key cl_mouth_poker_01 cell_parts~!cl_mouth_poker_01
key cl_mouth_poker_01_postinit my_postinits!cl_mouth_poker_01

Each postinit file can optionally contain these two special properties:

key newParent path_to!new_parent
Which will change the parent of the postinit-ed property.
uint32s removeProperties end
This is an array of property hashes, that will remove that property from the postinit-ed property. You can convert from a property name to the hash in the Utilities tab of SMFX.
As an example, it might look like this:
uint32s removeProperties 0x9416CEA1 #modelHideDeformHandles end
It's a good idea to use a comment #, to put the actual property name after the number, so it's easier to read your files.

Last modified: 05 September 2024