Installing the Virt-A-Mate Plugin

You’ll need the Voxta Server first. Make sure it’s working, and that you’re able to chat with characters.

You’ll also need to install the Voxta Virt-A-Mate Plugin (AcidBubbles.Voxta.VERSION.var) by downloading it into your Virt-A-Mate’s AddonPackages folder. You can currently get it from our Discord by subscribing to Patreon.

Configuring Virt-A-Mate

Permissions

You’ll need to allow a few things before the plugin can run.

Before launching vam, open whitelist_domains.json in the root of Virt-A-Mate’s folder. This is required to allow playing speech from the Voxta server:

{
  "sites": [
    // Add this line below (not this comment):
    "127.0.0.1:5384",
    // Leave the rest as is
  ]
}

You can now launch Virt-A-Mate, open the main menu and go to User Preferences. From there, go to the Security tab. You need to enable:

  • Enable Plugins (for Voxta itself)

    • Allow Plugins Network Access (To allow Voxta to connect to the server)
  • Enable Web Images and Audio (To allow playing audio from the server)

  • Enable Package Downloader (optional, if you want to use the demo scene dependencies)

  • Enable Hub (optional, if you want to auto-download demo scene dependencies)

Using Voxta in Virt-A-Mate

Using a demo scenes

If you download a scene that uses Voxta, and the previous steps are done correctly, you can simply open the scene and it should work. You can validate that the plugin is running by opening the plugin’s custom UI (go in Edit mode, select the Person atom, go to Plugins, find Voxta, click on Open Custom UI), and you should see “Connected”. If you have a character selected, the State should be idle.

Adding to an existing or a new scene

See Adding Voxta to a Virt-A-Mate scene.