vcmi/docs/modders/Bonus/Bonus_Limiters.md

Bonus Limiters

Predefined Limiters

The limiters take no parameters:

• SHOOTER_ONLY
• DRAGON_NATURE
• IS_UNDEAD
• CREATURE_NATIVE_TERRAIN
• CREATURE_FACTION
• SAME_FACTION
• CREATURES_ONLY
• OPPOSITE_SIDE

Example:

"limiters" : [ "SHOOTER_ONLY" ]

Customizable Limiters

HAS_ANOTHER_BONUS_LIMITER

Parameters:

• Bonus type
• (optional) bonus subtype
• (optional) bonus sourceType and sourceId in struct

• example: (from Adele's bless):

  	"limiters" : [
  		{
  			"type" : "HAS_ANOTHER_BONUS_LIMITER",
  			"parameters" : [
  				"GENERAL_DAMAGE_PREMY",
  				1,
  				{
  					"type" : "SPELL_EFFECT",
  					"id" : "spell.bless"
  				}
  				]
  		}
  	],
  

CREATURE_TYPE_LIMITER

Parameters:

• Creature id (string)
• (optional) include upgrades - default is false

CREATURE_ALIGNMENT_LIMITER

Parameters:

• Alignment identifier

CREATURE_LEVEL_LIMITER

If parameters is empty, level limiter works as CREATURES_ONLY limiter

Parameters:

• Minimal level
• Maximal level

FACTION_LIMITER

Parameters:

• Faction identifier

CREATURE_TERRAIN_LIMITER

Parameters:

• Terrain identifier

Example:

"limiters": [ {
	"type":"CREATURE_TYPE_LIMITER",
	"parameters": [ "angel", true ]
} ],

"limiters" : [ {
	"type" : "CREATURE_TERRAIN_LIMITER",
	"parameters" : ["sand"]
} ]

UNIT_ON_HEXES

Parameters:

• List of affected battlefield hexes

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:

"limiters" : [
    "noneOf",
    "IS_UNDEAD",
    {
        "type" : "HAS_ANOTHER_BONUS_LIMITER",
        "parameters" : [ "SIEGE_WEAPON" ]
    }
]