Eng 繁中 日本語 한국어 简中

Actor Presets

Actor presets save a snapshot of an actor’s settings — physics, materials, dressing, motion preferences — so you can reapply the same configuration to the same model later, or to a different model with a similar build.

Added in 2024.1. Stored under presets/ in the content library, which means presets can be shared between users on the same DanceXR version.

What a preset contains

A typical actor preset captures:

What is not in the preset:

  • The model file itself (presets reference settings, not assets).
  • System-wide settings — those live in System presets.
  • Scene composition (stage, lighting, camera) — that lives in a scene.

Saving and loading

  1. Configure an actor the way you want.
  2. Open the actor menu, then the Tools menu (wrench-and-hammer icon).
  3. Save preset; give it a name.
  4. To apply, open the same Tools menu on any actor and select a saved preset by name.

Presets are saved under presets/ in the content library. You can copy preset files between machines.

When a preset is reusable across models

A preset is most reliable when applied to:

  • The same model you saved it from.
  • A closely related model (same source character, same skeleton).
  • A same-format model with similar build (PMX-to-PMX, similar bone naming).

Across very different models, settings that depend on bone names — XPS physics rigs, bone mapper overrides — may not transfer cleanly.

System presets

System Presets save scene-wide settings (lighting, environment, camera, graphics) instead of per-actor settings. The save and apply flow is similar; system presets are stored separately.