Settings is the last row in the Control Panel's left column, and it holds everything that is the same whichever scene is on: interface language, theme, the tray icon, audio output, rendering performance, and the Plugin API. Updates and the About dialog live in the panel header
Automations are not here but on a row of their own, just below Tracking — see Automations
The page is four collapsible sections — General, Performance, Storage and Plugin API — and each remembers whether you left it open. Storage and Plugin API start collapsed
The stage window's size, along with Stream Mode, Inspector and Show FPS Counter, is not here but under the Window section of the Stage row
General
Language
Persona ships four interface languages, each listed in the picker under its own name
| Setting | Effect |
|---|---|
| System | Follows the operating system language |
| English | Always English |
| 简体中文 | Always Simplified Chinese |
| 繁體中文 | Always Traditional Chinese |
| 日本語 | Always Japanese |
System reads the language tag the operating system reports. Chinese resolves to 繁體中文 for the Traditional variants — zh-Hant, zh-TW, zh-HK and zh-MO, matched by region because most systems report those without a Hant subtag — and to 简体中文 otherwise. Japanese matches its own. Everything else falls back to English
The change applies immediately across the whole interface, including the tray menu, with no restart
Theme
The colour scheme for the control panel, its dialogs and its menus: System, Light, or Dark. It follows the system by default and switches with the operating system's appearance
It only touches the interface. The stage is unaffected — what renders there comes from the background, the lights and the effects, independently of the interface theme
Keep Panel on Top
Floats the Control Panel above the stage and every other window, so you can watch it while clicking into the stage to arrange a scene. Off by default. It targets the panel, not the stage — see Window Behaviour
Menu Bar Icon
The switch is labelled Show Tray Icon on Windows and Show Menu Bar Icon on macOS and Linux, matching what each platform calls it
On macOS the icon is a monochrome template image, so it adapts to the menu bar like a native application — dark on a light bar, light on a dark one
Turning it off gives you a cleaner menu bar and costs you no access. The switch itself then spells out how to summon the Control Panel without it: ⌘ + , or the app menu on macOS, and on Windows and Linux, clicking the stage and pressing Ctrl + ,
Audio Output Device
Where Persona's sound plays: audio files from the Inventory and from automations, plus the sounds Live2D models make — motion sounds and speech from the Plugin API. System Default follows the system's own output, or pick a specific device
A saved device that is not connected shows as Unavailable Device. Audio playback then reports an error rather than quietly switching to the default, until you choose a device that is there
Send Bug Reports
On by default. Anonymous crash and error reports help diagnose application problems. Reports include diagnostic information and recent app events, which may contain webpage layer URLs; native crash reports may also include a memory dump
Turning it off means the reporter is never initialised at all. The setting is read at launch, so changing it raises the Restart to fully apply prompt
Performance
Background Rendering
Persona now keeps background rendering on all the time. The operating system normally throttles a window that is hidden or covered, which stops the avatar animating — the last thing you want when OBS is capturing the window and you have tabbed away from it. Persona keeps the render loop running and asks the system not to suspend the application
The former switch is gone; there is nothing to configure. This does not stop the display from sleeping according to the system settings
Limit Frame Rate
Caps both render loops — the 2D stage and the 3D one, so a VRM scene and its effects are throttled along with everything else. Useful on a high refresh rate display, where a frame cap can reduce unnecessary GPU usage
| Preset | Notes |
|---|---|
| Unlimited | Runs at the display's refresh rate, and costs more on a fast one |
| 15 fps | |
| 30 fps | For a low-end machine |
| 60 fps | The default, and what suits most streams |
| 90 fps |
There is deliberately no 120 fps preset. The throttle measures each frame in whole milliseconds, so a cap set to your display's refresh rate rounds into skipped frames — around 104 fps on a 120 Hz display, which is worse than leaving it unlimited
Effects Quality
Sets how the 3D visual effects antialias, at High, Medium or Low. Lower is faster
| Tier | Antialiasing |
|---|---|
| High | 4× MSAA — the default |
| Medium | FXAA, one full-screen edge pass |
| Low | None |
It costs nothing in a scene with every effect off
Render Scale
How large a canvas the 3D stage draws into, at 100%, 85%, 75%, 66% or 50%, defaulting to 100%. It multiplies the device pixel ratio, so the pixel dimensions also depend on your display scaling
Lowering the render scale reduces the pixels processed throughout the effects chain, which can improve frame rate. The tradeoff is a softer image, especially around avatar edges and fine patterns
It only touches what the stage draws, Live2D models and 2D images and videos included. A 2D webpage is a separate DOM layer and is unaffected
Storage
Settings, scenes and API keys all live in one folder, ~/.laplace/persona. Open Folder reveals it in your file manager
Backing up, moving and restoring are all copies or replacements of that folder. Quit Persona first — while it runs it writes its own state back, over whatever you just put there
| File | Holds |
|---|---|
settings.json | Application settings, the asset allowlist, and plugin folders |
scenes.json | All of your scenes |
credentials.json | API keys, readable by you only |
plugin-storage.json | What plugins stored over the API, readable by you only |
logs/ | The diagnostic log, which stays on this machine |
settings.json and scenes.json each link their JSON Schema (settings, scenes), so an editor such as VS Code can check them as you type
These files record the folder paths of your models and assets, which usually contain your user name, and your keys are in there too. Treat the whole folder as personal, not as something to post publicly
Open Logs reveals logs/ in that same folder. Persona always writes errors and warnings to main.log, with nothing to switch on: the file never leaves your computer, and Send Bug Reports is the only path over the network. Attach it when you report a problem. At 2 MB it rotates into a timestamped archive, and the five newest are kept
Plugin API
The rest of Settings enables and configures the local WebSocket server other applications drive — the port, local network access, API keys, plugin folders and the list of connected clients. It has its own page: Plugin API
First Run
The first time you open Persona, a three-step walkthrough sits over the Control Panel: a welcome, whether to Send Bug Reports, and a closing page. The bug-report step lists what a report carries and what it never does, and Learn more about privacy below it opens Privacy and Security in your system browser. Finish on the last page writes that choice to your settings, along with the mark that says you have been through it
Only that first run refuses Esc and a click outside, so it is seen exactly once. Onboarding… on the panel header's menu opens it again whenever you like; that time it is an ordinary dialog you can dismiss, and every opening reads the settings as they stand
An install upgraded from an earlier version sees it once too — the mark defaults to off and is never pre-set for a settings file that predates it
About
The panel header's menu also carries Documentation, Web Console and Onboarding… — the first two open these docs and the web console in your system browser, the last reopens the first-run walkthrough
About LAPLACE Persona — in the panel header's menu, the tray menu, and the application menu on macOS — shows the version, Credits with everyone who worked on it listed by role, Thanks To with the people the project thanks, and the third-party notices for everything bundled in the build: the Live2D Cubism Core, the bundled models, the VRM animation and idle animation packs with their required credits, the bundled environment map and model, the interface font, and the wLipSync library and voice profile behind lip sync. A closing Special Thanks follows the notices
Updates
The version number sits in the top-right of the panel header. It is also the update control
Persona checks once, quietly, about ten seconds after launch, and again whenever you click the version row. Installer downloads begin only after you confirm an update
| Version row | Meaning |
|---|---|
| Plain text | This install cannot update itself — see below |
| Version only | Idle. Click to check for updates |
| Spinner | A check or a download is in progress |
| Upward arrow | An update is available. Click to open the dialog |
| Refresh arrow | An update is downloaded and waiting to install |
| Warning glyph | The download failed. Click to retry |
The Update Flow
- Check — click the version row. If you are current, a toast says so. If not, the update dialog opens
- Choose — Update starts the download, Later dismisses, Skip This Version silences automatic checks for that version. A skipped version still appears if you click the version row yourself
- Download — progress shows in the dialog. Persona stays usable, and closing the dialog does not stop the download
- Install — Relaunch Now applies it immediately. Otherwise it installs the next time you quit
Windows .msi installs cannot update themselves — the updater would create a
duplicate installation rather than replacing the existing one. The version row
shows plain text with no check action. The .msi is no longer published and
Windows ships the NSIS installer (.exe) only; if you installed from .msi,
reinstalling from the .exe restores automatic updates
Persona initiates two types of outbound requests: update checks, and crash reports while Send Bug Reports is on. Checks go to downloads.vrp.moe and carry no identifying information beyond what any file download involves. That switch turns off bug reports; the current installer has no setting to disable update checks, so blocking the host is the only way to prevent them
Last updated on September 20, 2026