Bonus Limiters
Predefined Limiters
Simple limiters that take no parameters.
Example:
SHOOTER_ONLY
Bonus is active if affected unit is a shooter (has SHOOTER bonus)
DRAGON_NATURE
Bonus is active if affected unit is a dragon (has DRAGON_NATURE bonus)
IS_UNDEAD
Bonus is active if affected unit is an undead (has UNDEAD bonus)
CREATURE_NATIVE_TERRAIN
Bonus is active if affected unit is on native terrain
CREATURES_ONLY
Bonus is active only on units
OPPOSITE_SIDE
Bonus is active only for opposite side for a battle-wide bonus. Requires BONUS_OWNER_UPDATER
to be present on bonus
Customizable Limiters
HAS_ANOTHER_BONUS_LIMITER
Bonus is only active if affected entity has another bonus that meets conditions
Parameters:
bonusType
- type of bonus to check againstbonusSubtype
- subtype of bonus to check against (only used if bonus type is set)bonusSourceType
- source type of bonus to check againstbonusSourceID
-source ID of bonus to check against (only used if bonus type is set)
All parameters are optional.
Examples:
- Adele specialty: active if unit has any bonus from Bless spell
- Mutare specialty: active if unit has
DRAGON_NATURE
bonus
CREATURE_TYPE_LIMITER
Bonus is only active on creatures of specified type
Parameters:
creature
- ID of creature to check againstincludeUpgrades
- whether creature that is upgrade ofcreature
should also pass this limiter. If creature has multiple upgrades, or upgrades have their own upgrades, all such creatures will be affected. Special upgrades such as upgrades via specialties (Dragon, Gelu) are not affected
Example:
CREATURE_ALIGNMENT_LIMITER
Bonus is only active on creatures of factions of specified alignment
Parameters:
alignment
- ID of alignment that creature must have,good
,evil
, orneutral
CREATURE_LEVEL_LIMITER
If parameters is empty, any creature will pass this limiter
Parameters:
minLevel
- minimal level that creature must have to pass limitermaxlevel
- maximal level that creature must have to pass limiter
FACTION_LIMITER
Also available as CREATURE_FACTION_LIMITER
Parameters:
faction
- faction that creature or hero must belong to
CREATURE_TERRAIN_LIMITER
Parameters:
terrain
- identifier of terrain on which this creature must be to pass this limiter. If not set, creature will pass this limiter if it is on native terrain
Example:
HAS_CHARGES_LIMITER
Currently works only with spells. Sets the cost of use in charges
Parameters:
cost
- use cost (charges)
UNIT_ON_HEXES
Parameters:
hexes
- List of affected battlefield hexes
For reference on tiles indexes see image below:
Aggregate Limiters
The following limiters must be specified as the first element of a list, and operate on the remaining limiters in that list:
allOf
(default when no aggregate limiter is specified)anyOf
noneOf
Example: