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

Constructors

Properties

Methods

Constructors

Properties

entity: Entity

Remarks

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

itemStack: ItemStack

Remarks

Item stack represented by this entity in the world.

Throws

This property can throw when used.

typeId: string

Remarks

Identifier of the component.

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

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.