Creating metadata toggles with IMC Mask Groups
✿ A follow along guide by Miette
✿ Hello, Miette here~ This is a follow along guide in creating metadata toggles for your mod during modpack creation. Previously, I made a guide on how to use metadata toggles in Penumbra, which can be found here, but TexTools has implemented a (imho seamless) way to include toggles to make the process much easier for both the mod creator and end user.
For this example, I will be using Selaine to demonstrate the process. Bear in mind, this mod’s materials haven’t been properly edited for Dawntrail, but this is one step I’m taking to update my mods and I wanted to share that process for other creators/users to be aware of how to do it themselves. C: This process might look slightly different for new mods you are creating, but this is how I’m doing this to update previous mods!
Selaine has 5 metadata toggles on the outfit itself. So, I want to add these toggles directly to the modpack.
Here’s how that’s done!
After updating the modpack for Dawntrail by putting it through TexTool’s ‘Upgrade modpack(s)’ process
I go to ‘Mods’ > ‘Create Modpack’ > ‘Advanced’.
From the Create Modpack window I select ‘Load From…” and select Selaine. Since I ran it through the TexTools upgrader, it’s been saved with _dt at the end.
Click on ‘Next Page’ to access the modpack’s options. From here, select ‘Add’, and then ‘IMC Mask Group’.
Click on the newly created imc group created and select ‘Edit’.
Name your group, then click on ‘Item Set:’ and search for the item that you are adding the metadata toggles for. In Selaine’s case, I need to select the No.2 Type B Dress.
You need to update ‘Variant’ and ‘Material Ver’ from 0 to 1, or else Penumbra will throw you errors about the entries being invalid. If your chosen item as several variants, then you also need to check on ‘Apply to All Variants’. The No2 Type B Dress doesn’t have variants, but I selected it just to show where it is.
Make sure you do not check on any of the letters above the ‘Options’ section, or else Penumbra will throw errors, as well that a metadata option is already ‘enabled’. Click on ‘Add Option’ and and name your first toggle and assign it a letter. For Selaine, the first option is the arm bands, so I labeled the option that, and gave it the metadata toggle label of ‘A’.
Feel free to give your option a description.
Do this for every metadata toggle you want to include. Make sure none of the toggles share a letter label. Click ‘Done’ when you are finished.
For ease, I check on all of the metadata toggles so they show up upon installation and users can toggle what they want to turn off.
Click on ‘Finish’, name your modpack, then save it! Wait for TexTools to tell you the modpack has been created successfully, then test it in Penumbra.
Check off/on your toggles to make sure they are working without an issue in Penumbra. Selaine’s are working, so I consider this part of the update finished!
!! - Please ignore how the sleeves look, I’m in the process of updating this mods materials/textures to look and work better with Dawntrail since the glass shader has changed.
!! - Please understand that this guide isn’t all encompassing, and is rather bare bones. Selaine is a good example of my wanting to create “linked” metadata toggles (ex: if you turn off the wristbands it would also check off the sleeves, as the sleeves do not work separately from the wrist bands, but the wrist bands do), but that isn’t something I have managed to successfully create (yet). It could be because of me, or because IMC Mask groups are still a work in progress. However, once I do, I will be certain to update this guide to reflect how such a thing is accomplished.
In the meantime, I hope this guide has been helpful! Enjoy creating~