Skip to content

3D Settings ​

Settings → 3D has five tabs: Display, Performance, Models, Animations, and Emotes. The Models tab has an Avatars section and, on supported native surfaces, a Stages section. Together they cover the Live Assistant's visual assets and display settings.

Display ​

Portrait mode crops the view to upper-body framing. Use Clipping Height to adjust how much of the body is visible. Lower values show more. Higher values crop tighter. You can switch portrait mode on and off without reloading the avatar.

Avatar Shadow is on by default. With No Stage, VAssist renders a soft avatar silhouette behind the character in both 2D and 3D camera modes. It follows the avatar and camera instead of sitting on a ground plane. With a stage active, the same toggle controls the stage's real 3D cast shadow, so it falls onto the environment and moves with its light. Turn this off to hide the avatar shadow.

Character Position controls where the Live Assistant sits on screen (web and extension builds). Set it to Last Location and the position you drag it to is remembered across reloads. Switch it to any preset to snap it back.

ControlDefaultBehavior
Enable AvatarOnTurns the Live Assistant on or off. When off, the app falls back to chat-only mode.
Avatar ShadowOnShow a translucent shadow behind the avatar, or cast shadows onto a loaded Stage.
Reload Avatar-Only when avatar is on. Reloads the scene immediately.
Portrait ModeOffOnly when avatar is on. Switches to tighter upper-body framing.
Clipping HeightModel presetOnly when Portrait Mode is on. Lower values show more body. Higher values crop more aggressively.
Character PositionRuntime presetOnly on web/extension runtimes. Preset placements including Last Location.

Sticker border ​

In Display, the Sticker Border toggle adds a separate outline around the avatar silhouette without changing the model's MMD material outline. It is off by default. When enabled, tune its color, width (1–16 px), edge quality (1–8 samples), and occlusion settings. A wider border or higher edge quality can add GPU work.

The embed host can set initial values with ui.stickerBorder. The same controls remain available in the 3D settings UI unless the host hides or locks that settings area.

Performance ​

If the Live Assistant runs slowly or drops frames, work through this list in order. Each step has a bigger impact than the next:

  1. Render Quality → drop to Low. This is usually the biggest single win.
  2. Frame Rate Limit → cap at 30 FPS. The Live Assistant still looks smooth at 30.
  3. Physics Simulation → turn off. Hair and cloth physics are expensive.
  4. If you're on Custom quality: drop Anti-Aliasing (MSAA) to 1x and turn off Bloom Effect.
ControlDefaultBehavior
Physics SimulationOnEnables hair and cloth physics reactions.
Physics EngineBulletBullet Physics (Recommended) or Havok Physics. Only when Physics is on.
Frame Rate Limit60 FPS15, 24, 30, 60, 90, 120, 144, or Native. Native warns about high-refresh monitors.
Render QualityMediumLow, Medium, High, Ultra, or Custom.

Render quality presets ​

PresetEffect
LowMinimal effects, highest performance
MediumBalanced quality, subtle bloom
HighBetter edges and soft glow
UltraStrongest built-in quality with full anti-aliasing
CustomExposes every post-processing control individually

Custom quality controls ​

Expand custom quality controls
ControlDefaultBehavior
Anti-Aliasing (MSAA)2x1x, 2x, 4x, or 8x. Higher values cost more GPU.
FXAAOnFast anti-aliasing without MSAA overhead.
Bloom EffectOnGlow on bright areas. Turning it off hides all bloom sliders.
Bloom Threshold0.9How bright an area needs to be to bloom.
Bloom Intensity0.2Bloom strength.
Bloom Scale0.5Bloom contribution scale.
Bloom Kernel Size3216, 32, 48, or 64 for tighter or wider glow.
Contrast1.2Final image contrast.
Exposure1.05Final image brightness.
Saturation15Color richness, -50 to 50.
Reset to Defaults-Restores all custom-quality controls to the values above.

Models ​

Manages character models and stages together.

Stage selection uses compact rendered previews. Turn Stages on, then choose a preview. Open Stage options for the stage's supported controls. Turn the toggle off to use your saved background again. The same editor is available in UI > Display on supported native surfaces and in the setup wizard when the avatar is enabled. Custom stage import, rename, and deletion are under Custom stages.

Adding a custom avatar ​

Models must be packaged as a ZIP file. The ZIP must contain the .pmx file plus every texture image it references. The PMX file embeds relative paths to its textures, so those textures need to exist at the same relative paths inside the ZIP. Standard MMD model packages already have this structure. If you downloaded an MMD model, zip the whole folder as-is.

Typical ZIP structure:

MyModel.pmx
tex/
  body.png
  face.png
  hair.png

If textures are missing from the ZIP the import will still succeed but the model will render with gray or transparent surfaces where textures should be.

  1. Hit Upload PMX Model (ZIP) and select your file.
  2. Wait for the import. If something is wrong with the package, an error panel will tell you what's missing.
  3. Find the new model in the list, toggle it as default.
  4. Go back to Display and hit Reload Avatar (or use the Reload button in the Live Assistant controls).

The built-in VAssist Default model is always available as a fallback. It stays in the list even when a custom model is active.

To control which parts of a model are visible (hide accessories, swap textures, etc.), expand the model's settings chevron. Textures and mesh parts are each listed individually with toggles.

Character models ​

ControlBehavior
Upload PMX Model (ZIP)Import a zipped PMX package. Shows progress and an error panel if parsing fails.
VAssist DefaultBuilt-in model. Active when no custom model is set as default.
Settings chevronExpands texture and mesh-part toggles for that model.
Texture buttonsToggle individual textures on/off, grouped by type.
Mesh part buttonsToggle individual mesh parts on/off, grouped by category.
Custom model rowShows name and file size. Supports rename, delete, and default toggle.

Stages ​

Stages are available in Desktop App and Wallpaper modes, and in the Android app and live wallpaper. Floating desktop windows, the web app, extension, and browser integrations do not load stages or show stage controls. Android AR hides both the selected stage and the configured background while the camera view is active. They return when you leave AR.

On a fresh setup, no built-in stage is selected. Turn on Stages and choose one of six studio environments, Aster Observatory, Moss House, or Rainlight Library. Select No Stage to use your background settings instead. Your background selection remains saved when you switch to a stage. If you already have a custom stage saved as the default, it can load until you select No Stage.

Built-in stage previews ​

These previews show the six quiet studio stages and the three furnished environments.

Ink stage with a dark starry sky
Ink
Paper stage with a warm light studio
Paper
Slate stage with a circular stone plinth
Slate
Dusk stage under a violet twilight sky
Dusk
Stillwater stage with a blue rippling surface
Stillwater
Pebble stage with a rounded sandstone base
Pebble
Aster Observatory stage with a planetarium and orbital display
Aster Observatory
Moss House garden room with a window and plants
Moss House
Rainlight Library with warm lamps, bookshelves, and a rainy window
Rainlight Library

The six quiet stages have distinct palettes: Ink (near-black seamless studio), Paper (light studio), Slate (cool stone plinth), Dusk (violet horizon), Stillwater (deep blue rippling water), and Pebble (warm sandstone base). They follow local time, darken at night, and use subtle stars in dark skies. Ink keeps faint stars by day. Paper stays seamless.

Use Stage options and select Apply in Settings. The Live Assistant's stage button has compact controls that preview and save immediately. Its clock opens a dial that saves and closes on release.

ControlWhat it does
SeasonFollows the local calendar or selects spring, summer, autumn, or winter. Seasonal palettes apply across built-in stages. Effects are petals, pollen, leaves, or snow.
Seasonal effectsToggles particles independently of environment animation. Moss House and Rainlight Library keep weather outdoors. Aster Observatory has seasonal lighting without weather particles.
Environment brightnessAdjusts exposure for the stage and avatar. The setting is saved per stage.
Lighting and MoodAll built-in stages follow local time or allow manual time on a 00:00–24:00 slider in 15-minute steps. Aster Observatory and Rainlight Library also have named Mood presets. Lighting affects stage lights and supported sky and shadow direction.
Animate environmentToggles supported motion such as stars, water ripples, planetary rotation, rain, and fire.
Avatar ShadowToggles the stage-cast shadow. With No Stage, it shows the avatar shadow behind the model.
Avatar height / floor adjustmentCalibrates room scale and foot contact per avatar without resizing its physics rig. Existing PMX stages keep their placement.

Portrait mode keeps the room intact and frames the avatar's upper body.

Importing a stage ​

Use Import to choose a self-contained GLB, a Babylon scene with embedded textures, or a PMX stage ZIP. PMX ZIPs need the stage file and its texture images at their correct relative paths. GLB and Babylon imports cannot depend on separate files that were not included in the import.

Custom stages support selection, renaming, and deletion. Existing imported PMX stages remain available. See the environment art credits for the included assets.

Animations ​

Combines the motion library with the category-based playback manager. Imported motions don't play until you assign them to at least one animation category.

Importing motions and assigning categories ​

VMD files do not need to be zipped. Select the .vmd files directly. You can pick multiple files in one go.

  1. Hit Upload VMD Animations and pick one or more .vmd files. You can import multiple at once.
  2. After upload, find a motion in the list and expand its category chevron.
  3. Toggle on the animation categories this motion should be used in: idle, thinking, celebrating, walking, or talking.

You can assign the same motion to multiple categories. The Live Assistant randomly picks from all enabled motions in a category, so adding more variety means more natural-looking behavior. The default built-in animations stay as a baseline. VAssist won't let you disable the last remaining motion in any category.

The Animation Management section below the library lets you enable or disable individual built-in and custom motions per category without re-importing them.

Motion library ​

ControlBehavior
Upload VMD AnimationsImport one or more VMD files at once.
Motion rowName, size, rename, delete.
Category chevronOpens per-motion category assignment.
Animation CategoriesAssign a motion to idle, thinking, celebrating, walking, or talking.

Animation management ​

One category section per bucket: idle, thinking, celebrating, walking, talking.

Section elementBehavior
Category headerShows enabled counts for built-in and custom animations.
Default AnimationsEnable or disable built-in animations in that category.
Custom AnimationsEnable or disable imported motions assigned to that category.
Last-enabled protectionThe toggle disables itself if turning it off would leave the category empty.

Emotes ​

Emotes are named, triggerable reactions. Each one plays a sound, runs a VMD motion on the avatar, and optionally moves the camera. You trigger them from the live emote panel in the Live Assistant controls.

Creating an emote ​

You need at least an audio file and a VMD motion file. Camera data is optional but adds a cinematic touch.

  1. Give the emote a name. This is how it shows up in the panel.
  2. Optionally add categories (comma-separated tags) to group related emotes together in the filter.
  3. Upload the audio file.
  4. Upload the motion VMD file.
  5. Optionally upload a camera VMD file.
  6. Hit Upload Emote.

To import many emotes at once from a collection, use Import ZIP Package instead of creating them one by one.

Once an emote is in the library:

  • Use category filter to find it by tag
  • Toggle visibility to hide an emote from the panel without deleting it. Useful for keeping a library clean without losing assets
  • Open the category chevron to set it as an auto-play emote in one of the animation states (general, idle, thinking, celebrating, walking, talking). The Live Assistant will play it automatically during that state

Emote creation controls ​

ControlBehavior
Emote NameRequired.
CategoriesComma-separated custom category tags.
Import ZIP PackageBulk-imports multiple emotes from a ZIP archive.
Upload AudioAudio source for the emote.
Upload MotionVMD motion file.
Upload CameraOptional VMD camera animation.
Upload EmoteStarts creation and shows success or error feedback.

Emote library ​

ControlBehavior
Category filterFilter list to all or a specific category.
Delete filteredDelete every emote in the current filter scope.
Emote rowRename, delete, or toggle visibility.
Visibility toggleHides/shows the emote in the emote panel without deleting it.
Category chevronOpens auto-play category assignment.
Auto-play Categoriesgeneral, idle, thinking, celebrating, walking, or talking.