Impact (Entity Condition Type)

Compares the impact of the origins a player currently has against a value you choose. Impact is the one-to-three-flame rating every origin carries, so this is how a power asks “is this player playing something powerful?” without listing every origin by name.

Type ID: apoli:impact

Fields#

Field	Type	Default	Description
compare_to	Integer or impact name	required	The value to compare against — 0–3, or none, low, medium, high.
comparison	Comparison	>=	How the player’s impact is compared to compare_to.
layer	Identifier	optional	Only look at the origin the player has in this layer. Omit to look at every layer at once.
aggregate	String	max	How several layers combine when layer is omitted: max, min, sum or average. Ignored when layer is set.

Always false for non-players. A player whose layers are all empty reads 0, the same as none.

The origin it reads is the one that is active, so a swapped layer reports the impact of the origin the player is swapped into, not the one underneath it.

Examples#

Only let high-impact origins take the shortcut:

{
    "type": "apoli:impact",
    "comparison": ">=",
    "compare_to": "high"
}

Give low-impact players a leg up — a regeneration power that only applies while nothing they have is stronger than low:

{
    "type": "apoli:action_over_time",
    "interval": 60,
    "entity_action": { "type": "apoli:heal", "amount": 1 },
    "condition": {
        "type": "apoli:impact",
        "comparison": "<=",
        "compare_to": "low"
    }
}

With several layers, aggregate decides what “their impact” means. sum is the budget reading — the total across every layer:

{
    "type": "apoli:impact",
    "aggregate": "sum",
    "comparison": ">",
    "compare_to": 4
}

Scoped to one layer, so a strong secondary origin does not count:

{
    "type": "apoli:impact",
    "layer": "origins:origin",
    "comparison": "==",
    "compare_to": "medium"
}