Textdisplay Spoken Cinematic

Display a spoken dialogue using TextDisplay during a cinematic

过场动画由 Text Display Dialogue 提供

字段

字段	类型	默认值	描述
segments	List<TextDisplaySpokenSegment>	empty	— TextDisplaySpokenSegment（3） 字段 类型 默认值 描述 startFrame Int 0 — endFrame Int 0 — text Var<String> — The text to display to the player.占位符颜色多行
position	Var<Position>	ORIGIN	Position where to display the TextDisplay. Use the position capture tool in-game or format: 'world,x,y,z,yaw,pitch' (e.g., 'world,22,232,-21,0,0')
scale	Var<Double>	1.0	Scale of the TextDisplay
showBackground	Var<Boolean>	true	Whether to show background behind the text
backgroundColor	Var<Color>	—	Background color for the main text
speakerBackgroundColor	Var<Color>	—	Background color for the speaker name
textOpacity	Var<Double>	1.0	Text opacity (0.0 to 1.0)
viewRange	Var<Double>	64.0	View range for the TextDisplay
appearanceDelay	Var<Duration>	ofSeconds(1)	Délai d'apparition du texte (en secondes)
animationDuration	Var<Duration>	ofSeconds(2)	Durée d'animation du texte (en secondes)

TypeWriter 通用字段（criteria, speaker）

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

How to use it

Add this entry to a cinematic page and draw one segment per line of speech. Each segment has startFrame, endFrame and a text.

• Timing. At the start of a segment the text waits appearanceDelay, then types out over animationDuration. Both are converted at 20 frames per second.
• Position. position fixes the text in the world. When it is empty, the text appears 3 blocks in front of the player at eye height.
• Speaker. The speaker name is shown above the text and the speaker sound plays at the start of each segment.
• The display always faces the camera and uses backgroundColor for both the name and the text.
• The cinematic does not move the player; the text is not interactive.