UI Option

UI Option Dialogue

对话由 UiCore 提供

A line with choices, answered by the scroll wheel, by the cursor, or by both.

字段

字段	类型	默认值	描述
text	Var<String>?	—	—占位符颜色多行
duration	Var<Duration>?	—	How long the line takes to type out; zero shows it at once
style	Ref<UiDialogueStyleEntry>?	—	Look this dialogue takes; leave empty for the server's own
portrait	Var<String>?	—	Picture of the speaker drawn beside their name, for instance portrait_aldric
navigation	UiDialogueNavigation?	—	How the player answers: with the scroll wheel, with the cursor, or with either
options	List<UiOption>?	—	The choices offered UiOption（7） 字段 类型 默认值 描述 text Var<String>? — Text of this choice占位符颜色 tooltip Var<String>? — Shown at the tooltip anchor while the cursor rests on it占位符颜色 criteria List<Criteria>? — Conditions the player must meet to TAKE this choice; it is drawn either way lockedReason Var<String>? — Shown instead of the tooltip while the choice cannot be taken, for instance: il te faut la clef占位符颜色 hideWhenLocked Boolean? — Hide the choice entirely instead of showing it locked modifiers List<Modifier>? — Applied when this choice is taken triggers List<Ref<TriggerableEntry>>? — Fired when this choice is taken
timer	Var<Duration>?	—	Cancels the dialogue when it runs out; zero for no countdown
cancelTriggers	List<Ref<TriggerableEntry>>?	—	Fired when the countdown cancels the dialogue
sound	Var<Sound>?	—	Played once as the line appears

TypeWriter 通用字段（criteria, modifiers, triggers, speaker）

字段	类型	默认值	描述
criteria	List<Criteria>	empty	—
modifiers	List<Modifier>	empty	—
triggers	List<Ref<TriggerableEntry>>	empty	—
speaker	Ref<SpeakerEntry>	—	—

How to use it

Set navigation to choose how players answer: KEYS (scroll to change the selection and the confirmation key to take it), CURSOR (every choice is a button), or BOTH, the default. Each option has its own text, tooltip, criteria, lockedReason (shown while the criteria fail), hideWhenLocked, modifiers and triggers. A locked option is still drawn so the player knows it exists. timer cancels the dialogue when it runs out and fires cancelTriggers. The style entry controls where the window of choices sits and how many are visible.