Action Grouper v1.2 Plugin Usage Guidance
=========================================

The Action Grouper plugin UI consists of two main parts. The controls on the right can be used to select and configure each Action. The controls on the left can be used to start, add, remove and copy actions aswell as perform bulk operations.
 
- Execute Actions: triggers all Actions to be executed. Action are execute in numerical order (i.e. Action 1 being first) - but will be executed in the same unity physics frame, so will appear to start simultaneously.
- Enable Auto start on Scene Load: if selected the actions will be exectued when the scene loads.
- Add Action: Adds a new Action to the list of Actions in the Group
- Copy Action: Duplicates the current action as a new action
- Delete Action: Deletes the current action
- Bulk Operation: Select a bulk operation to be perfomed. The options are "Copy Acts From" and "Change <Atom>" (an option will be listed for every Atom in the list of Actions)
- Bulk Operation tartget: Defines the target for the bulk operation. Depending on the Bulk Operation the options will be:
                For "Copy Acts From" - all occurences of the Action Group plugin available in the scene
                For "Change <Atom>" - all other Atoms in the scene of the same type will be listed
- Execute Bulk Operation: this will perform the bulk operation selected in the two controls above.
- Select Import Scene: select a Scene file to load Action Groups from
- Action Grouper Plugin: once a scene is selected, then all Action Grouper plugins in that scene will be listed. Choose one to improt from.
- Import Actions from Scene: Actions from the select plugin and scene will be loaded into this scene and plugin

 
- Action: List of Actions in the Group in the order they will be executed (all actions execute within the same Unity frame update and often the order is not significant). All the UI controls below this one relate to the Action selected.
- Move Action Up Order: Move actions up the order of execution.
- Move Action Down Order: Move actions down the Order of execution.
- Execution Probability: Assign a probability to the action. Zero indicates the action will never execute. 1 indicates the action will always execute.
- Atom: Select an Atom from the scene which contains the action to be executed
- Receiver Group: For Person atoms, this providers a filter on the Receivers
- Receiver: Select a Receiver within the Atom
- Target: Select a Target within the Atom
- Target Value: Select the Target Value to be applied when the action is executed. If the value is N/A then no Target Value is required.
- Test Action: This tests the currently seleted Action without executing any other actions in the Group
- Hide Save & Restore actions: This toggle hides a number of standard Save & Restore Target actions that are on every VAM control but are not likely to be needed for Action Grouper. This just declutters the Group setup process.

In addition to the attributes Atom>Receiver>Target hierarchy of attributes, the plugin introduces a few additional Actions that are not directly available from the normal VAM UI with a single action. These can be accessed under a Person Atom by selecting the 'Other' Receiver Group. The first two Receivers contain a number of extra Target actions:

- Load Look/Pose/Preset:
	- Load Clothing Preset: a clothing preset can be selected and loaded
	- Merge Clothing Preset: a clothing preset can be selected and merged with the current clothing
	- Remove Clothing Preset: only the clothing items in the selected preset are removed
	- Reset Sim Cloth Preset: the clothing items in the selected preset (if active) have the clothing Sim Reset
	- Sim Undress Cloth Preset: the clothing items in the selected preset (if active) have Sim Undress enabled
	- Sim Dress Cloth Preset: the clothing items in the selected preset (if active) have Sim Undress disabled
	- Load App Preset: an Appearance preset can be selected and loaded
	- Load Morph Preset ... etc: all the different presets can be selected and loaded
	- Load Look/Pose/Preset: Trigger the original VAM Load Look, Pose and Preset before 1.17 introduced the new Preset system

- Dress/Undres Clothing
	- Undress All Clothing: all currently active clothing items have Sim Undress enabled
	- Dress All Clothing: all currently active clothing items have Sim Undress disabled
	- Reset Sim All Clothing: all currently active Sim clothing items are Sim Reset
	- Remove All Clothing: removes all active clothing items