Add-ons / <<dlg>> Multi-Level Dialog

Syntax: <<dlg ["id" starting-level "prefix"]>>

Arguments:

• dialogue id: (optional, unique string) needed only if there are several dialogues in the same passage.
• starting-level: (optional, number) if you need to skip introductions. Defaults to 0.
• prefix: (optional, string) will be prepended to each line. Empty string by default.

Additionally, the macro behavior can be fine-tuned by changing the options passed into the script: {trim: false, append: false}. Setting trim to true will force <<line>> to trim its contents before displaying (no unneeded line breaks). Setting prepend to true will make <<line>> to prepend this line's visible part to the contents before displaying. There will be linebreak between the visible part and the contents.

Usage:

<<dlg "dlg" 0 "➤">>\
  <<level 0>>\
    <<line "— How are you" "☺ ">>
      — Hi, how are you?
      — Everything's great! You?
    <</line>>
    <<line "— Hi!" "👋 ">>
      — Hi!
      — How are you?
    <</line>>
  <</level>>\
  <<level 1>>\
    <<line "— Things are tough" "😢 ">>
      — Things are tough, my pet hamster just died!:(
    <</line>>
    <<line "— Things are fine..." "❤ ">>
      — Things are fine, wanna hang out?
    <</line>>
    <<line "— Time to go...">>
      — Sry, playing new game, talk later!
    <</line>>
  <</level>>
<</dlg>>

READ: Documentation

Syntax: <<level level>>

<<level>> accepts single numeric mandatory argument: its level.

Usage: See <<dlg>>.

READ: Documentation

Syntax: <<line "line" ["prefix" level]>>

Arguments:

• line: (string, mandatory) short version of a text player character will say.
• prefix: (string, optional) (in)famous "wheel of emotions" kind of thingie prepended to a line, defaults to empty string.
• level: (number, optional) <<level>> to show after this line, defaults to next level. <<line>> is a container macro; it's content is displayed to player after they choose given line.

Usage: See <<dlg>>.

READ: Documentation