minecraft:behavior.defend_village_target

Allows the entity to stay in a village and defend the village from aggressors. If a player is in bad standing with the village this goal will cause the entity to attack the player regardless of filter conditions.

Properties

PropertyTypeDefaultWhat it does
attack_chanceDecimal0 to 10.05The percentage chance that the entity has to attack aggressors of its village, where 1.0 = 100%.
attack_ownerBooleanfalseIf true, this entity can attack its owner.
must_reachBooleanfalseIf true, this entity requires a path to the target.
must_seeBooleanfalseDetermines if target-validity requires this entity to be in range only, or both in range and in sight.
within_radiusDecimalmin 00Maximum distance this entity can be from the target when following it, otherwise the target becomes invalid. This value is only used if the entity doesn't declare "minecraft:follow_range".
must_see_forget_durationDecimalmin 03Time (in seconds) the target must not be seen by this entity to become invalid. Used only if "must_see" is true.
persist_timeDecimalmin 00Time (in seconds) this entity can continue attacking the target after the target is no longer valid.
entity_typesList of object or Object[]Filters which types of targets are valid for this entity.
filtersObject or List of object{"AND": null, "NOT": null, "OR": null, "all": null, "all_…Conditions that make this entry in the list valid
max_distDecimal16Maximum distance this mob can be away to be a valid choice
max_heightDecimal-1Maximum height this mob can be away to be a valid choice
max_fleeDecimal10Maximum distance this mob can be from the target to stop fleeing
walk_speed_multiplierDecimal1Multiplier for the walking speed. A value of 1.0 means the speed is unchanged
sprint_speed_multiplierDecimal1Multiplier for the sprinting speed. A value of 1.0 means the speed is unchanged
priorityInteger0Priority for this mob type
check_if_outnumberedBooleanfalseIf true, the mob will check if its outnumbered
reevaluate_descriptionBooleanfalseIf true, the mob will stop being targeted if it stops meeting any conditions.
cooldownInteger0The amount of time in seconds that the mob has to wait before selecting a target of the same type again
must_seeBoolean—If true, the mob has to be visible to be a valid choice
must_see_forget_durationInteger3Determines the amount of time in seconds that this mob will look for a target before forgetting about it and looking for a new one when the target isn't visible any more
priorityIntegermin 00
control_flagsList of text[]

Example from the game files

This is how vanilla Iron Golem uses it in Minecraft Bedrock 1.26.60.5:

{
  "minecraft:behavior.defend_village_target": {
    "must_reach": true,
    "entity_types": [
      {
        "filters": {
          "AND": [
            {
              "OR": [
                {
                  "test": "is_family",
                  "subject": 1,
                  "operator": 0,
                  "value": "mob"
                },
                {
                  "test": "is_family",
                  "subject": 1,
                  "operator": 0,
                  "value": "player"
                }
              ]
            }
          ]
        }
      }
    ],
    "priority": 1
  }
}

Used by 1

Vanilla entities with minecraft:behavior.defend_village_target in their definition:

Related components