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
Speed
Speed 1
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 a sound effect to play as each text character is displayed.
Set Text Sound Effect
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 loads a new font, under Advance Text Mode, this replaces the default font.

Set Font​

Set the currently used font for text, equivalent of Load Font event.
Set Font
Font
   Font
This loads a new font, under Advance Text Mode, this replaces the default 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 (Background)
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 (Background)
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 (Background)
  • Frame Image: The tileset to use as a dialogue frame.
  • Palette Slot: The palette slot you want to use.