Skip to main content

Class: EntityItemComponent

If added onto the entity, this indicates that the entity represents a free-floating item in the world. Lets you retrieve the actual item stack contents via the itemStack property.

Example​

import { DimensionLocation, EntityComponentTypes } from "@minecraft/server";

// Returns true if a feather item entity is within 'distance' blocks of 'location'.
function isFeatherNear(location: DimensionLocation, distance: number): boolean {
    const items = location.dimension.getEntities({
        location: location,
        maxDistance: 20,
    });

    for (const item of items) {
        const itemComp = item.getComponent(EntityComponentTypes.Item);

        if (itemComp) {
            if (itemComp.itemStack.typeId.endsWith('feather')) {
                return true;
            }
        }
    }

    return false;
}

Extends​

Constructors​

new EntityItemComponent()​

private new EntityItemComponent(): EntityItemComponent

Returns​

EntityItemComponent

Overrides​

EntityComponent . constructor

Properties​

entity​

Beta

readonly entity: Entity

Remarks​

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

Inherited from​

EntityComponent . entity

itemStack​

readonly itemStack: ItemStack

Remarks​

Item stack represented by this entity in the world.

Throws​

This property can throw when used.

typeId​

readonly typeId: string

Remarks​

Identifier of the component.

Inherited from​

EntityComponent . typeId

componentId​

static readonly componentId: "minecraft:item" = 'minecraft:item'

Methods​

isValid()​

isValid(): boolean

Returns​

boolean

Whether the component is valid.

Inherited from​

EntityComponent . isValid

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.