Skip to main content

Dialogue, Text & Menus

Events for displaying dialogue, text, and menu choices.

Actions​

Show Text​

Show a dialogue box on the screen. You need to use interact button for it to go away.
Show Text
Text
Layout
Behavior
Presets
Text...

Show Choices​

Display a menu of multiple options and set the specified variable to the value of the chosen option. Multiple layouts are provided, 'Menu' displays as a single column on the right hand side of the game screen and 'Dialogue' displays a full width dialogue box with two columns.
Show Choices
Text
Layout
Behavior
Presets
Set Variable
$Variable0
Number of options
2
Set to '1' if
Item 1
Set to '2' if
Item 2

Set Text Localization​

Change the active localization, any future text related calls will use the new localization.
Set Text Localization
   Spanish
Change the active localization to the new one.
  • Localization: Change the active localization to the new one.

Clear Text​

Clear a line of text at the given tile coordinates & size.
Clear Text
X
0
Y
0
Width
0
Plane
Background
  • X: The horizontal position.
  • Y: The vertical position.
  • Width: The total width.
  • Plane: The plane we want to use

Close Dialogue​

Close a dialogue box currently on screen.
Close Dialogue
Only required if you have opened a dialogue box with no close condition or forced an manual open.
  • Speed: The movement speed.

Force Dialogue to Stay Open​

Forces the dialogue box to stay open until close is manually called, helpful to run code in-between conversation scenes.
Force Dialogue to Stay Open
Forces the dialogue box to stay open until close is manually called, helpful to run code in-between conversation scenes.

Draw Text​

Draw a line of text at the given tile coordinates.
Draw Text
Text...
X
0
Y
0
Pin To Screen
X / Y are VDP coordinates, take this into account for scrolling levels.
Horizontal Alignment
Left
Plane
Background

Draw Frame​

Draws the dialogue frame without content on the given plane, frame tiles have priority enabled.
Draw Frame
Plane
Background
Palette Slot
PAL0
Draw Border
X
0
Y
0
Width
40
Height
8
  • Plane: The plane we want to use
  • Palette Slot: The palette slot you want to use.
  • X: The horizontal position.
  • Y: The vertical position.

Draw Cursor​

Draws the UI cursor on the given plane, if drawn already it clears previous cursor as well.
Draw Cursor
Plane
Background
Palette Slot
PAL0
X
0
Y
0
  • Plane: The plane we want to use
  • Palette Slot: The palette slot you want to use.
  • X: The horizontal position.
  • Y: The vertical position.

Clear Cursor​

Clear the last cursor usage, it can draw an empty tile or the frame background.
Clear Cursor
Draw the frame background instead of an empty tile.

Restore Cursor​

Restores the usual tile-based cursor, this unbinds an actor from cursor mode.
Restore Cursor
Restores the usual tile-based cursor, this unbinds an actor from cursor mode.

Properties​

Set Dialogue Sound​

Set the sound effect a dialogue plays while typing text, opening or closing its box, moving to the next page or using a choice menu.
Set Dialogue Sound
Dialogue Sound
Text Typing
Sound Effect
   jump_sound.wav
Channel
Auto Selection
Priority
6
Play Every
1
Skip Spaces & Punctuation

Actor As Cursor​

Use the selected actor as cursor on choices display & draw cursor calls.
Actor As Cursor
Actor
Actor 1

Load Font​

Load the selected font to use rendering text, on Advance Text Mode, this replaces the default font.
Load Font
Font
   Font
This replaces the current font.

Set Font​

Set the currently used font for text, equivalent of Load Font event.
Set Font
Font
   Font
This replaces the current font.
  • Font: The font to use for drawing text.

Set Dialogue Frame Palette​

Set the palette that will be used by the dialogue frame rendering.
Set Dialogue Frame Palette
Palette Slot
PAL0
The default font uses the last color of the selected palette.
  • Palette Slot: The palette slot you want to use.

Set Text Priority​

Set the priority that will be used by the text rendering.
Set Text Priority
Priority
  • Priority: If the text will be rendered with priority.

Set Text Palette​

Set the palette that will be used by the text rendering.
Set Text Palette
Palette Slot
PAL0
The default font uses the last color of the selected palette.
  • Palette Slot: The palette slot you want to use.

Set Dialogue Cursor​

Set a tileset to replace the dialogue cursor image.
Set Dialogue Cursor
Frame Image
flowers
  • Frame Image: The tileset to use as a dialogue frame.

Set Dialogue Frame​

Set a tileset to replace the dialogue frame image.
Set Dialogue Frame
Frame Image
flowers
Must be a tileset of size 24px x 24px.
Palette Slot
PAL0
  • Frame Image: The tileset to use as a dialogue frame.
  • Palette Slot: The palette slot you want to use.