"description" : "This plugin automates settings on Atoms to toggle whether a Tracker is controlling them, such as to quickly toggle a tracker on your waist that controls the movement of a person's pelvis or hips, or a tracker on the end of a Fleshlight that controls the movement of a person's head (both at the same time is often a great setup).\r\n\r\nYou can do this all manually through VAM UI, but it's a bit of a pain to manage while you're trying to enjoy or work on a scene, as opening the UI forces an exit of Embody by default, and exiting Embody causes the physics simulation to freak out if the trackers have an active physics link, due to the camera position popping away. Additionally, VAM intentionally doesn't load linkage values for the \"Link to Atom\" or \"Link To\" values, such that you can't load a scene and have it start off all linked up. So, without this plugin, you always have to dive into the Atom's controllers' UI settings to relink them to your trackers.\r\n\r\nThis plugin is inherently based around voice controls due to the intention for utilizing it while using Embody. You can simply say key phrases like \"Control Her Head\", \"Stop Controlling Her Head\", \"Control His Pelvis\", and so on to easily toggle when you want to control various Atom controllers via designated Trackers.\r\n\r\nI've also added Atom choices such as \"<Auto> Female\", \"<Auto> Male\", or \"<Auto> Dildo\", where the plugin will search within the scene for the first matching Atom and use that. This allows for using this plugin as a session plugin where it generally works out of the box for most scenes with a man an a woman. If you have multiple males or females in a scene, or simply wish to control other Atoms, you may configure this plugin to do that by using the Atom choosers in the plugin's UI.\r\n\r\nThe speech recognition recognized phrases to start and stop controlling are displayed for each Atom-Tracker pairing. You may edit these as you see fit, even using shared phrases across more than one Atom-Tracker pairing, such as using \"Stop Controlling Her\" on multiple pairings controlling her head, pelvis, etc.\r\n\r\nNote that I've configured the plugin to handle up to four Atom-Tracker pairings, as that's all I typically need for my purposes, and that's also all that easily fits in the UI without scrolling. I may increase that, such as up to 8, if there's enough interest. Otherwise, you should be able to just add another instance of the plugin for additional Atom-Tracker pairings.\r\n\r\n\r\nAdditional Optional Setup\r\n-------------------------\r\n\r\nIf you'd like to use a Fleshlight to control Atoms in VAM, I highly recommend printing out an \"End Cap with Vive Tracker Adapter\". Here are some links to get you on that path, but the basic idea is just a replacement cap for a Fleshlight that has a bolt hole so you can connect the tracker to that end cap.\r\nhttps://www.reddit.com/r/VAMscenes/comments/knfbxb/fleshlight_end_cap_with_vive_tracker_adapter/\r\nhttps://www.thingiverse.com/thing:4701786\r\n\r\nI also recommend a belt to attach a tracker to your waist, mainly for controlling an Atom's pelvis or a toy such as a dildo. You can purchase tracker belts and wrist/ankle straps many places, including Amazon, so just search around for a good deal on those. I only really use the waist strap for VAM, but they tend to come as a set, and sometimes ankle trackers and such can be useful.\r\n\r\nI see there's a plugin from VRStudy called \"LabelTrackers\" that looks like it should help you visualize the designation of each tracker inside VAM's 3D view. I haven't used it, so I can't vouch for it, but that may help if you need to trouble shoot any issues.\r\nhttps://hub.virtamate.com/resources/labeltrackers.1464/\r\n\r\n\r\nHow to set up Vive trackers for use in VAM\r\n------------------------------------------\r\nSteam VR Settings\r\n1) Lauch Steam VR.\r\n2) Select \"Steam VR settings\"\r\n3) Select \"Manage Trackers\"\r\n4) Assign Trackers to \"Left Foot\" through \"Keyboard\", as VAM's indexing starts with 1 at \"Left Foot\" and only supports up to an index of 8 at \"Keyboard\". I recommend just using \"Left Foot\" [1] and \"Right Foot\" [2] if you only have two trackers (not counting the standard two hand controllers). These designations don't really mean anything to VAM other than the number; the fact that you're picking \"Feet\" is irrelevant.\r\n2) Restart Steam VR.\r\n\r\n\r\nManual Process for Starting and Stopping Tracker Control of an Atom (what this plugin automates)\r\n------------------------------------------------------------------------------------------------\r\nTo start tracker controlling Atom:\r\nVirtaMate\r\n1) Inside VAM, in person's pelvis control tab (or head, dildo, etc.), set a link to Atom: \"Camera Control\", Link to: \"Tracker1\" (if you set \"Left Foot\" in step 1).\r\n2) Set Physics Link for Rotation (first to avoid spinning - could probably freeze simulation first alternatively).\r\n3) Set Physics link for Position.\r\n4) Atom should now conform to tracker pos and orient.\r\n\r\nTo stop tracker from controlling Atom:\r\nVirtaMate\r\n1) Set Position of Atom back to whatever it was before you set it to \"Physics Link\" (such as \"On\", \"Comply\", \"Off\", etc.).\r\n2) Set Rotation of Atom back to whatever it was before you set it to \"Physics Link\" (such as \"On\", \"Comply\", \"Off\", etc.).\r\n3) Atom should no longer conform to tracker pos and orient.",
