This article is intended for mod authors to learn how to make their mods compatible with the features of Interactive Accessories, but you could also follow along if you want to use a mod that hasn't been updated by its creator yet and you have a rough understanding of how the .yaml file of the mod works.
First, let me explain how Interactive Accessories works...
If you're familiar with my other mod Visual Holsters, you'll notice that this one works in a similar way - you simply add Tags to the item records of the accessories that you want to make interactive. My mod will then detect which clothes the player is wearing and provide the interactive functionality based on the Tags you provide.
There are two kinds of Tag that Interactive Accessories uses:
1. The InteractiveAccessoryToggle Tag - Used to denote a Toggle Item.
2. The InteractiveAccessory_ Tag - Used to link an Item to a Toggle Item and vice versa.
Toggle Items
The mod works by equipping and unequipping Toggle Items. A Toggle Item is a special kind of item that does something to the other items in your mod. It might move a visor to a lowered position, or it might change the visual state of a pouch to look as though it is open.
For each of these Toggles that you want to be available as Interactive Accessories, you must add both the InteractiveAccessoryToggle Tag and an InteractiveAcessory_ Tag.
Above is an example of a Toggle Item which moves the position of the goggles from the Zenitex Combat Goggles by ScorpionTank
Items Influenced By Toggles
The second part of the equation is the items that are influenced by the Toggle Items. These are the actual Items that the player character wears. It could be a helmet, it could be a mask, it could be a backpack...
If you have made a Toggle Item to work with one of these items, you can turn it into an Interactive Accessory by adding just an InteractiveAccessory_ Tag to the item.
Since this is not a Toggle Item, do not add the InteractiveAccessoryToggle Tag.
The InteractiveAccessory_ Tag
The InteractiveAccessory_ is not actually the complete tag. It's a prefix. The full tag should actually reference the Item itself.
For example, the actual tag for the Zenitex Combat Goggles might be InteractiveAccessory_ZenitexGoggles
1. The actual name after the prefix is up to you. It should be consistent and unique to your mod.
2. The same tag must also be added to the Toggle Item itself.
This lets my mod build an association between the Toggle Item and the actual Item.
Summary
To recap, you need:
1. A clothing item with the complete InteractiveAccessory_ Tag, e.g. InteractiveAccessory_ZenitexGoggles
2. A Toggle Item that changes how the clothing item is displayed, with both an InteractiveAccessoryToggle Tag and the same InteractiveAccessory_ Tag as above.
Then once ingame, Interactive Accessories will be able to show you all of the Toggles available for the clothes that you are wearing.
YAML Examples
Toggle Item Example
Some parts of the Item Record (...) are omitted for brevity.
Clothing Item Example
Some parts of the Item Record (...) are omitted for brevity.
0 comments