Voxta Packages
Bundle scenarios, characters, memory books, and assets together for sharing and distribution.
Packages are how you bundle related Voxta content for sharing. A package can contain scenarios, characters, memory books, and their associated assets — all in one file.
You can:
- Create resources directly inside a package in the Package screen.
- Move existing resources into a package by opening them and assigning them.
A resource can only be in one package at a time, and deleting a package deletes everything inside it. Move resources back out before deleting if you want to keep them.
Export formats
| Format | When to use |
|---|---|
.voxpkg | Default. Use this for everyday sharing of Voxta resources. Voxta imports it directly. |
.png | Use when bundling for Virt-A-Mate scenes. The package data is embedded in the PNG so VAM's Package Builder can pick it up. |
When you need a package
- You want to share a multi-resource setup. Scenario + characters + memory book → one file.
- You're shipping a VAM scene. Each character/scenario must be exportable as a Voxta resource the VAM plugin can auto-install on a fresh user's server.
- You're shipping character or scenario assets. Exporting assets requires the resource to live in a package — bare resources can't export with attached audio/images.
Workflow
Create
In Studio → Packages, click Create Package. Give it a name, version, and (optionally) a description.
Add resources
Two ways:
- From inside the package — create new scenarios, characters, or memory books that are born inside the package.
- From outside — open an existing resource, look for the "Package" field in its properties, and assign it to the target package.
Set thumbnail and metadata
When you assign a character or scenario to a package, the package's thumbnail and Explicit field are only updated when you re-open the package from Studio → Packages. So:
- Assign the resources.
- Save.
- Re-open the package from Studio → Packages.
- The thumbnail and explicit field will now be populated correctly.
- Save again.
Export
In the package view, click Export and pick .voxpkg (default) or .png (for VAM).
The exported file lives wherever your platform's standard download folder is. Move it to your sharing destination.