Creator Docs

Dialogue Box

The dialogue box shows the text of your visual novel on the screen. Some other engines call it a message box. The Dialogue Box action sets how the box looks and who is speaking.

The scene editor on a phone with the Dialogue Box form open. The preview at the top shows the dialogue box with the name Makkuro and the text of line 2. The form below shows Layout, Speaker, and Options. The whole scene editor on desktop, with the Dialogue Box form open on the left. The form shows Layout, Speaker, and Options. The preview on the right shows the dialogue box with the name Makkuro and the text of line 2.

How the dialogue box works

You type the text of each line in the scene editor. The dialogue box shows this text. You do not need an action for it.

The Dialogue Box action changes the box itself. It sets the layout, which is how the box looks. It also sets the speaker.

A new scene already has a Dialogue Box action on line 1. The next lines keep its layout until another Dialogue Box action changes it.

ADV and NVL

Each dialogue layout has a mode: ADV or NVL.

Mode What the reader sees
ADV One line at a time. Each new line replaces the last one.
NVL Many lines on one page. Each new line shows under the last one.
The scene editor on a phone with line 4 selected. The preview at the top uses the Default ADV layout. Only line 4 shows, under the name Makkuro. The preview on desktop with the Default ADV layout. Only line 4 shows, under the name Makkuro.
ADV
The scene editor on a phone with line 5 selected. The preview at the top uses the Default NVL layout. Lines 3, 4, and 5 show on one page, each under the name Makkuro. The preview on desktop with the Default NVL layout. Lines 3, 4, and 5 show on one page, each under the name Makkuro.
NVL

In NVL, the old lines stay on the page. Clear Page starts a new, empty page. Set it to Yes on the first line of the new page.

Open the Dialogue Box action

  1. In the scene editor, tap the line where the change starts.

  2. Open the Actions menu.

    • Phone or tablet: Tap the + button in the bottom bar.
    • Desktop: Click the + button under Presentation state.
    The scene editor on a phone for Prologue. The preview at the top shows the text of line 2. The + button in the bottom bar is marked. The scene editor on desktop. The preview shows the text of line 2. The + button under Presentation state is marked.
  3. Under Dialogue, tap Dialogue Box.

The Dialogue Box form opens. It shows the settings that the line uses now. Change them, then tap Submit. To learn more about actions, see Scene Editor.

Settings

Setting What it does
Layout How the box looks. It also sets ADV or NVL.
Character Who speaks. The name of the character shows in the box.
Persist Speaker Yes keeps the speaker on the next lines. It shows when the line has a speaker.
Custom name Yes shows the name that you type in Speaker Name.
Append to previous line Yes adds this text after the text of the line before. ADV only.
Clear Page Yes removes the old lines from the page first. NVL only.

Two + buttons add more settings:

  • + next to Speaker: Dialogue sprite shows a sprite of the speaker on the dialogue box. See Dialogue sprite.
  • + next to Options: Custom text speed sets the text speed of this line.

Choose the layout

  1. Open the Dialogue Box action on the line where the new layout starts.

  2. Tap the Layout field.

    A list opens. It has only layouts of type Dialogue ADV or Dialogue NVL. The mode shows on the right.

  3. Tap a layout, for example Default NVL.

    The Dialogue Box form on a phone with the Layout list open. The list shows Default ADV and Default NVL, each with its mode on the right. Default NVL is marked. The Dialogue Box form on desktop with the Layout list open. The list shows Default ADV and Default NVL, each with its mode on the right. Default NVL is marked.
  4. Tap Submit.

This line and the next lines use the new layout. See the NVL picture in ADV and NVL.

To make your own layout, see Dialogue ADV Layout or Dialogue NVL Layout.

Choose the speaker

The speaker is the character who says the line. For the steps, see Choose the speaker in dialogue. In the scene editor, the line starts with the avatar of the speaker.

Custom name

To show a different name on one line, set Custom name to Yes. Then type the name in Speaker Name. For example, type ??? before the reader learns the name. The speaker is still the same character. Only the name changes.

Persist Speaker

A speaker shows on one line only. On the next line, the name is gone. To keep the same speaker on the next lines, use Persist Speaker.

  1. Open the Dialogue Box action on the first line of the speaker.
  2. In Character, choose the speaker.
  3. Under Persist Speaker, tap Yes.
  4. Tap Submit.

The next lines show the avatar of the speaker too. The speaker stays until another Dialogue Box action changes it.

The scene editor on a phone after Persist Speaker is set on line 2. Lines 2 to 5 show the avatar of Makkuro, and the avatars are marked. The preview shows the name Makkuro on line 4. The lines of Prologue on desktop after Persist Speaker is set on line 2. Lines 2 to 5 show the avatar of Makkuro. The avatars are marked.

Add dialogue speaker

You can set the speaker with the keyboard, without the form. First, give the character a number in Shortcut. See Shortcut.

  1. In the scene editor, tap the line.

  2. Press Esc.

    The line is highlighted.

  3. Type c, then the shortcut number. For example, type c1 for shortcut 1.

The line now has this speaker. To remove the speaker, type c0.

Dialogue sprite

A dialogue sprite is a picture of the speaker on the dialogue box. It shows next to the words of the line. For characters that stand in the scene, use Character Sprites instead.

The character needs sprites first. See Character sprites.

  1. Open the Dialogue Box action on the line. See Open the Dialogue Box action.

  2. In Layout, choose ADV with Avatar. This layout has room for the sprite next to the words. See Choose the layout.

  3. In Character, choose the speaker, for example Makkuro.

  4. Next to Speaker, tap +. Then tap Dialogue sprite.

    The Dialogue Box form on a phone with ADV with Avatar as the layout and Makkuro as the character. The + button next to Speaker is marked. Its menu is open, and Dialogue sprite is marked. The Dialogue Box form on desktop with ADV with Avatar as the layout and Makkuro as the character. The + button next to Speaker is marked. Its menu is open, and Dialogue sprite is marked.

    The Select Character page opens.

  5. Tap the character, for example Makkuro.

    The Select Character page on a phone. The Makkuro card is marked. The Select Character page on desktop. The Makkuro card is marked.
  6. Tap a sprite, for example makkuro sprite1 smile. Then tap Select.

    The Sprite Selection page on a phone with the sprites of Makkuro. makkuro sprite1 smile is chosen and marked. The Select button is marked. The Sprite Selection page on desktop with the sprites of Makkuro. makkuro sprite1 smile is chosen and marked. The Select button is marked.
  7. Tap Submit.

    The scene editor on a phone with the Dialogue Box form open. Under Dialogue sprite, the smile sprite of Makkuro is marked. Persist Sprite is Yes, and Transform is Avatar. The Submit button is marked. The preview shows the sprite on the left of the dialogue box, with the name and the line to its right. The scene editor on desktop with the Dialogue Box form open. Under Dialogue sprite, the smile sprite of Makkuro is marked. Persist Sprite is Yes, and Transform is Avatar. The Submit button is marked. The preview shows the sprite on the left of the dialogue box, with the name and the line to its right.

The sprite shows on the left of the dialogue box. Persist Sprite is Yes, so the sprite stays on the next lines too.

Setting What it does
Persist Sprite Yes keeps the sprite on the next lines. It is Yes when you add a sprite.
Transform Where the sprite shows on the screen. See Transforms.
Animation Plays an animation on the sprite. See Animations.

To remove the sprite, tap the ... button on the sprite in the form. Then tap Remove.

Click-to-continue indicator

The click-to-continue indicator is a small image at the end of the text. It tells the reader to tap to go on. You add it in the dialogue layout, not in the Dialogue Box action.

The indicator has 2 states:

  • Revealing: shows while the text is still appearing.
  • Complete: shows when all the text is on the screen. Use it for click-to-continue.

To add a Complete indicator:

  1. Open your dialogue layout in the layout editor. See Layouts.

  2. In the list of elements, tap the text that shows the words of the line. In an ADV layout, it is a Text (Dialogue Content) element. In an NVL layout, it is a Text (Line Content) element.

  3. Next to Indicator, tap +. You may need to scroll down to see it.

  4. Tap Complete.

    The Complete Indicator box opens.

  5. Tap Select image.

  6. Tap Image.

  7. Tap your image.

  8. Tap Select.

  9. Change Width, Height, Offset X, and Offset Y if needed.

  10. Tap Save.

Problems and fixes

  • I cannot find Clear Page. The layout is ADV. Choose a layout of type Dialogue NVL.
  • The name is gone on the next line. Set Persist Speaker to Yes.
  • The shortcut does nothing. Press Esc first. Also check that the character has a Shortcut number.
  • The dialogue sprite covers the words. Choose a layout with room for the sprite, such as ADV with Avatar. In your own layout, move the texts to make room. See Dialogue ADV Layout.
  • I cannot choose a dialogue sprite. The character has no sprites. See Character sprites.

Next steps