Difference between revisions of "Conditions and actions"

Revision as of 08:53, 31 October 2017

This page needs improvement, you are welcome to contribute.

A target can be shared between action and condition nodes.

Both condition nodes and action nodes are mainly defined by a target and share almost the same evaluation process:

Step	Condition node	Action node
1.	Get all the entities of the `target type`.
2.	Remove all entities not matching the `target filters`. If there is not a single entity left the node is considered invalid.
3.	Select the best entity according to the `target selector`.
3.	The `any` and `all` selectors are special cases where all remaining entities are selected instead.	The `any` and `all` selectors are not allowed for action targeting.
4.	Check the condition on the remaining entity.	Execute the action upon the remaining entity.
	`Any` selector: Check if the condition is valid for at least one of the entities.
	`All` selector: Check if the condition is valid for all of the entities.
5.	Invert the result that was determined in step 2 or 4 if the invert checkbox below the condition is checked. A currently valid condition is considered invalid, a currently invalid condition is considered valid.

Condition nodes: Checking the condition is the very last step after filtering and selecting took place.

Consider the following condition node:

The following situation is evaluated like this:

There are 4 entities of target type enemy. Allies, resources and bases are discarded.
There are 3 entities not carrying a resource. The enemy moving to his base is removed from the list.
The distance between the Shotgun and the remaining 3 entities is measured. Only the closest enemy of them is selected.
The condition is only checked for the remaining entity. As this enemy has full shield, the condition is evaluated invalid.

The condition node is evaluated invalid in this situation.

The rest of the page is a work in progress.

Target filters
- OR and AND between filters
- Connecting different filters bot class and target action
- inverting a filter
- Lists of Filters per Target Type
Target selector
- What a selector selects if there are several possibilities of equal value.
- Lists of Selectors per Target Type
Actions
- Lists of Actions per Target Type
Conditions
- List of Conditions per Target Type (same as filters?)

@@ Line 27: / Line 27: @@
 |-
 |<code>All</code> selector: Check if the condition is valid for all of the entities.
+|
+|-
+|valign="top"|5.
+|'''Invert the result''' that was  determined in step 2 or 4 if the invert checkbox below the condition is checked. A currently valid condition is considered invalid, a currently invalid condition is considered valid.
 |
 |}
@@ Line 45: / Line 49: @@
 # There are 4 entities of target type enemy. Allies, resources and bases are discarded.
 # There are 3 entities not carrying a resource. The enemy moving to his base is removed from the list.
-# The distance between the Shotgun and the entities is measured. Only the closest enemy is selected.
+# The distance between the Shotgun and the remaining 3 entities is measured. Only the closest enemy of them is selected.
 # The condition is only checked for the remaining entity. As this enemy has full shield, the condition is evaluated invalid.
@@ Line 54: / Line 58: @@
 === Thoughts to include into this page ===
-* explain INVERT
 * Target filters
 ** OR and AND between filters