Action Grouper v1.3 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.
- Execute When: the options are
	- On Execute only: requires the Execute Actions button (or the Action trigger) to be activated
	- Speech Trigger: a comma separated list of words or phrases can be entered. Requires a microhphone to be active and the VAM application to be in the foreground on Windows. Optionally the actions will only be triggered when the Speech recognition is High Confidence.
	- vBOOL changes/turns true/turns false: Only displays if a VUML plugin is in the scene. The actions will trigger when the selected vBOOL changes to be true of false.
	- Continuous: the group of actions will trigger on every Unity frame update.
- Exectue If: a condition that can determine if the actions will trigger. This is assessed after the Execute When condition.
	- Always (effectively there is no IF condidtion)
	- vBOOL is True or False: Only displays if a VUML plugin is in the scene.
- 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.
 
- 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 Source: Only displays for Boolean, String or Float parameters. Optionally these values can be dynamically set to a VUML vBOOL, vFLOAT or vSTRING value which will be determined at the time the action is executed. If set to Static then a target value can be select.
- 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.