Voxta docs

Packages

Bundle scenarios, characters, memory books and assets into one shareable file.

A content package bundles related resources into a single file: scenarios, characters, memory books, collections, and the assets they use.

A resource belongs to one package at a time, and deleting a package deletes everything in it. Move resources out first if you want to keep them.

When you need one

  • Sharing a multi-resource setup. Scenario + characters + memory book, one file.
  • Shipping assets. Images, audio and animations only travel inside a package — a bare resource exports without them.
  • Shipping a VAM scene, where the plugin auto-installs the resources on a fresh server.

Building one

Create a package from Studio → Packages, and give it a name, version, creator and description.

Add resources either way round: create them from inside the package, or open an existing resource and set its Package field.

Pick a thumbnail on the Overview tab.

Overview fields

FieldWhat it does
Name, version, creator, descriptionPackage identity, shown wherever it's listed.
ThumbnailThe image representing the package.
FolderWhere it sits in your library.
App-controlledLets the app overwrite this package when an update is available.
LockedBlocks all modification to the package and its resources.

Export

.voxpak is the format to share. It is what the Download button produces, and the only one that handles everything a package can hold.

A .voxpak is a real container, not an archive Voxta unpacks on import: resources serve their assets straight out of the pack. A twenty-gigabyte package costs nothing to import and never lands on disk as loose files. It is also the only format that can be encrypted or carry protected assets.

The other formats are for specific jobs:

FormatWhen to use
.voxpakEverything. The default, and the one to hand someone.
.pngVirt-A-Mate scenes — the data rides inside the image so VAM's Package Builder picks it up. Needs a package thumbnail.
.zipInspecting or hand-editing the contents as plain files. Not a distribution format.

.voxpkg and .vxz are the older zip-based packages. Voxta still imports them; nothing produces them any more.

Publish

Publish makes a .voxpak like the download does, with two differences:

  • Its assets are protected — whoever imports it can use them, but can't export or copy them back out.
  • The package is encrypted, so its contents aren't sitting in a folder as loose files.

Use it for content you're licensed to embed but not redistribute. Your own copy is untouched and stays editable. A protected package can only leave as a .voxpak; PNG and ZIP export are disabled for it.

With a Cloud Storage service configured, Save to Cloud Storage uploads the pack instead of downloading it.

What's next

On this page