Conditions
If A - Then B - Else C
Conditions were named as Events before they were renamed on version 0.7.1.
Conditions components a little bit more complex than Actions; they allow to check for conditions and branch from execution threads.
(Example of a Conditions object)
Even if the concept seems complicated, it's actually fairly simple: Imagine you have a Chest that the player can loot. This Chest should only be looted once.
Upon clicking it, if it's the first time, the player gets some items. Otherwise a message can be prompted stating that the chest has already been looted.

Anatomy of a Condition

Conditions work much like Actions, but instead of immediately being executed when called, they perform a set of checks before deciding which action to call (if any at all).
(Conditions anatomy: Clauses contain pairs of Conditions - Actions)
A Conditions object follows the following process:
  • Check the first Clause
    • If all Conditions are true
    • Then executes its Actions
  • If not all Conditions where true, jump to the second Clause
    • If all Conditions are true
    • Then executes its Actions
  • ...
  • If none of the Clause Conditions is true, then execute a special Actions
Only one set of Actions will be called in a Conditions. If the first Clause of the Conditions are all true, only its Actions will be executed and the rest of the Clause won't even be checked.
Conditions are hard to get at the beginning. For a more comprehensive explanation, watch the following tutorial.

Available Conditions

Here's a list of all available Conditions. Remember that each module adds new ones to the list. You can also find more Conditions visiting the Game Creator Hub.

Variables

Condition Name
Description
List Variables contains Object
Returns True if a given Game Object can be found inside a List Variables
List Variables Count
Returns True if the amount of elements in a List Variables is greater or equal to a given value
Variable Bool
Compares a Variable with a boolean value
Variable Color
Compares a Variable with a Color value
Variable Game Object
Compares a Variable with a Game Object value
Variable Number
Compares a Variable with a Number value
Variable Sprite
Compares a Variable with a Sprite value
Variable String
Compares a Variable with a String value
Variable Texture2D
Compares a Variable with a Texture2D value
Variable Vector2
Compares a Variable with a Vector2 value
Variable Vector3
Compares a Variable with a Vector3 value

Characters

Condition Name
Description
Character Capsule
Checks if the radius and height of a character is greater or equal than a value
Character Property
Compares the value of a Character Property with a given value. For example, the height of the Character, its radius, whether it is controllable or not, ...

General

Condition Name
Description
Pattern
Returns True or False depending on the given pattern. For example, if the pattern is "True, False, True", the first 5 times the Condition is checked will return "True, False, True, True, False". Starts over again when reaching the end.
Simple Condition
Returns a constant value of True or False. Useful for debugging.
Scene Loaded
Returns whether a scene is currently loaded or not (additive scenes included)

Input

Condition Name
Description
Keyboard
Returns if a keyboard key is being pressed or not
Mouse Button
Returns if a mouse button is being pressed or not

Object

Condition Name
Description
Game Object Active
Returns True if a given Game Object is active
Exists Game Object
Return True if a given Game Object exists
Rigidbody
Returns True if a given Game Object exists and contains a Rigidbody component
Tag
Returns True if a given Game Object has a given tag value
Last modified 3yr ago
Copy link
On this page
Anatomy of a Condition
Available Conditions
Variables
Characters
General
Input
Object