Visual Commands

Visual commands control what appears on screen during dialogue sequences.

These function signatures are based on analysis of the game’s files. Some behaviors and parameter descriptions are inferred and may not be fully accurate. Furthermore, the game is in Early Access and may change over time.

Background Commands

back_creat

Creates or changes the background image.

<<back_creat BG-1 false 0,0 1 0>>
<<back_creat BG-4 true 0,0 3.4 0>>

Parameter	Type	Default	Description
`name`	string	required	Background asset name
`wait`	bool	`false`	Wait for animation to complete
`pos`	string	`0,0`	Position as x,y
`scale`	float	`1`	Scale factor
`time`	float	`0`	Animation duration in seconds

back_remove

Removes a background.

<<back_remove BG-1>>
<<back_remove Test1 false 1>>

Parameter	Type	Default	Description
`name`	string	required	Background to remove
`wait`	bool	`false`	Wait for animation
`time`	float	`0`	Animation duration

back_move

Animates background position.

<<back_move Test1 true 100,100 1.2 1 2>>

Parameter	Type	Default	Description
`name`	string	required	Background name
`wait`	bool	`false`	Wait for animation
`pos`	string	`0,0`	Target position x,y
`scale`	float	`1`	Target scale
`time`	float	`0`	Animation duration
`easing`	int	`0`	Easing function

back_shake

Shakes the background.

<<back_shake Test1 true 4 50,0 1 0 false>>

Parameter	Type	Default	Description
`name`	string	required	Background name
`wait`	bool	`false`	Wait for animation
`duration`	float	`1`	Shake duration
`strength`	string	`1,1`	Shake strength x,y
`vibrato`	int	`10`	Vibration count
`randomness`	float	`90`	Randomness factor
`fadeOut`	bool	`false`	Fade out shake

back_tint

Applies a color tint to background.

<<back_tint Test1 true "FF0000">>

Parameter	Type	Default	Description
`name`	string	required	Background name
`wait`	bool	`false`	Wait for animation
`color`	string	`FFFFFF`	Hex color code (quoted)
`time`	float	`0`	Transition duration

back_rotate

Rotates the background.

<<back_rotate Test1 960 3 true>>

Parameter	Type	Default	Description
`name`	string	required	Background name
`angle`	float	required	Rotation angle in degrees
`duration`	float	required	Animation duration
`wait`	bool	`false`	Wait for animation

splash_screen

Shows a splash screen effect.

<<splash_screen 1 1 2 false>>

Parameter	Type	Default	Description
`fadeInTime`	float	required	Fade in duration
`fadeOutTime`	float	required	Fade out duration
`duration`	float	required	Display duration
`wait`	bool	`false`	Wait for completion

CG Commands

cg_creat

Displays a CG (full-screen image).

<<cg_creat CG_Temp true 1>>
<<cg_creat END true 1 "fade" true>>

Parameter	Type	Default	Description
`name`	string	required	CG asset name
`wait`	bool	`false`	Wait for animation
`time`	float	`0`	Fade duration
`effect`	string	`fade`	Transition effect
`l10n`	bool	`false`	Use localized variant

cg_remove

Removes the CG.

<<cg_remove CG_Temp>>
<<cg_remove CG_Temp true 0.5>>

Parameter	Type	Default	Description
`name`	string	required	CG to remove
`wait`	bool	`false`	Wait for animation
`time`	float	`0`	Fade duration

Character Commands

Character body and face can be specified as numeric indices (e.g., 1, 9) or string names (e.g., laugh1, angry1). Numeric indices are more commonly used in the game scripts.

char_creat

Creates a character on screen.

<<char_creat Lilith 1 1 false 0,-1200 0.7 0 0.3>>
<<char_creat Fouco 1 laugh1 true -200,-233 0.5 0 1>>

Parameter	Type	Default	Description
`name`	string	required	Character identifier (Lilith, Karen, Sartre, Fouco, Green)
`bodyName`	string/int	required	Body sprite (usually `1`)
`facesName`	string/int	required	Face/expression (numeric like `1`, `9` or string like `laugh1`)
`wait`	bool	`false`	Wait for animation
`pos`	string	`0,0`	Position x,y
`scale`	float	`1`	Scale factor
`rotate`	float	`0`	Rotation angle
`time`	float	`0`	Animation duration

char

Changes a character’s appearance (body and/or face).

<<char Lilith 1 54 true 0.7>>
<<char Fouco 1 9 true 0.3>>

Parameter	Type	Default	Description
`name`	string	required	Character identifier
`bodyName`	string	required	New body sprite
`faces`	string	required	New face sprite
`wait`	bool	`false`	Wait for animation
`time`	float	`0`	Transition duration
`effect`	string	`"fade"`	Transition effect

char_remove

Removes a character from screen.

<<char_remove Lilith>>
<<char_remove Fouco true 0.5>>

Parameter	Type	Default	Description
`name`	string	required	Character to remove
`wait`	bool	`false`	Wait for animation
`time`	float	`0`	Fade duration

char_move

Moves a character to a new position.

<<char_move Lilith false 100,0 1 0.5 0>>

Parameter	Type	Default	Description
`name`	string	required	Character name
`wait`	bool	`false`	Wait for animation
`pos`	string	`0,0`	Target position
`scale`	float	`1`	Target scale
`time`	float	`0`	Animation duration
`easing`	int	`0`	Easing function

char_shake

Shakes a character.

<<char_shake Lilith false 0.5 1 10 90 false>>

Parameter	Type	Default	Description
`name`	string	required	Character name
`wait`	bool	`false`	Wait for animation
`duration`	float	`1`	Shake duration
`strength`	float	`1`	Shake intensity
`vibrato`	int	`10`	Vibration count
`randomness`	float	`90`	Randomness factor
`fadeOut`	bool	`false`	Fade out shake

char_flip

Flips a character horizontally.

<<char_flip Lilith>>
<<char_flip Lilith false -1,1 0.3>>

Parameter	Type	Default	Description
`name`	string	required	Character name
`wait`	bool	`false`	Wait for animation
`scale`	string	`1,1`	Scale x,y (use -1,1 to flip)
`time`	float	`0`	Animation duration

char_tint

Applies color tint to a character.

<<char_tint Lilith false "FFCCCC">>

Parameter	Type	Default	Description
`name`	string	required	Character name
`wait`	bool	`false`	Wait for animation
`color`	string	`FFFFFF`	Hex color code (quoted)

char_rename

Renames a character identifier.

<<char_rename OldName NewName>>

Parameter	Type	Description
`oldName`	string	Current name
`newName`	string	New name

Effect Commands

blink

Screen blink effect.

<<blink 3 100 true>>

Parameter	Type	Default	Description
`duration`	float	required	Blink duration
`intensity`	int	required	Blink intensity
`wait`	bool	`false`	Wait for completion

open_eyes / close_eyes

Eye opening/closing transition effects.

<<open_eyes 1 true>>
<<close_eyes 1 true>>

Parameter	Type	Default	Description
`time`	float	required	Animation duration
`wait`	bool	`false`	Wait for animation

enable_vignette / disable_vignette

Controls vignette effect.

<<enable_vignette 0.5 false 1>>
<<disable_vignette 0.5>>

enable_vignette:

Parameter	Type	Default	Description
`time`	float	required	Transition duration
`wait`	bool	`false`	Wait for animation
`value`	float	`1`	Vignette intensity

disable_vignette:

Parameter	Type	Default	Description
`time`	float	required	Transition duration
`wait`	bool	`false`	Wait for animation

set_blur

Applies blur effect.

<<set_blur 3 1 true>>
<<set_blur 2 0 true>>

Parameter	Type	Default	Description
`time`	float	required	Transition duration
`value`	float	required	Blur amount (0 to disable)
`wait`	bool	`false`	Wait for animation

set_lift

Adjusts color lift (brightness).

<<set_lift 2 -1 true>>
<<set_lift 2 0 true>>

Parameter	Type	Default	Description
`time`	float	required	Transition duration
`value`	float	required	Lift amount (-1 to darken, 0 for normal)
`wait`	bool	`false`	Wait for animation

bg_cross_fade / bg_slide_in

Background transition effects.

<<bg_cross_fade BG-1 BG-2 1 true>>
<<bg_slide_in BG-1 BG-2 1>>

Parameter	Type	Default	Description
`bg1`	string	required	First background
`bg2`	string	required	Second background
`time`	float	required	Transition duration
`wait`	bool	`false`	Wait for completion

Common Patterns

Scene Setup

<<back_creat BG-1 false 0,0 1 0>>
<<char_creat Lilith 1 1 false 0,-1200 0.7 0 0.3>>

Expression Change

<<char Lilith 1 54 true 0.3>>

Scene Transition

<<close_eyes 1 true>>
<<back_creat BG-2 false 0,0 1 0>>
<<open_eyes 0.3 true>>

Dramatic Effect

<<char_shake Lilith false 0.5 2 10 90 false>>
<<back_shake BG-1 false 0.5 2,2 10 90 false>>

Overview

Commands & Functions

Visual Commands

Background Commands

back_creat

back_remove

back_move

back_shake

back_tint

back_rotate

splash_screen

CG Commands

cg_creat

cg_remove

Character Commands

char_creat

char

char_remove

char_move

char_shake

char_flip

char_tint

char_rename

Effect Commands

blink

open_eyes / close_eyes

enable_vignette / disable_vignette

set_blur

set_lift

bg_cross_fade / bg_slide_in

Common Patterns

Scene Setup

Expression Change

Scene Transition

Dramatic Effect

​Background Commands

​back_creat

​back_remove

​back_move

​back_shake

​back_tint

​back_rotate

​splash_screen

​CG Commands

​cg_creat

​cg_remove

​Character Commands

​char_creat

​char

​char_remove

​char_move

​char_shake

​char_flip

​char_tint

​char_rename

​Effect Commands

​blink

​open_eyes / close_eyes

​enable_vignette / disable_vignette

​set_blur

​set_lift

​bg_cross_fade / bg_slide_in

​Common Patterns

​Scene Setup

​Expression Change

​Scene Transition

​Dramatic Effect

Background Commands

back_creat

back_remove

back_move

back_shake

back_tint

back_rotate

splash_screen

CG Commands

cg_creat

cg_remove

Character Commands

char_creat

char

char_remove

char_move

char_shake

char_flip

char_tint

char_rename

Effect Commands

blink

open_eyes / close_eyes

enable_vignette / disable_vignette

set_blur

set_lift

bg_cross_fade / bg_slide_in

Common Patterns

Scene Setup

Expression Change

Scene Transition

Dramatic Effect