Protected constructorReadonly dimensionDimension that the entity is currently within.
This property can throw when used.
Readonly idUnique identifier of the entity. This identifier is intended to be consistent across loads of a world instance. No meaning should be inferred from the value and structure of this unique identifier - do not parse or interpret it.
This property can throw when used.
Beta isWhether the entity is sneaking - that is, moving more slowly and more quietly.
This property can't be edited in read-only mode.
Readonly Beta levelThe current overall level for the player, based on their experience.
This property can throw when used.
Readonly locationCurrent location of the entity.
This property can throw when used.
Readonly nameName of the player.
This property can throw when used.
Given name of the entity.
This property can't be edited in read-only mode.
Readonly Beta onContains methods for manipulating the on-screen display of a Player.
Readonly Beta scoreboardThis property can throw when used.
Beta selectedManages the selected slot in the player's hotbar.
This property can't be edited in read-only mode.
Optional Readonly Beta spawnIf this player has an individual spawn point set, returns the dimension that their spawn point is within.
This property can throw when used.
Readonly Beta targetRetrieves or sets an entity that is used as the target of AI-related behaviors, like attacking.
This property can throw when used.
Readonly Beta totalThe overall total set of experience needed to achieve the next level for a player.
This property can throw when used.
Readonly typeUnique identifier of the type of the entity - for example, 'minecraft:skeleton'.
This property can throw when used.
Readonly Beta xpThe current set of experience achieved for the player.
This property can throw when used.
Beta
Type of effect to add to the entity.
Amount of time, in ticks, for the effect to apply.
Optional amplifier: numberOptional amplification of the effect to apply.
Optional showParticles: booleanAdds an effect, like poison, to the entity.
This function can't be called in read-only mode.
This function can throw errors.
addEffect.js
const villagerId = "minecraft:villager_v2<minecraft:ageable_grow_up>";
const villagerLoc: mc.Vector3 = { x: 1, y: 2, z: 1 };
const villager = test.spawn(villagerId, villagerLoc);
const duration = 20;
villager.addEffect(MinecraftEffectTypes.poison, duration, 1);
quickFoxLazyDog.ts
const fox = overworld.spawnEntity("minecraft:fox", {
x: targetLocation.x + 1,
y: targetLocation.y + 2,
z: targetLocation.z + 3,
});
fox.addEffect(mc.MinecraftEffectTypes.speed, 10, 20);
log("Created a fox.");
const wolf = overworld.spawnEntity("minecraft:wolf", {
x: targetLocation.x + 4,
y: targetLocation.y + 2,
z: targetLocation.z + 3,
});
wolf.addEffect(mc.MinecraftEffectTypes.slowness, 10, 20);
wolf.isSneaking = true;
log("Created a sneaking wolf.", 1);
Beta
Amount of experience to add. Note that this can be negative.
Returns the current experience of the Player.
Adds/removes experience to/from the Player and returns the current experience of the Player.
This function can't be called in read-only mode.
This function can throw errors.
Beta
Amount to add to the player.
Returns the current level of the Player.
Adds/removes level to/from the Player and returns the current level of the Player.
This function can't be called in read-only mode.
This function can throw errors.
Beta
Amount of damage to apply.
Optional source: EntityDamageSourceApplies a set of damage to an entity.
This function can't be called in read-only mode.
This function can throw errors.
Beta
Impulse vector.
Applies impulse vector to the current velocity of the entity.
This function can't be called in read-only mode.
This function can throw errors.
Beta
X direction in horizontal plane.
Z direction in horizontal plane.
Knockback strength for the horizontal vector.
Knockback strength for the vertical vector.
Applies impulse vector to the current velocity of the entity.
This function can't be called in read-only mode.
This function can throw errors.
Beta
Optional useEffects: booleanWhether to show any visual effects connected to the extinguishing.
Extinguishes the fire if the entity is on fire. Note that you can call getComponent('minecraft:onfire') and, if present, the entity is on fire.
This function can't be called in read-only mode.
This function can throw errors.
Beta
Optional options: BlockRaycastOptionsReturns the first intersecting block from the direction that this entity is looking at.
This function can't be called in read-only mode.
This function can throw errors.
Beta
The identifier of the component (e.g., 'minecraft:rideable') to retrieve. If no namespace prefix is specified, 'minecraft:' is assumed. If the component is not present on the entity, undefined is returned.
Gets a component (that represents additional capabilities) for an entity.
This function can't be called in read-only mode.
Beta
Returns all components that are both present on this entity and supported by the API.
This function can't be called in read-only mode.
Beta
Returns the value for the property, or undefined if the property has not been set.
Returns a property value.
This function can't be called in read-only mode.
This function can throw errors.
Beta
Effect object for the specified effect, or undefined if the effect is not present.
Returns the effect for the specified EffectType on the entity, or undefined if the effect is not present.
This function can't be called in read-only mode.
This function can throw errors.
Beta
Optional options: EntityRaycastOptionsReturns a potential set of entities from the direction that this entity is looking at.
This function can't be called in read-only mode.
This function can throw errors.
Beta
Specifies the cooldown category to retrieve the current cooldown for.
Gets the current item cooldown time for a particular cooldown category.
This function can't be called in read-only mode.
This function can throw errors.
Beta
Returns the current rotation component of this entity.
This function can't be called in read-only mode.
This function can throw errors.
Beta
The individual spawn position, or undefined if there is no specific spawn position set for a player.
Returns an individualized spawn position, if set, for a player.
This function can't be called in read-only mode.
This function can throw errors.
Beta
The identifier of the component (e.g., 'minecraft:rideable') to retrieve. If no namespace prefix is specified, 'minecraft:' is assumed.
Returns true if the specified component is present on this entity.
This function can't be called in read-only mode.
Beta
Optional options: PlayAnimationOptionsThis function can't be called in read-only mode.
This function can throw errors.
Beta
Identifier of the sound to play.
Optional soundOptions: SoundOptionsAdditional optional options for the sound.
Plays a sound that only this particular player can hear.
This function can't be called in read-only mode.
This function can throw errors.
Beta
This function can't be called in read-only mode.
This function can throw errors.
Command to run. Note that command strings should not start with slash.
For commands that return data, returns a JSON structure with command response values.
Runs a particular command asynchronously from the context of this entity. Note that there is a maximum queue of 128 asynchronous commands that can be run in a given tick.
This function can't be called in read-only mode.
This function can throw errors.
The message to be displayed.
Sends a message to the player.
This function can't be called in read-only mode.
This method can throw if the provided RawMessage is
in an invalid format. For example, if an empty name string
is provided to score.
nestedTranslation.ts
// Displays "Apple or Coal"
let rawMessage = {
translate: "accessibility.list.or.two",
with: { rawtext: [{ translate: "item.apple.name" }, { translate: "item.coal.name" }] },
};
player.sendMessage(rawMessage);
scoreWildcard.ts
// Displays the player's score for objective "obj". Each player will see their own score.
const rawMessage = { score: { name: "*", objective: "obj" } };
world.sendMessage(rawMessage);
simpleString.ts
// Displays "Hello, world!"
world.sendMessage("Hello, world!");
translation.ts
// Displays "First or Second"
const rawMessage = { translate: "accessibility.list.or.two", with: ["First", "Second"] };
player.sendMessage(rawMessage);
Beta
Length of time to set the entity on fire.
Optional useEffects: booleanSets an entity on fire (if it is not in water or rain). Note that you can call getComponent('minecraft:onfire') and, if present, the entity is on fire.
This function can't be called in read-only mode.
This function can throw errors.
Beta
Specifies the cooldown category to retrieve the current cooldown for.
Duration in ticks of the item cooldown.
Sets the item cooldown time for a particular cooldown category.
This function can't be called in read-only mode.
This function can throw errors.
Beta
Name of the entity type event to trigger. If a namespace is not specified, minecraft: is assumed.
Triggers an entity type event. For every entity, a number of events are defined in an entities' definition for key entity behaviors; for example, creepers have a minecraft:start_exploding type event.
This function can't be called in read-only mode.
This function can throw errors.
Represents a player within the world.