Dialog Conditions

Conditions gate a dialog node or a single choice: a reply that only appears if you’re carrying the right item, a greeting that only happens at night. The same conditions work in if and while effect lines.

  choices:
  - text: "Want this diamond?"
    conditions:
    - hasitem{item=diamond}
    goto: trade

Built-in conditions

Condition	True when
`isday`	it’s daytime in the world
`isnight`	it’s nighttime
`raining`	it’s raining
`thundering`	there’s a thunderstorm
`sneaking`	the subject is sneaking
`hasitem{item=diamond;amount=3}`	the subject’s inventory holds that item (and amount)
`holding[DIAMOND_SWORD]`	the subject is holding that item
`haspermission[some.node]`	the subject has that permission

Who the subject is

In a dialog: the player having the conversation.
In an effect line (if / while): the line’s first target.

Combining conditions

They use the same condition language as everything else, so they combine with && and || and mix with variables and comparisons:

conditions:
- isnight && var.quest_stage >= 2

Multiple entries in a conditions: list must all pass.

Quest state

Pair conditions with variables for conversations that remember. Set a variable in a node’s effects, check it in a later node’s conditions, and your NPC knows where the player is in a questline:

  start: [quest_done, quest_active, first_meeting]
  quest_done:
    conditions: [target.var.quest_stage >= 2]
    say: "&fThanks again, friend."
  quest_active:
    conditions: [target.var.quest_stage >= 1]
    say: "&fGot those emeralds yet?"
  first_meeting:
    say: "&fYou must be new around here."

The start: list is checked top to bottom, so put the most specific state first.

Remember the YAML brace rule: conditions with {...} need a block list, not an inline one.

Getting Started

Commands

Effects

Models

NPCs

API

API

Built-in conditions

Who the subject is

Combining conditions

Quest state

​Built-in conditions

​Who the subject is

​Combining conditions

​Quest state

Built-in conditions

Who the subject is

Combining conditions

Quest state