The official LAPLACE Persona plugin for Elgato Stream Deck maps the Plugin API to hardware keys: switch models, activate scenes, apply scene presets, trigger hotkeys, run automations, toggle expressions, play motions, set dynamic text, and adjust avatar position and scale on stage.
It uses the same underlying API as the Web Console. Enable the API and generate an API key in the desktop app to connect.
Prerequisites
| Requirement | Description |
|---|---|
| Stream Deck | Version 7.1 or later, running on macOS 12+ or Windows 10+ |
| LAPLACE Persona | Running, with Plugin API enabled |
| API Key | Generated under Settings → Plugin API |
Installation
Click the install button above to install the plugin through the Stream Deck app, or search for "LAPLACE Persona" in the built-in Stream Deck Marketplace. Once installed, a LAPLACE Persona category appears in the action list.
Connection
Drag any Persona action onto a key. The bottom of the property inspector provides two configuration fields:
| Field | Description |
|---|---|
| Persona Address | Defaults to 127.0.0.1:25034 when empty; accepts host, host:port, or a full ws:// URL |
| API Key | The API key token generated in Persona |
Both settings are global: configuring them once on any action applies them across all actions.
Once connected, Persona lists Elgato Stream Deck (developer: LAPLACE) under Connected Clients.
To control Persona on another machine, enable Allow Access on Local
Network on the target device and specify its host:port in the address
field. Persona communicates over plain ws:// (without built-in TLS). On
untrusted networks, place a reverse proxy with TLS in front of Persona and
enter the full wss:// proxy URL.
Actions
Actions target the scene's primary model, except Activate Scene, Apply Preset, Run Automation, Trigger Hotkey (which targets the shortcut's own model), and Set Text (which targets a chosen text layer).
| Action | Description |
|---|---|
| Switch Model | Switches the primary avatar to the selected model, or adds it if no model exists in the scene |
| Activate Scene | Loads and applies a saved scene |
| Apply Preset | Moves the current scene's layers to a saved scene preset; the key shows an error if the current scene lacks that preset |
| Trigger Hotkey | Runs a shortcut on any on-stage model; the dropdown groups hotkeys by model with the primary model first |
| Run Automation | Runs an automation workflow without needing a keyboard shortcut |
| Toggle Expression | Toggles a specific expression on the active model |
| Play Motion | Plays a specific motion on the active model; pressing again while playing stops it immediately |
| Move Model | Nudges the avatar position in the chosen direction; hold to repeat continuously |
| Scale Model | Scales the avatar up or down; hold to repeat continuously |
| Reset Transform | Restores the avatar position, scale, and rotation to default values |
| Set Text | Updates the text of a chosen text layer; applies temporarily unless Save to Scene is checked |
Dropdown options for models, scenes, presets, hotkeys, automations, expressions, and motions are loaded live from the running Persona app (presets come from the current scene). While the property inspector is open, the automation list updates as changes are made, with paused automations shown in gray. When disconnected, dropdowns show the connection status instead of an empty list.
Run Automation lets you trigger multi-step stage changes from a single key: build the automation in Persona without assigning a keyboard shortcut, then run it directly from Stream Deck.
Moving and Scaling
Move and scale actions support custom step sizes. Holding a key starts repeating after about 300 ms, stepping every 100 ms after that. If an error occurs, repeating stops immediately and the key flashes an alert icon.
| Action | Parameters |
|---|---|
| Move Model | Direction (up, down, left, right), 2D Step (pixels), and 3D Step (world units) |
| Scale Model | Direction (increase, decrease) and Factor (scale multiplier, defaults to 1.1) |
The 2D and 3D step values apply to Live2D screen space and VRM world space respectively, so a single key works with both model formats. Scaling is clamped to safe bounds so holding the key cannot scale a model past its limits. If Factor is less than 1, scaling always reduces size by that ratio regardless of direction.
Key Display and Feedback
Key icons combine the Persona logo with the action symbol, and action titles follow the Stream Deck app's language. Custom titles are drawn above the default icon, and custom images replace the default icon completely.
Successful actions briefly show a checkmark, while failures show an alert icon and log a message in the plugin logs. Holding a key suppresses the checkmark so the key doesn't flicker while repeating.
The plugin interface is localized in English and Simplified Chinese, following the Stream Deck app's language setting. Property inspector field names are shown in English.
Last updated on November 3, 2026