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, rendering performance, and the Plugin API. Updates and the About dialog live in the panel header
Shortcuts are not here but on a row of their own, just below Tracking — see Shortcuts
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, Show FPS Counter and Selection Outline, 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 + ,
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 |
| 15 fps | |
| 30 fps | |
| 60 fps | Default |
| 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 and the selection outline 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 the 3D stage. 2D objects, and Live2D on the legacy engine, are drawn on a separate 2D canvas and are unaffected
Use Legacy WebGL Engine
Off by default. Turning it on moves Live2D from the default WebGPU engine back to the legacy WebGL engine, outside the 3D stage and its effects chain. It is lighter on resources for one simple model; switching reloads the scene
With it on, a Live2D-only scene can no longer add effects, and the Look section disappears. See Rendering Engines
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 |
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
Upgrading from an earlier version moves settings out of the application data directory on first launch, leaving the old files where they are
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, the Live2D renderer (WebGPU or WebGL (Legacy)), and whether to Send Bug Reports — Learn more about privacy below that step opens Privacy and Security in your system browser. Finish writes both choices 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 and the third-party notices for everything bundled in the build: the Live2D Cubism Core and sample models, the VRM avatars, the VRM animation and idle animation packs with their required credits, and the interface font
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 9, 2026