Persona

Settings sits at the bottom of the left column in the Control Panel and holds global preferences that don't depend on any scene: interface language, theme, system tray/menu bar icons, audio output, rendering performance, and the Plugin API. Version details, the About dialog, and update controls are in the panel title bar.

Settings has five collapsible sections, and each one remembers whether you left it expanded or collapsed:

Automations are not part of Settings; they have their own entry below Tracking (see Automations).

The stage window's size, Stream Mode, Inspector, and Show FPS Counter are set under Stage → Window, not here.

GeneralCopy Anchor Link

LanguageCopy Anchor Link

Persona includes four built-in interface languages, listed in the picker using their native localized titles:

System reads the language tag reported by the operating system:

Many systems omit the Hant script subtag, so Traditional variants are usually matched by region code.

Language modifications take effect immediately across all surfaces, including native system tray menus, without requiring an application restart.

ThemeCopy Anchor Link

Controls the color palette across the control panel, modal dialogs, and popover menus, offering System, Light, and Dark modes. The default System setting tracks operating system appearance changes automatically.

Theme preferences apply strictly to the UI management surfaces. The stage canvas renders independently based on Background, Lighting, and Effects parameters.

Font SizeCopy Anchor Link

Adjusts the base text size of the Control Panel, from 11 to 18 px (default 12 px). Text, spacing, and control sizes scale together, and the window's minimum width and two-column split follow; the title bar keeps its size. The setting applies to the Control Panel only, not the stage window.

Saved ColorsCopy Anchor Link

Color pickers support saving and reusing up to 100 custom colors; the swatch grid scrolls once it outgrows the popover. After choosing or sampling a color in any color picker popover, clicking the Save Color button (+) adds it to the saved palette; right-clicking a saved swatch removes it. Saved colors persist globally across the entire application and across scenes.

A saved color keeps its opacity. Translucent colors appear only in pickers that take opacity (such as the background color, whose swatches also start with three built-in presets that can't be removed); other pickers list only opaque colors.

Keep Panel on TopCopy Anchor Link

Pins the Control Panel as a floating window above the stage viewport and other desktop applications, allowing continuous parameter tuning while interacting directly with on-stage objects. This toggle is disabled by default. It governs the control panel window exclusively (for stage window layering, see Window Behaviour).

Menu Bar IconCopy Anchor Link

This switch is labelled Show Tray Icon on Windows and Show Menu Bar Icon on macOS and Linux, adhering to native platform conventions.

On macOS, the status icon uses a monochrome template image that natively adapts to dark and light menu bar appearances.

Disabling this setting clears status bar clutter without eliminating access. The helper text beneath the switch outlines alternative shortcuts to summon the Control Panel: press ⌘ + , or use the application menu on macOS; click the stage viewport and press Ctrl + , on Windows and Linux.

Audio Output DeviceCopy Anchor Link

Designates the hardware audio endpoint for all Persona playback streams, including audio files triggered from the Inventory or automations, video layer audio, as well as Live2D motion sound effects and speech from the Plugin API. Choosing System Default follows the operating system's global default output device; selecting a specific endpoint binds playback directly to that hardware.

If a saved device becomes disconnected, the inspector displays it as Unavailable Device. Attempted audio playback produces an explicit error rather than silently routing through an unexpected fallback device until a valid active endpoint is selected.

Send Bug ReportsCopy Anchor Link

Enabled by default. Transmits anonymous crash traces and unhandled runtime exceptions to assist the development team in diagnosing stability issues. Reports include diagnostic system parameters and recent application lifecycle events (which may include URLs loaded into webpage layers); native crash dumps may also include minidump memory state.

Disabling this toggle prevents the diagnostic telemetry reporter from initializing. Because this setting is evaluated during cold launch, toggling it surfaces a Restart to fully apply notification.

PerformanceCopy Anchor Link

Manage GPU workload and rendering pipeline throughput, including foreground frame rate caps, background energy-saving throttles and pause behavior, viewport render resolution scaling, and full-screen effect antialiasing quality; see Performance.

StorageCopy Anchor Link

Manage Persona's local directory layout on disk, including file paths for application settings and scenes, automatic rolling backup policies, and viewing or cleaning runtime diagnostic logs; see Storage.

Plugin APICopy Anchor Link

The Plugin API section at the bottom of the pane configures the local WebSocket service enabling external integration and programmatic control. This covers port allocation, local network bridging, API key generation, plugin directory paths, and active client sessions. While Stream Mode is active, configured plugin directory paths are masked with a blur filter (revealed on hover) to prevent accidental disclosure of local filesystem paths and usernames during broadcasts. Comprehensive specifications are documented under Plugin API.

Cubism EditorCopy Anchor Link

The Cubism Editor section connects to Live2D Cubism Editor's External Application Integration interface, streaming real-time parameter values from a Live2D model on stage into the model open in the Editor. This allows riggers to preview physics simulations and deformer behavior driven by live tracking data in the Editor's physics window. When the Editor exports a model, Persona can automatically reload the corresponding model on stage. See Cubism Editor Link.

First RunCopy Anchor Link

When opening Persona for the first time, a three-step modal wizard overlays the Control Panel: welcoming the user, requesting authorization for Send Bug Reports, and displaying a setup confirmation. The error reporting screen outlines included parameters alongside excluded sensitive data, with a link to Learn more about privacy opening the complete Privacy and Security policy in the system browser. Clicking Finish on the final page commits the user's choices and writes the completion flag to global settings.

During the initial launch only, the wizard rejects dismissal via the Esc key or outside clicks to ensure mandatory onboarding visibility. Users can revisit this walkthrough at any time by selecting Onboarding… from the panel header menu; subsequent invocations function as standard dismissible modals that load current configuration values dynamically.

Upgrading from legacy versions triggers the walkthrough once, as pre-existing configurations lacking this key default to an incomplete onboarding state.

AboutCopy Anchor Link

The title bar menu hosts global items: Documentation, Web Console, Check for Updates…, and Onboarding…. The first two navigate to this documentation suite and the web console in the default desktop browser, while the last relaunches the First Run onboarding flow.

About LAPLACE Persona opens the About window. It is in the panel header menu, the system tray menu, and the macOS application menu. The window shows the build version, Credits grouped by role, and the project's Thanks To list, followed by open-source license notices for every bundled third-party component:

• Live2D Cubism Core
• Default 3D models
• Bundled VRM motion and idle animation assets
• Environment skyboxes and stage models
• UI typography
• The wLipSync library and acoustic profiles behind lip sync

The notices end with a Special Thanks acknowledgment.

UpdatesCopy Anchor Link

Check for Updates… is accessible from the panel header menu as well as the macOS application menu, allowing manual update checks at any time. Persona also executes an automated background check approximately 10 seconds after launch.

When a new version is detected, a version badge (e.g. v0.59.0) appears in the upper-right corner of the panel header; click it to open the update details dialog. When the app is up to date, the title bar remains clean and displays no badge.

Installation packages download only after explicit user confirmation. The badge glyph mirrors the active update phase:

The Update FlowCopy Anchor Link

1. Check for Updates: Select Check for Updates… from the header menu. If you are on the latest release, a status toast confirms it; otherwise, the update dialog opens (and the new version badge appears in the header).
2. Choose Action: Click Update to start downloading, Later to close the dialog, or Skip This Version to silence automatic notifications for that release (checking manually from the menu still lets you install a skipped version).
3. Download: Download progress and transfer speed appear in the dialog. Persona stays usable while downloading, and closing the dialog does not interrupt the download.
4. Install: Click Relaunch Now to apply the update right away; otherwise, the update installs automatically the next time you quit Persona.

Persona initiates only two categories of outbound network traffic: HTTPS version queries and crash reports when Send Bug Reports is enabled. Version queries target downloads.vrp.moe and transmit standard file download HTTP headers without user identity telemetry. Crash reporting can be completely disabled via its preference switch; because automated update checks cannot be disabled within the UI, blocking the host domain via local DNS or firewall rules is required to silence update traffic entirely.