Defines the health properties of an entity.

Example

applyDamageThenHeal.ts

// A function that applies damage and then heals the entity
import { Entity, EntityComponentTypes, system, world } from '@minecraft/server';

function applyDamageAndHeal(entity: Entity) {
entity.applyDamage(19); // Many mobs have max damage of 20 so this is a near-death mob

system.runTimeout(() => {
const health = entity.getComponent(EntityComponentTypes.Health);
if (health) {
world.sendMessage(`Entity health before heal: ${health.currentValue}`);

health.resetToMaxValue();

world.sendMessage(`Entity after before heal: ${health.currentValue}`);
} else {
console.warn('Entity does not have health component');
}
}, 40); // Run in a few seconds (40 ticks)
}

Example

healthDisplay.js

import { system, world } from "@minecraft/server";

system.runInterval(() => {
const players = world.getPlayers();
for (const player of players) {
const health = player.getComponent("health");
player.onScreenDisplay.setActionBar(
`Health: ${health.currentValue} / ${health.effectiveMax}`
);
}
});

Hierarchy

Constructors

Properties

currentValue: number

Remarks

Current value of this attribute for this instance.

Throws

This property can throw when used.

defaultValue: number

Remarks

Returns the default defined value for this attribute.

Throws

This property can throw when used.

effectiveMax: number

Remarks

Returns the effective max of this attribute given any other ambient components or factors.

Throws

This property can throw when used.

effectiveMin: number

Remarks

Returns the effective min of this attribute given any other ambient components or factors.

Throws

This property can throw when used.

entity: Entity

Remarks

The entity that owns this component. The entity will be undefined if it has been removed.

typeId: string

Remarks

Identifier of the component.

componentId: "minecraft:health" = 'minecraft:health'

Methods

  • Returns boolean

    Whether the component is valid.

    Remarks

    Returns whether the component is valid. A component is considered valid if its owner is valid, in addition to any addition to any additional validation required by the component.

  • Returns void

    Remarks

    Resets the current value of this attribute to the defined default value.

    This function can't be called in read-only mode.

    Throws

    This function can throw errors.

  • Returns void

    Remarks

    Resets the current value of this attribute to the maximum defined value.

    This function can't be called in read-only mode.

    Throws

    This function can throw errors.

  • Returns void

    Remarks

    Resets the current value of this attribute to the minimum defined value.

    This function can't be called in read-only mode.

    Throws

    This function can throw errors.

  • Parameters

    • value: number

    Returns boolean

    Remarks

    Sets the current value of this attribute. The provided value will be clamped to the range of this attribute.

    This function can't be called in read-only mode.

    Throws

    This function can throw errors.