Actor Options

Settings that control how actor models are loaded and replaced.

Caching

Models are kept in an in-memory cache after first load so switching between actors is near-instant. Cache Size sets how many models are held at once — increase it if you switch frequently, lower it to reduce RAM use.

Texture Compression

Enabling Compress Textures converts textures to a GPU-compressed format on load. This reduces VRAM significantly for complex models but may introduce minor quality loss on some materials.

Transition

Controls transition effects when adding, removing or replacing actor models.

Auto Actor Change

When multiple models are in cache, the value of Auto Actor Change will automatically switch between them at runtime.

With the auto update enabled for this value you can achieve automatic actor switching from music progress or any other data source you choose.

Sub-Components

Transition Effect

Reusable transition effect applied when actors or other optional

meshes are added, removed, or replaced. The effect dissolves the

mesh along a moving edge with optional particles, color, and

glow — a single configuration drives both the shader-side burn

and the VFX spawn.

Edge Shape

Direction picks whether the edge sweeps Up or Down the

mesh. V Shape bends the edge from a flat horizontal line

(0) into an angled V — useful for less mechanical-looking

dissolves. Transition Mode selects the pattern that breaks

up the edge: Cells for a chunky cellular look, Mosaic for

square tiling, Noise for a soft organic dissolve. Scale

resizes that pattern (logarithmic) and Width widens the

band the dissolve spans, from a sharp line to a diffuse fade.

Color and Glow

Color is the burn color drawn at the leading edge of the

dissolve. Glow boosts that edge to an emissive intensity

so it reads as a hot burn rather than a tint. Blend

controls how much that burn color overrides the mesh’s own

color in the transition band — drop it to keep the original

material visible through the effect.

Duration and Particles

Transition Duration is an on/off float — toggle it on to

use a custom duration, off to fall back to the system default.

On Quest builds the transition is force-disabled regardless.

Particle Effect sets the spawn rate (logarithmic — 0

disables particles entirely) and Particle Duration sets

how long they live. If particle duration exceeds the

transition duration, the transition is stretched to match so

particles do not get cut off mid-air.

Configurations