Entity Components & AI Goals Reference

minecraft:health

Defines the health pool for an entity, measured in health points (1 point = half a heart). Typical values: cow (10), zombie (20), iron golem (100), wither (600).

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:health', { value: 30, max: 30 });

minecraft:attack

Defines an entity's melee attack damage and any additional status effects applied on hit. Typical damage values range from 3 (zombie, creeper) to 7–21 (iron golem).

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:attack', { damage: [3, 5] });

minecraft:attack_damage

Specifies how much damage is dealt by the entity when it attacks.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:attack_damage', { value: 5 });

minecraft:attack_cooldown

Adds a cooldown to an entity to prevent it from attempting to acquire new attack targets.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:attack_cooldown', { attack_cooldown_time: [0.5, 1.0] });

minecraft:area_attack

A component that does damage to entities that get within range.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:area_attack', { cause: 'entity_attack', damage_per_tick: 4, damage_range: 0.5 });

minecraft:damage_sensor

Defines what events to call when this entity is damaged by specific entities or items.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:damage_sensor', {
    triggers: { cause: 'fall', deals_damage: 'no' }
});

minecraft:knockback_resistance

Determines an entity's resistance to knockback from melee attacks. A value of 0.0 means no resistance, while 1.0 provides full immunity to knockback.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:knockback_resistance', { value: 0.5 });

minecraft:shooter

Defines the entity's ranged attack behavior. The minecraft:behavior.ranged_attack goal uses this component to determine which projectiles to shoot.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:shooter', { def: 'minecraft:arrow', sound: 'bow' });

minecraft:projectile

Allows the entity to be a thrown entity.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:projectile', { power: 1.5, gravity: 0.05 });

minecraft:explode

Defines how the entity explodes.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:explode', { power: 4, breaks_blocks: true, causes_fire: false });

minecraft:movement

Defines the base movement speed of an entity. Typical values: creeper (0.2), cow (0.25), zombie baby (0.35).

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:movement', { value: 0.25 });

minecraft:flying_speed

Speed in blocks that this entity flies at.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:flying_speed', { value: 0.1 });

minecraft:underwater_movement

Defines the speed with which an entity can move through water.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:underwater_movement', { value: 0.15 });

minecraft:lava_movement

Allows a custom movement speed across lava blocks.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:lava_movement', { value: 0.32 });

minecraft:water_movement

Customizes how the entity moves through water by adjusting drag coefficient. Lower values let entities glide easily; higher values create resistance.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:water_movement', { drag_factor: 0.98 });

minecraft:friction_modifier

Defines how much friction affects this entity.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:friction_modifier', { value: 0.5 });

minecraft:jump.static

Gives the entity the ability to jump.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:jump.static', { jump_power: 0.42 });

minecraft:jump.dynamic

Defines a dynamic type jump control that will change jump properties based on the speed modifier of the mob. Requires minecraft:movement.skip.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:jump.dynamic', {});

minecraft:dash

Ability for a rideable entity to dash.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:dash', { cooldown_time: 2.75, horizontal_momentum: 20, vertical_momentum: 0.6 });

minecraft:can_fly

Marks the entity as being able to fly; the pathfinder won't be restricted to paths where a solid block is required underneath it.

Acts as a boolean flag — no parameters. Its presence marks the entity with this state.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:can_fly', {});

minecraft:can_climb

Allows an entity to climb ladders.

Acts as a boolean flag — no parameters. Its presence marks the entity with this state.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:can_climb', {});

minecraft:can_power_jump

Allows the entity to power jump like the Horse does in Vanilla.

Acts as a boolean flag — no parameters. Its presence marks the entity with this state.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:can_power_jump', {});

minecraft:block_climber

Allows the entity to detect and maneuver on the scaffolding block.

Acts as a boolean flag — no parameters. Its presence marks the entity with this state.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:block_climber', {});

minecraft:navigation.walk

Walking style navigation for the mob.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:navigation.walk', { can_walk: true, avoid_water: true });

minecraft:navigation.fly

Allows this entity to generate paths in the air like the vanilla Parrots do.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:navigation.fly', { can_path_from_air: true, can_path_over_water: true });

minecraft:navigation.float

Allows this entity to generate paths by flying around the air like the regular Ghast.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:navigation.float', { can_path_over_water: true });

minecraft:navigation.swim

Allows this entity to generate paths that include water.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:navigation.swim', { can_swim: true, can_walk: false });

minecraft:navigation.generic

Allows this entity to generate paths by walking, swimming, flying and/or climbing around and jumping up and down a block.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:navigation.generic', { can_swim: true, is_amphibious: true });

minecraft:preferred_path

Specifies costing information for mobs that prefer to walk on preferred paths.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:preferred_path', {
    default_block_cost: 1.5,
    jump_cost: 5,
    preferred_path_blocks: [{ blocks: ['grass_path'], cost: 0 }]
});

minecraft:physics

Defines physics properties of an actor, including if it is affected by gravity or if it collides with objects.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:physics', { has_gravity: false });

minecraft:collision_box

Sets the width and height of the entity's collision box.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:collision_box', { width: 0.6, height: 1.8 });

minecraft:pushable

Defines what can push an entity between other entities and pistons.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:pushable', { is_pushable: true, is_pushable_by_piston: true });

minecraft:push_through

Sets the distance through which the entity can push through.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:push_through', { value: 1 });

minecraft:buoyant

Enables an entity to float on the specified liquid blocks.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:buoyant', {
    liquid_blocks: ['minecraft:water', 'minecraft:flowing_water'],
    apply_gravity: false
});

minecraft:floats_in_liquid

Sets that this entity can float in liquid blocks.

Acts as a boolean flag — no parameters. Its presence marks the entity with this state.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:floats_in_liquid', {});

minecraft:scale

Sets the entity's visual size multiplier. A value of 1.0 means normal size, 0.5 is half size (commonly used for baby mobs).

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:scale', { value: 0.5 });

minecraft:scale_by_age

Defines the entity's size interpolation based on the entity's age.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:scale_by_age', { start_scale: 0.5, end_scale: 1.0 });

minecraft:color

Defines the entity's main color. Only works on vanilla entities that have predefined color values (sheep, llama, shulker).

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:color', { value: 1 });

minecraft:color2

Defines the entity's second texture color. Only works on vanilla entities that have a second predefined color value (tropical fish).

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:color2', { value: 2 });

minecraft:variant

Variant is used as a per-type way to express a different visual form of the same mob (e.g. cat breeds). Required for setting up multiple entity variants.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:variant', { value: 1 });

minecraft:mark_variant

An additional per-type way (besides variant) to express a different visual form of the same mob.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:mark_variant', { value: 1 });

minecraft:skin_id

Skin ID value. Can be used to differentiate skins, such as base skins for villagers. Requires multiple texture sets to be set up for the entity.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:skin_id', { value: 1 });

minecraft:walk_animation_speed

Sets the speed multiplier for this entity's walk animation speed.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:walk_animation_speed', { value: 1.5 });

minecraft:default_look_angle

Sets this entity's default head rotation angle.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:default_look_angle', { value: -15 });

minecraft:sound_volume

Sets the entity's base volume for sound effects.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:sound_volume', { value: 0.8 });

minecraft:ground_offset

Sets the offset from the ground that the entity is actually at.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:ground_offset', { value: 0.5 });

minecraft:is_baby

Sets that this entity is a baby. Used to set the is_baby value for use in Molang queries and filters.

Acts as a boolean flag — no parameters. Its presence marks the entity with this state.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:is_baby', {});

minecraft:is_charged

Sets that this entity is charged. Used to set the is_charged value for use in Molang queries and filters.

Acts as a boolean flag — no parameters. Its presence marks the entity with this state.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:is_charged', {});

minecraft:is_chested

Sets that this entity is currently carrying a chest.

Acts as a boolean flag — no parameters. Its presence marks the entity with this state.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:is_chested', {});

minecraft:is_dyeable

Allows dyes to be used on this entity to change its color.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:is_dyeable', { interact_text: 'action.interact.dye' });

minecraft:is_ignited

Sets that this entity is currently on fire.

Acts as a boolean flag — no parameters. Its presence marks the entity with this state.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:is_ignited', {});

minecraft:is_illager_captain

Sets that this entity is an Illager Captain.

Acts as a boolean flag — no parameters. Its presence marks the entity with this state.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:is_illager_captain', {});

minecraft:is_saddled

Sets that this entity is currently saddled.

Acts as a boolean flag — no parameters. Its presence marks the entity with this state.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:is_saddled', {});

minecraft:is_sheared

Sets that this entity is currently sheared.

Acts as a boolean flag — no parameters. Its presence marks the entity with this state.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:is_sheared', {});

minecraft:is_stackable

Allows instances of this entity to have vertical and horizontal collisions with each other. Both instances must have a minecraft:collision_box component.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:is_stackable', {});

minecraft:is_stunned

Sets that this entity is currently stunned.

Acts as a boolean flag — no parameters. Its presence marks the entity with this state.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:is_stunned', {});

minecraft:is_tamed

Sets that this entity is currently tamed.

Acts as a boolean flag — no parameters. Its presence marks the entity with this state.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:is_tamed', {});

minecraft:interact

Defines interactions with this entity.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:interact', {
    interactions: [{ give_item: true, interact_text: 'action.interact.give' }]
});

minecraft:tameable

This entity can be tamed.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:tameable', {
    tame_items: ['bone'],
    probability: 0.33,
    tame_event: { event: 'minecraft:on_tame', target: 'self' }
});

minecraft:leashable

Describes how this mob can be leashed to other items.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:leashable', { soft_distance: 4, hard_distance: 6, max_distance: 10 });

minecraft:nameable

Allows this entity to be named (e.g. using a name tag).

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:nameable', { always_show: true });

minecraft:healable

Defines how entities heal — which items can be used to heal and for how much.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:healable', {
    items: [{ item: 'wheat', heal_amount: 2 }]
});

minecraft:rideable

This entity can be ridden.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:rideable', {
    seat_count: 1,
    family_types: ['player'],
    seats: { position: [0, 1.0, 0] }
});

minecraft:sittable

Defines the entity's 'sit' state.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:sittable', {});

minecraft:bribeable

Defines the way an entity can get into the 'bribed' state.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:bribeable', { bribe_items: ['fish', 'salmon'] });

minecraft:giveable

Defines sets of items that can be used to trigger events when used on this entity. The item will be taken and placed in the entity's inventory.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:giveable', { items: ['emerald'], on_give: 'on_receive_emerald' });

minecraft:balloonable

Allows this entity to have a balloon attached and defines the conditions and events for when it is ballooned.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:balloonable', { mass: 0.5 });

minecraft:boostable

Defines the conditions and behavior of a rideable entity's boost.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:boostable', {
    speed_multiplier: 1.35,
    duration: 3,
    boost_items: [{ item: 'carrotOnAStick', damage: 2, replace_item: 'fishing_rod' }]
});

minecraft:addrider

Adds a rider to the entity. Requires minecraft:rideable.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:addrider', { entity_type: 'minecraft:zombie' });

minecraft:breedable

Allows an entity to establish a way to get into the love state used for breeding. Commonly used with minecraft:behavior.breed.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:breedable', {
    breed_items: ['wheat'],
    breeds_with: { baby_type: 'myaddon:custom_mob_baby', breed_event: 'minecraft:entity_born' }
});

minecraft:ageable

Adds a timer for the entity to grow up. It can be accelerated by giving the entity the items it likes as defined by feed_items.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:ageable', {
    duration: 1200,
    feed_items: ['wheat_seeds'],
    grow_up: { event: 'minecraft:ageable_grow_up', target: 'self' }
});

minecraft:genetics

Defines the way a mob's genes and alleles are passed on to its offspring, and how those traits manifest in the child.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:genetics', {
    mutation_rate: 0.02,
    genes: [{ name: 'my_variant', allele_range: { range_min: 1, range_max: 5 } }]
});

minecraft:spawn_entity

Adds a timer after which this entity will spawn another entity or item (similar to a chicken's egg-laying behavior).

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:spawn_entity', {
    min_wait_time: 300, max_wait_time: 600, spawn_item: 'egg', spawn_sound: 'plop'
});

minecraft:inventory

Defines this entity's inventory properties.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:inventory', { inventory_size: 16, container_type: 'inventory' });

minecraft:equipment

Sets the equipment table to use for this entity.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:equipment', { table: 'loot_tables/equipment/custom_mob.json' });

minecraft:equippable

Defines an entity's behavior for having items equipped to it.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:equippable', {
    slots: [{ slot: 1, item: 'carpet', accepted_items: ['carpet'] }]
});

minecraft:shareables

Defines a list of items the mob wants to share or pick up.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:shareables', {
    items: [{ item: 'diamond_sword', priority: 0, want_amount: 1, surplus_amount: 1 }]
});

minecraft:loot

Specifies the loot table that determines what items this entity drops upon death.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:loot', { table: 'loot_tables/entities/custom_mob.json' });

minecraft:economy_trade_table

Defines this entity's ability to trade with players using the economy trade system (villager-style).

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:economy_trade_table', { table: 'trading/custom_trader.json', new_screen: true });

minecraft:trade_table

Defines this entity's ability to trade with players (non-economy version).

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:trade_table', { table: 'trading/custom_trader.json' });

minecraft:entity_sensor

A component that owns multiple subsensors, each firing an event when a set of conditions are met by other entities within range.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:entity_sensor', {
    subsensors: [{ range: [8, 8], event: 'on_player_nearby', minimum_count: 1 }]
});

minecraft:environment_sensor

Creates a trigger based on environment conditions.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:environment_sensor', {
    triggers: { event: 'minecraft:become_hostile', filters: { test: 'is_brightness', operator: '<', value: 0.49 } }
});

minecraft:target_nearby_sensor

Defines the entity's range within which it can see or sense other entities to target them.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:target_nearby_sensor', {
    inside_range: 2, outside_range: 5,
    on_inside_range: { event: 'switch_to_melee', target: 'self' },
    on_outside_range: { event: 'switch_to_ranged', target: 'self' }
});

minecraft:block_sensor

Fires off a specified event when a block in the block list is broken within the sensor range.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:block_sensor', {
    sensor_radius: 16,
    on_break: [{ block_list: ['minecraft:beehive', 'minecraft:bee_nest'], on_block_broken: 'hive_destroyed' }]
});

minecraft:inside_block_notifier

Verifies whether the entity is inside any of the listed blocks.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:inside_block_notifier', {
    block_list: [{ block: { name: 'minecraft:water' }, entered_block_event: { event: 'entered_water', target: 'self' } }]
});

minecraft:scheduler

Fires off scheduled mob events at time of day events.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:scheduler', {
    scheduled_events: [{ filters: { test: 'is_daytime', value: true }, event: 'daytime_event' }]
});

minecraft:timer

Adds a timer after which an event will fire.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:timer', {
    time: [10, 20], looping: true, time_down_event: { event: 'on_timer', target: 'self' }
});

minecraft:heartbeat

Defines the entity's heartbeat.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:heartbeat', { interval: '2.0 - math.clamp(query.anger_level / 80 * 1.5, 0, 1.5)' });

minecraft:despawn

Despawns the actor when the despawn rules or optional filters evaluate to true.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:despawn', { despawn_from_distance: {} });

minecraft:instant_despawn

Despawns the actor immediately.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:instant_despawn', {});

minecraft:persistent

Defines whether an entity should be persistent in the game world (i.e., it will never despawn naturally).

Acts as a boolean flag — no parameters. Its presence marks the entity with this state.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:persistent', {});

minecraft:type_family

Defines the family categories this entity belongs to. Used by filters and other game systems to group entities (e.g., 'mob', 'monster', 'undead', 'zombie').

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:type_family', { family: ['mob', 'monster'] });

minecraft:strength

Defines the entity's strength to carry items.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:strength', { value: 5, max: 5 });

minecraft:follow_range

Defines the maximum range, in blocks, that a mob will pursue a target.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:follow_range', { value: 35, max: 35 });

minecraft:group_size

Keeps track of entity group size in the given radius.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:group_size', {
    radius: 32,
    filters: { test: 'is_family', value: 'custom_mob' }
});

minecraft:experience_reward

Defines the experience points rewarded when this entity dies or is bred.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:experience_reward', {
    on_death: 'query.last_hit_by_player ? 5 : 0',
    on_bred: 'Math.Random(1,7)'
});

minecraft:transformation

Defines an entity's transformation from the current definition into another.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:transformation', { into: 'minecraft:zombie', transformation_sound: 'mob.pig.death' });

minecraft:boss

Defines the current state of the boss for updating the boss HUD.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:boss', { name: 'Custom Boss', hud_range: 55, should_darken_sky: true });

minecraft:teleport

Defines an entity's teleporting behavior.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:teleport', { random_teleports: true, target_distance: 16 });

minecraft:barter

Enables the component to drop an item as a barter exchange.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:barter', { barter_table: 'loot_tables/entities/piglin_barter.json' });

minecraft:admire_item

Allows an entity to ignore attackable targets for a given duration (while admiring an item).

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:admire_item', { duration: 10 });

minecraft:trust

Allows this entity to trust multiple players.

Acts as a boolean flag — no parameters. Its presence marks the entity with this state.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:trust', {});

minecraft:celebrate_hunt

Specifies hunt celebration behaviour.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:celebrate_hunt', { broadcast: true, duration: 4, radius: 16 });

minecraft:ravager_blocked

Defines the ravager's response to their melee attack being blocked.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:ravager_blocked', { knockback_strength: 3 });

minecraft:breathable

Defines what blocks this entity can breathe in and gives them the ability to suffocate.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:breathable', { breathes_water: true, total_supply: 30 });

minecraft:burns_in_daylight

Specifies that this entity takes fire damage when exposed to direct sunlight. The entity will catch fire unless wearing armor in the protection slot, standing in water, or in shade.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:burns_in_daylight', {});

minecraft:fire_immune

Sets that this entity doesn't take damage from fire.

Acts as a boolean flag — no parameters. Its presence marks the entity with this state.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:fire_immune', {});

minecraft:drying_out_timer

Adds a timer for drying out that will count down and fire events when the entity is out of water.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:drying_out_timer', {
    total_time: 120,
    dried_out_event: { event: 'dried_out' },
    stopped_drying_out_event: { event: 'stop_dryingout' }
});

minecraft:angry

Defines an entity's 'angry' state using a timer.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:angry', { duration: 25, broadcast_anger: true, broadcast_range: 20 });

minecraft:anger_level

Compels the entity to track anger towards a set of nuisances (like the Warden).

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:anger_level', { max_anger: 150, angry_threshold: 80, angry_boost: 20 });

minecraft:home

Saves a home position for when the entity is spawned. Allows entities like bees to remember and return to a specific location.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:home', { restriction_type: 'random_movement', restriction_radius: 32 });

minecraft:insomnia

Adds a timer since last rested to see if phantoms should spawn.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:insomnia', { days_until_insomnia: 3 });

minecraft:body_rotation_always_follows_head

Causes the entity's body rotation to match the one of their head. Does not override the minecraft:body_rotation_blocked component.

Acts as a boolean flag — no parameters. Its presence marks the entity with this state.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:body_rotation_always_follows_head', {});

minecraft:horse.jump_strength

Determines the jump height for a horse or similar entity, like a donkey.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:horse.jump_strength', { value: { range_min: 0.4, range_max: 1.0 } });

minecraft:variable_max_auto_step

Entities with this component will have a maximum auto step height that differs depending on whether they are on a block that prevents jumping.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:variable_max_auto_step', { base_value: 1.0, jump_prevented_value: 0.5625 });

minecraft:conditional_bandwidth_optimization

Defines the Conditional Spatial Update Bandwidth Optimizations of this entity.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:conditional_bandwidth_optimization', {
    default_values: { max_dropped_ticks: 7, max_optimized_distance: 80, use_motion_prediction_hints: true }
});

minecraft:custom_hit_test

List of hitboxes for melee and ranged hits against the entity.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:custom_hit_test', {
    hitboxes: [{ width: 2, height: 1.75, pivot: [0, 1, 0] }]
});

minecraft:tick_world

Defines if the entity ticks the world and the radius around it to tick.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:tick_world', { radius: 4, never_despawn: true });

minecraft:ambient_sound_interval

Delay for an entity playing its ambient sound.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:ambient_sound_interval', { value: 5, range: 5, event_name: 'ambient' });

minecraft:behavior.float

Allows the mob to stay afloat while swimming. Passengers will be kicked out when the mob's head goes underwater.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:behavior.float', { priority: 5 });

minecraft:behavior.random_stroll

Allows a mob to randomly stroll around.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:behavior.random_stroll', { priority: 6, speed_multiplier: 0.8 });

minecraft:behavior.random_swim

Allows an entity to randomly move through water.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:behavior.random_swim', { priority: 5, speed_multiplier: 1, xz_dist: 20 });

minecraft:behavior.random_fly

Allows a mob to randomly fly around.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:behavior.random_fly', { priority: 3, can_land_on_trees: true, xz_dist: 15 });

minecraft:behavior.random_look_around

Allows the mob to randomly look around.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:behavior.random_look_around', { priority: 8 });

minecraft:behavior.swim_wander

Allows the entity to wander around while swimming, when not path-finding.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:behavior.swim_wander', { priority: 4, speed_multiplier: 1 });

minecraft:behavior.random_breach

Allows the mob to randomly break the surface of the water.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:behavior.random_breach', { priority: 6, interval: 50, xz_dist: 6, cooldown_time: 2 });

minecraft:behavior.move_to_block

Allows the mob to move towards a specific block type.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:behavior.move_to_block', {
    priority: 5, target_blocks: ['minecraft:grass_block'], search_range: 16, speed_multiplier: 1
});

minecraft:behavior.move_to_water

Allows the mob to move back into water when on land.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:behavior.move_to_water', { priority: 1, search_range: 15, search_height: 5 });

minecraft:behavior.move_to_land

Allows the mob to move back onto land when in water.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:behavior.move_to_land', { priority: 6, search_count: 80, search_height: 8, search_range: 30 });

minecraft:behavior.go_home

Allows the mob to move back to the position they were spawned.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:behavior.go_home', { priority: 4, speed_multiplier: 1, interval: 60 });

minecraft:behavior.move_to_village

Allows the mob to move into a random location within a village.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:behavior.move_to_village', { priority: 5, speed_multiplier: 0.6, search_range: 32 });

minecraft:behavior.move_indoors

Allows this entity to move indoors.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:behavior.move_indoors', { priority: 3, speed_multiplier: 0.8 });

minecraft:behavior.stroll_towards_village

Allows the mob to move into a random location within a village within the search range.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:behavior.stroll_towards_village', { priority: 11, speed_multiplier: 1, search_range: 32, start_chance: 0.005 });

minecraft:behavior.stay_while_sitting

Allows the mob to stay put while it is in a sitting state instead of doing something else. Works with the minecraft:sittable component.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:behavior.stay_while_sitting', { priority: 2 });

minecraft:behavior.melee_attack

Allows an entity to deal damage through a melee attack. Requires a target and the minecraft:attack component.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:behavior.melee_attack', { priority: 3, speed_multiplier: 1, cooldown_time: 0.5 });

minecraft:behavior.ranged_attack

Allows an entity to attack by using ranged shots. Requires minecraft:shooter to define projectile behaviour.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:behavior.ranged_attack', { priority: 3, attack_radius: 48, attack_interval_min: 3, attack_interval_max: 5 });

minecraft:behavior.charge_attack

Allows the entity to charge at the target and deal damage on contact.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:behavior.charge_attack', { priority: 4 });

minecraft:behavior.delayed_attack

Allows the entity to perform a melee attack with a configurable delay between the animation start and damage application.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:behavior.delayed_attack', { priority: 4, attack_duration: 0.75, hit_delay_pct: 0.5 });

minecraft:behavior.stomp_attack

Allows the entity to deal area-of-effect stomp damage to nearby entities.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:behavior.stomp_attack', { priority: 1, speed_multiplier: 1, cooldown_time: 1 });

minecraft:behavior.ram_attack

Allows the entity to perform a charging ram attack, knocking back the target.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:behavior.ram_attack', { priority: 5, run_speed: 0.7, ram_speed: 1.8, knockback_force: 2.5 });

minecraft:behavior.swoop_attack

Allows a flying entity to swoop down and attack a target.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:behavior.swoop_attack', { priority: 2 });

minecraft:behavior.leap_at_target

Allows the mob to leap at a target. Must be used alongside a melee attack goal.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:behavior.leap_at_target', { priority: 3, yd: 0.4, must_be_on_ground: true });

minecraft:behavior.knockback_roar

Allows the entity to perform a roar attack that knocks back all nearby entities.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:behavior.knockback_roar', { priority: 1, duration: 1, knockback_range: 4, knockback_damage: 6 });

minecraft:behavior.sonic_boom

Allows the entity (Guardian Elder variant) to perform a sonic boom attack that bypasses shields.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:behavior.sonic_boom', { priority: 3, attack_damage: 10, attack_range_horizontal: 16 });

minecraft:behavior.hurt_by_target

Allows the mob to target another entity if this mob has been hurt by that entity.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:behavior.hurt_by_target', { priority: 1, alert_same_type: true });

minecraft:behavior.nearest_attackable_target

Allows the mob to actively scan for and set a target to attack.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:behavior.nearest_attackable_target', {
    priority: 2,
    entity_types: [{ filters: { test: 'is_family', subject: 'other', value: 'player' }, max_dist: 16 }],
    must_see: true
});

minecraft:behavior.defend_village_target

Allows the mob to stay in a village and target intruders as a defender.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:behavior.defend_village_target', { priority: 1, attack_chance: 0.05 });

minecraft:behavior.beg

Allows this mob to look at and follow the player that holds food they like.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:behavior.beg', { priority: 9, items: ['minecraft:bone'], look_distance: 8 });

minecraft:behavior.tempt

Allows a mob to be tempted by a player holding a specific item. Uses pathfinding for movement.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:behavior.tempt', { priority: 4, items: ['minecraft:wheat'], speed_multiplier: 1.25 });

minecraft:behavior.trade_with_player

Allows the player to trade with this mob. When the goal starts it stops the mob's navigation.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:behavior.trade_with_player', { priority: 1, max_distance_from_player: 8 });

minecraft:behavior.pickup_items

Allows the mob to pick up items on the ground.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:behavior.pickup_items', { priority: 2, max_dist: 32, speed_multiplier: 6 });

minecraft:behavior.share_items

Allows the mob to give items it has to other nearby entities.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:behavior.share_items', { priority: 8, max_dist: 32, speed_multiplier: 0.5 });

minecraft:behavior.drop_item_for

Allows the entity to move toward a target and drop an item near them.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:behavior.drop_item_for', { priority: 10, loot_table: 'loot_tables/custom_drop.json', drop_item_chance: 0.75 });

minecraft:behavior.find_mount

Allows the mob to look around for another mob to ride atop it.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:behavior.find_mount', { priority: 4, within_radius: 16, mount_distance: 2 });

minecraft:behavior.work

Allows the NPC to use a POI jobsite block.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:behavior.work', { priority: 7, speed_multiplier: 0.5, active_time: 250 });

minecraft:behavior.look_at_player

Compels an entity to look at the nearest player by rotating the head bone within a set limit.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:behavior.look_at_player', { priority: 8, look_distance: 8, probability: 0.02 });

minecraft:behavior.look_at_entity

Compels an entity to look at a specific entity type by rotating the head bone within a set limit.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:behavior.look_at_entity', {
    priority: 10, look_distance: 8,
    filters: { test: 'is_family', subject: 'other', value: 'mob' }
});

minecraft:behavior.look_at_target

Compels an entity to look at its current target by rotating the head bone within a set limit.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:behavior.look_at_target', { priority: 5, look_distance: 8 });

minecraft:behavior.receive_love

Allows the villager to stop so another villager can breed with it. Can only be used by a Villager.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:behavior.receive_love', { priority: 3 });

minecraft:behavior.play

Allows the mob to play with other mobs by chasing each other and moving around randomly. Can only be used by Villagers.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:behavior.play', { priority: 8, chance_to_start: 0.01, speed_multiplier: 0.6 });

minecraft:behavior.celebrate

Allows this entity to celebrate surviving a raid by making celebration sounds and jumping.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:behavior.celebrate', { priority: 5, duration: 30, celebration_sound: 'celebrate' });

minecraft:behavior.panic

Allows the mob to enter the panic state, making it run around and away from the damage source.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:behavior.panic', { priority: 1, speed_multiplier: 1.5 });

minecraft:behavior.avoid_mob_type

Allows the entity to run away from other entities that meet the specified criteria.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:behavior.avoid_mob_type', {
    priority: 3,
    entity_types: [{ filters: { test: 'is_family', subject: 'other', value: 'wolf' }, max_dist: 6, sprint_speed_multiplier: 1.2 }]
});

minecraft:behavior.avoid_block

Allows this entity to avoid certain block types.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:behavior.avoid_block', {
    priority: 1, target_blocks: ['minecraft:warped_fungus'], search_range: 8, search_height: 4
});

minecraft:behavior.flee_sun

Allows the mob to run away from direct sunlight and seek shade. Typically used by undead mobs.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:behavior.flee_sun', { priority: 2, speed_multiplier: 1 });

minecraft:behavior.hide

Allows a mob with the hide component to attempt to move to and hide at an owned or nearby POI.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:behavior.hide', { priority: 4, poi_type: 'bed', speed_multiplier: 0.8 });

minecraft:behavior.find_cover

Allows the mob to seek shade.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:behavior.find_cover', { priority: 9, speed_multiplier: 1, cooldown_time: 5 });

minecraft:behavior.eat_block

Allows the entity to consume a block and replace it with another block, triggering an event.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:behavior.eat_block', {
    priority: 6,
    eat_and_replace_block_pairs: [{ eat_block: 'grass', replace_block: 'dirt' }]
});

minecraft:behavior.drink_milk

Allows the mob to drink milk based on specified environment conditions.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:behavior.drink_milk', { priority: 5, cooldown_seconds: 5 });

minecraft:behavior.drink_potion

Allows the mob to drink potions based on specified environment conditions.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:behavior.drink_potion', {
    priority: 1, potions: [{ id: 21, chance: 1.0, filters: { test: 'on_fire', subject: 'self', value: true } }]
});

minecraft:behavior.breed

Allows this mob to breed with other mobs. Requires the minecraft:breedable component.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:behavior.breed', { priority: 3, speed_multiplier: 1 });

minecraft:behavior.follow_parent

Allows the mob to follow their parent around. Requires the minecraft:is_baby component.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:behavior.follow_parent', { priority: 5, speed_multiplier: 1.1 });

minecraft:behavior.follow_owner

Allows a mob to follow the player that owns it. Requires the entity to be tamed.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:behavior.follow_owner', { priority: 6, speed_multiplier: 8, start_distance: 16, stop_distance: 4 });

minecraft:behavior.follow_mob

Allows the mob to follow other mobs.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:behavior.follow_mob', { priority: 4, search_range: 20, speed_multiplier: 1, stop_distance: 3 });

minecraft:behavior.follow_caravan

Allows the mob to follow mobs that are in a caravan.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:behavior.follow_caravan', { priority: 3, entity_count: 10, speed_multiplier: 2.1 });

minecraft:behavior.lay_egg

Allows the mob to lay an egg block on certain types of blocks if the mob is pregnant.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:behavior.lay_egg', {
    priority: 2, egg_type: 'minecraft:frog_spawn', target_blocks: ['minecraft:water'], speed_multiplier: 1
});

minecraft:behavior.lay_down

Allows mobs to lay down at random intervals.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:behavior.lay_down', { priority: 5, interval: 120, random_stop_interval: 120 });

minecraft:behavior.make_love

Allows the villager to look for a mate to spawn other villagers with. Can only be used by Villagers.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:behavior.make_love', { priority: 5 });

minecraft:behavior.sleep

Allows mobs that own a bed in a village to move to and sleep in it. Can only be used by Villagers.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:behavior.sleep', { priority: 3, cooldown_time: 0 });

minecraft:behavior.sniff

Allows this entity to detect the nearest player within the sniffing radius and update its suspect tracking state. Used by the Warden.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:behavior.sniff', { priority: 6, duration: 4.16, sniffing_radius: 24 });

minecraft:behavior.dig

Allows this entity to dig into the ground before despawning. Used by the Warden.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:behavior.dig', { priority: 1, duration: 5.5, idle_time: 60, vibration_is_disturbance: true });

minecraft:behavior.emerge

Allows this entity to emerge from the ground. Used by the Warden.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:behavior.emerge', { priority: 1, duration: 7 });

minecraft:behavior.roar

Allows this entity to roar at another entity based on data in minecraft:anger_level. Applies anger boost and sets the target. Requires minecraft:anger_level.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:behavior.roar', { priority: 2, duration: 4.2 });

minecraft:behavior.croak

Allows the entity to croak at a random time interval with configurable conditions. Used by the Frog.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:behavior.croak', { priority: 9, interval: [10, 20], duration: 4.5 });

minecraft:behavior.celebrate_survive

Allows this entity to celebrate surviving a raid by shooting fireworks.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:behavior.celebrate_survive', { priority: 5, duration: 30 });

minecraft:behavior.hold_ground

Compels an entity to stop at their current location, face a targeted mob, and react with an event. Requires a target.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:behavior.hold_ground', { priority: 5, min_radius: 10, broadcast: true, broadcast_range: 8 });

minecraft:behavior.send_event

Allows the mob to send an event to another mob.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:behavior.send_event', {
    priority: 3, cast_duration: 3,
    sequence: [{ base_delay: 0, event: 'minecraft:start_fangs', sound_event: 'cast.spell' }]
});

minecraft:behavior.summon_entity

Allows the mob to attack the player by summoning other entities. Requires format version 1.21.50+.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:behavior.summon_entity', {
    priority: 2,
    summon_choices: [{ cast_duration: 2, cooldown_time: 5, weight: 3,
        sequence: [{ entity_type: 'minecraft:vex', num_entities_spawned: 3 }] }]
});

minecraft:behavior.scared

Allows the mob to become scared when the weather outside is thundering.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:behavior.scared', { priority: 1, sound_interval: 20 });

minecraft:behavior.controlled_by_player

Allows the entity to be controlled by the player using a held item. Requires minecraft:movement, minecraft:rideable, and minecraft:item_controllable.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:behavior.controlled_by_player', { priority: 0, mount_speed_multiplier: 1.45 });

minecraft:behavior.move_to_poi

Allows the mob to move to a POI (Point of Interest) if able to.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:behavior.move_to_poi', { priority: 6, poi_type: 'bed', speed_multiplier: 0.8 });

minecraft:behavior.work_composter

Allows the NPC to use the composter POI to convert excess seeds into bone meal.

const entity = new Entity('Custom Mob', 'myaddon:custom_mob');
entity.addComponent('minecraft:behavior.work_composter', { priority: 8, speed_multiplier: 0.5, active_time: 250 });