Status
Version change awaiting approval before being displayed publicly.
Possession Manager
Save how you possess your body and what each tracker or VR controller drives as a profile, then switch it on and off from VaM's toolbar.
Made for VR, since the links need trackers or VR controllers. Tested with VaM 1.22 on a Quest 3. You only need Embody for Embody profiles.

01_main.png

The panel with the example profiles, the Possess, Group 1 and Group 2 switches, and All off.

I made this because setting up possession for every scene is tedious, fiddly and inconsistent. I wanted VaM to be as close to "just play" as I could get it once a scene loads, with my own controller and tracker setup. Possession Manager saves, as a profile, how you possess your body (VAM Possession, Embody or neither) and what each tracker or VR controller drives for you and/or your scene partner(s), so in any scene you just pick the profile and switch it on. Bodies can be Auto: choices such as Auto: Male and Auto: Female, which is what lets one profile work in any scene with those people in it.

Each of these has an example profile to start from:
  • A tracker on your hips, linked to your body's hipControl, makes your real hips move your body's hips. Possess your body with VAM Possession or Embody first. (Example - Hips tracker)
  • Add a second tracker on a fleshlight or toy and it drives your partner's hips (Group 2) while yours stay in Group 1. Switch your own hips on first, then your partner's once you're lined up. (Example - Toy and hips)
  • With Embody you get its view and body, and the toy tracker still drives your partner. (Example - Embody and toy)
  • No trackers? Your VR controllers work too, one tucked into your waistband for your hips and one strapped to a fleshlight for your partner's, or just one of them. Leave those hands out of possession so the controllers are free for the links, and with Embody leave them out of Embody's own settings too (see the Embody section below). (Example - Controllers as hips and toy)
  • Or skip links and just possess your body. VAM Possession then offers only your body's head, followed by the hands you tick, so you can't take the wrong person in a busy scene. (Example - Head and hands)

When a pose changes
Loading a pose, whether it's a pose preset, a Timeline pose or BodyLanguage, cuts possession and links on the body it poses, and normally nothing tells you. Embody stays on but your head stops following you, and VAM Possession leaves the head behind. Possession Manager watches what it started, and when a pose cuts it:
  • It restarts Embody, so your head and hands follow you again.
  • With VAM Possession, it offers your body's head again. Put your head in the sphere, then possess your hands as before. If the pose let go of only one hand, it offers just that hand, and you push your VR controller into the hand sphere.
  • It turns off any group whose link was cut, because that link was lined up with the old pose. Line up again and turn it back on.
It only watches what a profile started, so an Embody you switched on yourself isn't watched.

Quick start
  1. Add PossessionManager.cslist as a session plugin (Main UI > Session Plugins) so it stays loaded from scene to scene. To have it load every time VaM starts, open Session Plugin Presets and press Change User Defaults..., which saves your session plugins as the default.
  2. Open the plugin's panel and select an example profile. The selected one turns blue. The examples use Auto: Male as you and Auto: Female as your partner, with Tracker 1 on your hips and Tracker 2 on the toy, and the controller ones use your left VR controller for your hips and the right one for the toy. If one fits, go straight to step 4, unless it's the Embody example, which also needs the Embody profile from step 3. Otherwise clone or edit one, or press Create profile.
  3. In the editor, choose a possession system and Your body, then the atom and controller each device drives, for example Tracker 1 > Auto: Male > hipControl. Press Save profile and the list opens with your profile selected. If you use Embody, save an Embody profile too, as "Using it with Embody" explains.
  4. Switch possession on with Possess on the toolbar or the possession tick box on the panel, and get into position. With VAM Possession, put your head in the sphere on your body's head and press Select, then push each possessed hand's VR controller into its sphere and press Select. The status box tells you what to do next.
  5. Switch on Group 1, Group 2 or both. All off stops everything.

02_editor_two_trackers.png

Toy and hips, with Tracker 1 on your hips (Group 1) and Tracker 2 on the toy (Group 2).

04_engaged.png

Everything on. Possession and both groups are ticked and the profile row is green.

05_toolbar_off_on.png

The toolbar buttons, all off and all on.

The possession system is None, VAM Possession (VaM's own Possess and Align) or Embody, used with its current settings or with one of your Embody profiles. If your body doesn't have Embody yet, it's added and stays on it.

A link ties one of your devices, the Left Hand or Right Hand VR controller or Tracker 1 to 8, to a controller such as hipControl on a person, a Dildo atom or a DildoLanguage toy. The controller follows the device rigidly. Only its position follows unless you tick Rotation. With VAM Possession, untick the hand of any VR controller you link.

Every link is in Group 1 or Group 2, and each group has its own switch, so your hips and your partner's can go on separately. Links to your body start in Group 1 and links to anyone else in Group 2.

Possession and links have separate switches because you should possess first, see where you are and get into position before any link goes on. A link that starts while you and your VaM body aren't lined up pulls the controller to the device and can break the pose. If the scene already handles possession, you can use just the links.

Switching a group off leaves the body where it is and gives each controller back its Position and Rotation state, its grab settings and any link it already had.

When a pose change cuts a link, the status box says "Group 1 off: the pose changed. Line up and turn it back on." That controller gets back only its grab settings, so the new pose stays. If the controller was linked to something else instead, by you in VaM's Control tab or by another plugin, the group goes off with "Group 1 off: its controller was linked to something else. Turn it back on when you're ready." and the other link is left alone. If restarting Embody doesn't bring the tracking back, you'll see "The pose changed and restarting Embody on <your body> didn't help. Switch possession off and on again."

For each body, pick a named atom to tie the profile to one scene, or an Auto: choice to use it anywhere:
  • Auto: Female and Auto: Male take the first female or male person.
  • Auto: Person 1 and Auto: Person 2 take the first and second person.
  • Auto: Dildo takes the first Dildo atom or DildoLanguage toy.

A session profile is listed in every scene, and a scene profile belongs to one scene. Each scene can have a default profile of either kind. With Scenes without default: auto-select first valid profile on, a scene with no default selects the first profile that works there, meaning its body and everything it links are in the scene. Scene profiles are checked before session profiles, each in list order.

Selecting another profile while one is on switches this plugin's possession and links off first, so the scene doesn't break. The same goes for Next/Previous and UI Assist's profile buttons.

To rename a profile, change its name in the editor. You clone, reorder (with the arrows) and delete profiles in the list. Each one is a plain JSON file in Saves/PluginData/Holomancer/PossessionManager/.

The examples all use Auto: Male as your body and Auto: Female as your partner, and all but one use VAM Possession:
  • Example - Hips tracker has Tracker 1 on your hips and both hands possessed.
  • Example - Toy and hips has Tracker 1 on your hips, Tracker 2 on the toy and both hands possessed.
  • Example - Embody and toy uses Embody, with Tracker 2 on the toy.
  • Example - Left controller as hips links the left VR controller to your hips and possesses the right hand.
  • Example - Right controller as toy links the right VR controller to the toy and possesses the left hand.
  • Example - Controllers as hips and toy links both VR controllers and possesses no hands.
  • Example - Head and hands has no links and possesses your head and both hands.
To keep a VR controller completely free, untick its hand and leave it unlinked. The examples are added the first time the plugin starts and are yours from then on, so an update never brings back one you edited or deleted.

With Replace possession toolbar buttons on, as it is by default, VaM's two Possession buttons become Possess (the headset icon) and All off, and Group 1 and Group 2 go in a column beside them. Untick it to get VaM's own buttons back.

A green button is off and a dark grey one is on, so you press green to switch something on. Light grey means the selected profile doesn't use that button, and All off goes dark grey whenever anything is possessed or linked. I picked the colours so colour-blind players can tell them apart, every button has its own icon, and hovering over one tells you what it will do.

All off switches off:
  • this plugin's possession and both groups
  • VaM's own possession, wherever it was started
  • every Embody that's on
  • the older Passenger plugin
You'll find it on the toolbar when the toolbar buttons are replaced, always on the plugin's panel (orange while anything is possessed or linked) and in UI Assist. Triggers can use it as the Deactivate all action.

Only one possession can run at a time. If something else is already possessed, possession won't start, and the status box says what it is so you can switch it off where it was started or press All off.

A device name turns red when:
  • its atom or controller isn't in this scene
  • it drives a controller the chosen Embody profile also possesses
  • it's a VR controller linked as a tracker while VAM Possession has that same hand ticked
The status box says what to change. Saving is blocked only for a missing name, a name that's already used, or a profile with neither a possession system nor a link.
03_editor_embody_conflict.png

Tracker 3 is red because it drives headControl, which the Embody profile also possesses.

VAM Possession pauses Embody. An Embody that's on a body but switched off turns itself on as soon as VaM possesses that body's head, so while this plugin's VAM Possession is on, it unticks Embody's Enabled box on the bodies you could possess and puts it back afterwards.

Embody reads its settings marked * from your Embody profile, not the scene, while that module's Use Profile is on, which it is by default. Change one in a scene and it's back to the profile's value next time. Set these once in Embody and save them in an Embody profile:
  • In Passenger, untick Exit On Menu Open. It's on by default, so opening VaM's menu in VR ends Passenger and drops you out of POV. Embody's Passenger page has more.
  • If a Possession Manager profile links a hand's VR controller, to your hips for example, untick Enabled for that hand in Embody's Trackers module, save that as an Embody profile and choose it as the Embody Profile in your Possession Manager profile. The editor can't spot this clash, so it won't warn you.
Save As Default Profile applies your settings wherever Embody loads, and it's what "Embody's current settings" starts from. Save Profile As keeps a named profile in Saves/PluginData/EmbodyProfiles, and those are the profiles the Possession Manager editor lists. Embody's profiles page explains both.

Keybindings (AcidBubbles) lists the plugin's actions under PossessionManager, ready to bind to keys.

UI Assist (JayJayWon) has a ready-made grid behind its yellow EXT button, with:
  • Possess, Group 1 and Group 2, coloured like the toolbar
  • All off, orange while anything is possessed or linked
  • Previous and Next profile (grey)
  • a button for each profile, this scene's and the session ones, blue for the selected one and kept up to date as profiles are added, renamed or deleted
  • Open Possession Manager (purple), which opens the plugin's panel for things like setting the scene default or making a scene profile
The cyan button under the grid shows the selected profile's name.
06_uiassist_grid.png


If you'd rather have your own layout, use UI Assist's Import Grid from UIA Profile... and pick Possession Manager from this package. Don't use Load Profile, which replaces all your grids. You get an ordinary UI Assist grid you can edit:
  • At the top is one blue button per example profile. To point one at another profile, change the profile name in UI Assist's Button Setup.
  • In the middle are Previous and Next profile (grey) and Open Possession Manager (purple).
  • At the bottom are Possess, Group 1 and Group 2 (green off, dark grey on) and All off (orange).
This grid can't show which profile is selected, because UI Assist doesn't support that yet. The EXT grid can.
08_uiassist_imported.png

Triggers and scripts can use these actions:
  • Possession: Toggle possession, Possession on, Possession off
  • Group 1: Toggle Group 1, Group 1 on, Group 1 off
  • Group 2: Toggle Group 2, Group 2 on, Group 2 off
  • Everything: Deactivate all
  • Profiles: Select next profile, Select previous profile
A toggle flips its switch, and on and off set it. They can also set Possession active, Group 1 active and Group 2 active (on or off), and Selected profile (a profile by name).

VaM doesn't let scene triggers, such as a UIButton, reach a session plugin. To use one anyway:
  1. Add Possession Manager to the scene as well (Scene Plugins). There it acts as a scene relay, finding the session plugin and passing every trigger on to it, with no second set of profiles or toolbar buttons.
  2. In the trigger, choose the CoreControl atom, then Possession Manager's plugin as the receiver, then the action.
The relay's panel has a Go to session plugin button. If Possession Manager isn't loaded as a session plugin, the relay's panel and VaM's Error Log say so, and the relay picks the session plugin up as soon as it's added.

Only one copy runs as a session plugin, and only one scene relay per scene. Any other copy says Already loaded, does nothing and offers to remove itself.

Unticking Possession Manager's Enabled box switches off this plugin's own possession and links, gives VaM's toolbar buttons back, and makes it ignore triggers, keys and grid buttons until you tick it again.

Embody is listed as a dependency, so VaM offers to download it, but only profiles that choose Embody use it. Keybindings and UI Assist are optional. Problems go to VaM's Error Log and state changes to its Message Log, and every line starts with [PossessionManager].

If you already use Embody, keep it. It's the immersion layer (point of view, Passenger, Snug, trackers), and you can choose it as a profile's possession system, which sets it up and switches it on for you.

Tracker Controller does a similar job by voice. This one saves the setup as profiles and works with VR controllers as well as trackers.

I've tested it with a Quest 3 and its controllers. I don't have any trackers to test with. If you notice anything odd, tell me in the Discussion tab and say which headset and trackers you use. Thanks.

Credits
I designed this after studying Embody by AcidBubbles and Tracker Controller by AlienAxeMan. No code is copied from either.
React to this content...
Click the links below to support the other creators whose content was used to make this resource!

Share this resource

Credits

Creator Support Link
Acid Bubbles Acid Bubbles
Back
Top Bottom