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: checkFeatherNearby.ts

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

Example: setLoreOnItemEntity.js

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)

Properties

entity itemStack typeId componentId

Methods

isValid

Properties

Readonlyentity

entity: Entity

Remarks

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

ReadonlyitemStack

itemStack: ItemStack

Remarks

Item stack represented by this entity in the world.

Throws

This property can throw when used.

ReadonlytypeId

typeId: string

Remarks

Identifier of the component.

Static ReadonlycomponentId

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

Methods

isValid

  • isValid(): boolean

    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.

Settings

Member Visibility

On This Page

Properties
Methods