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. They are the same conditions that gate skills and if lines, so anything listed there works here too.

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

Common ones

The full list is on Conditions. These are the ones conversations use most:

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{item=diamond_sword}`	the subject is holding that item
`hasPermission{perm=some.node}`	the subject has that permission
`variableEquals{var=target.quest;value=done}`	a variable has that value
`gamemode{m=creative}`	the subject is in that game mode

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

Mobs

Spawning

Commands

Effects

Models

Compatibility

NPCs

Pets

Configuration

API

Common ones

Who the subject is

Combining conditions

Quest state

​Common ones

​Who the subject is

​Combining conditions

​Quest state

Common ones

Who the subject is

Combining conditions

Quest state