Script API - v1.21.0
    Preparing search index...

    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.

    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;
    }

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

    world.afterEvents.entitySpawn.subscribe((event) => {
        const itemEntity = event.entity;
        if (itemEntity.typeId !== "minecraft:item") return;
        const item = itemEntity.getComponent("item");
        item.itemStack.setLore(["Hello Player"]);
    });

    Hierarchy (View Summary)

    Index

    Properties

    entity itemStack typeId componentId

    Methods

    isValid

    Properties

    entity: Entity

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

    itemStack: ItemStack

    Item stack represented by this entity in the world.

    This property can throw when used.

    typeId: string

    Identifier of the component.

    componentId: "minecraft:item" = 'minecraft:item'

    Methods

    • Returns boolean

      Whether the component is valid.

      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.

    Settings

    Member Visibility

    On This Page

    Properties
    Methods