Skip to main content
Version: 1.8.0

Using Conditions

The conditional execution system within the action system is where CustomNPCs really shines. Conditions allow you to only run actions when certain conditions are met. To add a condition to an existing action, enter the action's editing menu. Click the comparator in the bottom right to enter the action's condition menu.

Selectors​

Selectors determine how many conditions must be met for the action to be executed.

Available Selectors

  • ALL requires all conditions to be satisfied to execute the action. (Boolean AND)
  • ONE only requires one condition to be satisfied to execute the action. (Boolean OR)

Condition Types​

CustomNPCs currently supports two types of conditions.

Numeric conditions compare numeric inputs to a target value with a variety of comparators.

Logical Conditions compare non-numeric values like game mode or having a specific effect or permission with a target value. Some boolean (true/false) conditions are stuck into the logical category. These conditions don't have a target value.

Condition Values​

A Condition Value is a property a player possesses. For example, a numeric value would be experience levels.

Numeric Values​

  • Experience Points
  • Experience Levels
  • X Coordinate
  • Y Coordinate
  • Z Coordinate
  • Health
  • Absorption

Logical Values​

  • Game mode
  • Has an Effect
  • Has Permission
  • Is Frozen
  • Is Sneaking
  • Is Gliding
  • Is Sprinting

Comparators​

Condition comparators are the logical operations used to compute the boolean value of the condition.

Currently Supported Comparators:​

  • Greater Than
  • Greater Than or Equal To
  • Less Than
  • Less Than or Equal To
  • Equal To
  • Not Equal To
note

Logical Conditions can only use the bolded Comparators.