labelplate
Overrides the speaker nameplate on a panel. Same dictionary may appear as node field labelplate.
{
"type": "labelplate",
"panel_id": "main",
"text": "???",
"style_key": "default",
"apply": "persistent"
}
Usually you need
| Field | Type | Default | Effect |
|---|---|---|---|
text / text_key | string | — | Plate body ({@auto} expands to speaker) |
style_key | string | — | Theme labelplate.<key> |
visible | bool | — | Show / hide |
apply | "persistent" | "node_local" | "persistent" | Scope |
All fields
| Field | Type | Default | Effect |
|---|---|---|---|
panel_id | string | "main" | Host panel |
apply | "persistent" | "node_local" | "persistent" | Sticky vs this node only |
reset | bool | — | Clear override |
mode | "inline" | "docked" | — | Placement |
visible | bool | — | Visibility |
text / text_key | string | — | Body |
prefix / suffix | string | — | Affixes |
prefix_key / suffix_key | string | — | Affixes from strings catalog |
gap | ≥ 0 | — | Spacing |
style_key | string | — | Named style |
when | expression | — | Skip when falsy |
Sticky vs node field
- Command with
apply: "persistent"sticks untilresetor new session. node_local/ node field applies for that node’s render cycle.- Style resolution: explicit
style_key→ panel presetlabelplate_style_key→ characterui.default_labelplate_style_key.
Sticky overrides: Sticky state and clear. No dedicated script keyword — JSON / Mode B / node field. Theme: labelplate. Speakers: Labelplate and speakers. when and apply.