Visual Commands

Control backgrounds, characters, CGs, and visual effects

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>>