Getting started - acidbubbles/vam-embody GitHub Wiki

How to get the plugin

Here's the official download page for Embody: https://hub.virtamate.com/resources/embody-beta.6513/

Subscribe on Patreon to have a chance to try new features under development! You can also clone this repository, however it will be broken and I cannot support non-var releases. If you want to contribute to the project, you're in the right place! Reach out to me to discuss improvements you'd like to make.

Once you have the AcidBubbles.Embody.0.var file (where 0 is the version of the plugin, the higher the better), drop it in the AddonPackages folder.

Adding Embody to a scene

Note that you can also open the scene provided in AcidBubbles.EmbodyDemo.0.var, which has a person atom, the plugin, mirrors already setup. If you need to add it manually:

  1. Add a Person atom to your scene
  2. Open the Plugins tab
  3. Add the Embody.cslist plugin from the AcidBubbles.Embody package

Activating Embody

To activate embody, you have multiple options:

  1. Open Embody's custom UI in the Plugins tab, and click on the Active toggle. It should immediately enable possession (for the VR headset and motion controllers). That's it!
  2. You can add a UIButton, and in the Triggers tab, add the Person/Embody/ToggleActive storable. That allows you to toggle Embody easily in your scene.
  3. You can also use Keybindings to map a shortcut to Embody. This can be useful since you'll be able to toggle it on any scene without having to open the UI.

To exit Embody, you can either press Esc on your keyboard, or open the menu in VR. This will immediately exit Embody.

More stuff

Vive Trackers

You have two options to map your vive trackers; you can either use the wizard, or you can use the "Align All Vive Trackers" button in the Trackers screen. If you do the wizard, you can always tweak your settings later.

If Natural Locomotion is installed, you will need to follow these instructions

Using the Wizard

There are a ton of options in Embody, but you might not have the patience to learn them all. So, I've built a nice wizard that walks you through all available options, step by step. Check out the Wizard section for more information on how to use it.

Presets

To make things quicker, there's a preset drop-down when you open Embody's UI. This allows you to quickly select a subset of modules for the purpose you need. See Home Screen, Presets for more information on available presets

Leap Motion

The Leap Motion by Ultraleap is an amazing piece of technology; you can stick it on your VR headset, and you get fingers tracking without motion controllers. It's a built-in VaM feature that's integrated into Embody. See Leap Motion for more information on how to use it.

What's next?

I hope to see great scenes taking advantage of Embody, and if you like it or publish interesting videos, please let me know!

⚠️ **GitHub.com Fallback** ⚠️