Vfinityv1.5.0
Reference

Files and backups

What a backup file contains, which versions restore, and what is stored outside it.

Vfinity keeps its configuration on your machine. A backup packs it into one file you can move or archive.

What a backup contains

IncludedNotes
SettingsConnection details, ports, preferences
Event mappingsThe whole Events list, enabled and disabled
Throwing sceneBody parts, calibration, gift mappings, physics
ThemesBoth the built-in choice and any of your own
Stats and pointsAll-time records and balances
VTube Studio tokenOnly if you tick Include the VTube Studio token

What it does not contain

  • Uploaded images: the throwing reference image and overlay assets live in the app's local storage
  • Your OBS scenes and browser sources, which live in OBS
  • Anything on the TikTok or VTube Studio side

Overlay URLs point at 127.0.0.1, which means the machine OBS runs on, so they are set up per machine rather than carried in a backup.

Format versions

The current format is version 6. Vfinity restores versions 1 through 5 as well, filling in defaults for anything a newer feature needs.

VersionAdded
6Stats and economy settings
1 to 5Earlier shapes, all still restorable

The VTube Studio token

Include the VTube Studio token is off by default and marked SENSITIVE.

The token lets a restored backup connect to VTube Studio without asking you to approve the plugin again. Anyone holding that file can control your VTube Studio plugin. Do not share a backup that includes it, and do not upload one anywhere public.

Everything else restores without it. VTube Studio simply asks for approval once more.

Values are repaired on load

Numbers are range-checked when settings load, so a hand-edited file or an old backup with an out-of-range value heals rather than driving the physics engine with it. A cleared number field does not become 0, and a burst cap of 0 does not silently mean 50.