Class: SimulatedPlayer

A simulated player can be used within GameTests to represent how a player moves throughout the world and to support testing of how entities and the environment will react to a player. This type derives much of its structure and methods from the @minecraft/server.Player type. Note that many types of events that may be available for entities more broadly, such as item use events, may not fire in the same capacity for simulated players.

Extends

Player

Constructors

new SimulatedPlayer()

private new SimulatedPlayer(): SimulatedPlayer

Returns

SimulatedPlayer

Overrides

minecraftserver.Player.constructor

Properties

camera

readonly camera: Camera

Remarks

The player's Camera.

Throws

This property can throw when used.

Inherited from

minecraftserver.Player.camera

dimension

readonly dimension: Dimension

Remarks

Dimension that the entity is currently within.

Throws

This property can throw when used.

Inherited from

minecraftserver.Player.dimension

fallDistance

Beta

readonly fallDistance: number

Remarks

The distance an entity has fallen. The value is reset when the entity is teleported. The value is always 1 when gliding with Elytra.

Throws

This property can throw when used.

Inherited from

minecraftserver.Player.fallDistance

headRotation

readonly headRotation: Vector2

Remarks

Rotation of the head across pitch and yaw angles.

Throws

This property can throw when used.

id

readonly id: string

Remarks

Unique 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 is accessible even if Entity.isValid is false.

Inherited from

minecraftserver.Player.id

isClimbing

readonly isClimbing: boolean

Remarks

Whether the entity is touching a climbable block. For example, a player next to a ladder or a spider next to a stone wall.

Throws

This property can throw when used.

Inherited from

minecraftserver.Player.isClimbing

isEmoting

readonly isEmoting: boolean

Remarks

If true, the player is currently emoting.

Throws

This property can throw when used.

Inherited from

minecraftserver.Player.isEmoting

isFalling

readonly isFalling: boolean

Remarks

Whether the entity has a fall distance greater than 0, or greater than 1 while gliding.

Throws

This property can throw when used.

Inherited from

minecraftserver.Player.isFalling

isFlying

readonly isFlying: boolean

Remarks

Whether the player is flying. For example, in Creative or Spectator mode.

Throws

This property can throw when used.

Inherited from

minecraftserver.Player.isFlying

isGliding

readonly isGliding: boolean

Remarks

Whether the player is gliding with Elytra.

Throws

This property can throw when used.

Inherited from

minecraftserver.Player.isGliding

isInWater

readonly isInWater: boolean

Remarks

Whether any part of the entity is inside a water block.

Throws

This property can throw when used.

Inherited from

minecraftserver.Player.isInWater

isJumping

readonly isJumping: boolean

Remarks

Whether the player is jumping. This will remain true while the player is holding the jump action.

Throws

This property can throw when used.

Inherited from

minecraftserver.Player.isJumping

isOnGround

readonly isOnGround: boolean

Remarks

Whether the entity is on top of a solid block. This property may behave in unexpected ways. This property will always be true when an Entity is first spawned, and if the Entity has no gravity this property may be incorrect.

Throws

This property can throw when used.

Inherited from

minecraftserver.Player.isOnGround

isSleeping

readonly isSleeping: boolean

Remarks

If true, the entity is currently sleeping.

Throws

This property can throw when used.

Inherited from

minecraftserver.Player.isSleeping

isSneaking

isSneaking: boolean

Remarks

Whether the entity is sneaking - that is, moving more slowly and more quietly.

This property can't be edited in read-only mode.

Inherited from

minecraftserver.Player.isSneaking

isSprinting

isSprinting: boolean

Remarks

Returns whether the simulated player is sprinting.

This property can't be edited in read-only mode.

Overrides

minecraftserver.Player.isSprinting

isSwimming

readonly isSwimming: boolean

Remarks

Whether the entity is in the swimming state. For example, a player using the swim action or a fish in water.

Throws

This property can throw when used.

Inherited from

minecraftserver.Player.isSwimming

level

readonly level: number

Remarks

The current overall level for the player, based on their experience.

Throws

This property can throw when used.

Inherited from

minecraftserver.Player.level

lifetimeState

Beta

readonly lifetimeState: EntityLifetimeState

Remarks

Whether the entity reference that you have is valid or not. For example, an entity may be unloaded if it moves into a chunk that is unloaded, but may be reactivated if the chunk it is within gets reloaded.

Inherited from

minecraftserver.Player.lifetimeState

location

readonly location: Vector3

This property can't be edited in read-only mode.

Inherited from

minecraftserver.Player.nameTag

onScreenDisplay

readonly onScreenDisplay: ScreenDisplay

Remarks

Contains methods for manipulating the on-screen display of a Player.

Throws

This property can throw when used.

Inherited from

minecraftserver.Player.onScreenDisplay

scoreboardIdentity?

optional readonly scoreboardIdentity: ScoreboardIdentity

Remarks

Returns a scoreboard identity that represents this entity. Will remain valid when the entity is killed.

Inherited from

minecraftserver.Player.scoreboardIdentity

selectedSlot

Beta

selectedSlot: number

Remarks

Manages the selected slot in the player's hotbar.

This property can't be edited in read-only mode.

Inherited from

minecraftserver.Player.selectedSlot

target?

Beta

optional readonly target: Entity

addEffect(effectType, duration, options?): Effect

Parameters

Parameter	Type	Description
`effectType`	`string` \| `EffectType`	Type of effect to add to the entity.
`duration`	`number`	Amount of time, in ticks, for the effect to apply. There are 20 ticks per second. Use TicksPerSecond constant to convert between ticks and seconds. The value must be within the range [0, 20000000].
`options`?	`EntityEffectOptions`	Additional options for the effect.

Returns

Effect

Returns nothing if the effect was added or updated successfully. This can throw an error if the duration or amplifier are outside of the valid ranges, or if the effect does not exist.

Inherited from

minecraftserver.Player.addEffect

Remarks

Adds or updates an effect, like poison, to the entity.

This function can't be called in read-only mode.

Throws

This function can throw errors.

Examples

// Spawns a villager and gives it the poison effect
import {
    DimensionLocation,
} from '@minecraft/server';
import { MinecraftEffectTypes } from '@minecraft/vanilla-data';

function spawnPoisonedVillager(location: DimensionLocation) {
    const villagerType = 'minecraft:villager_v2<minecraft:ageable_grow_up>';
    const villager = location.dimension.spawnEntity(villagerType, location);
    const duration = 20;

    villager.addEffect(MinecraftEffectTypes.Poison, duration, { amplifier: 1 });
}

// Spawns a fox over a dog
import { DimensionLocation } from '@minecraft/server';
import { MinecraftEntityTypes } from '@minecraft/vanilla-data';

function spawnAdultHorse(location: DimensionLocation) {
    // Create fox (our quick brown fox)
    const fox = location.dimension.spawnEntity(MinecraftEntityTypes.Fox, {
        x: location.x,
        y: location.y + 2,
        z: location.z,
    });

    fox.addEffect('speed', 10, {
        amplifier: 2,
    });

    // Create wolf (our lazy dog)
    const wolf = location.dimension.spawnEntity(MinecraftEntityTypes.Wolf, location);
    wolf.addEffect('slowness', 10, {
        amplifier: 2,
    });
    wolf.isSneaking = true;
}

addExperience()

addExperience(amount): number

Parameters

Parameter	Type	Description
`amount`	`number`	Amount of experience to add. Note that this can be negative. Min/max bounds at -2^24 ~ 2^24

Returns

number

Returns the current experience of the Player.

Inherited from

minecraftserver.Player.addExperience

Remarks

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.

Throws

This function can throw errors.

addLevels()

addLevels(amount): number

Parameters

Parameter	Type	Description
`amount`	`number`	Amount to add to the player. Min/max bounds at -2^24 ~ 2^24

Returns

number

Returns the current level of the Player.

Inherited from

minecraftserver.Player.addLevels

Remarks

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.

Throws

This function can throw errors.

addTag()

addTag(tag): boolean

Parameters

Parameter	Type	Description
`tag`	`string`	Content of the tag to add. The tag must be less than 256 characters.

Returns

boolean

Returns true if the tag was added successfully. This can fail if the tag already exists on the entity.

Inherited from

minecraftserver.Player.addTag

Remarks

Adds a specified tag to an entity.

This function can't be called in read-only mode.

Throws

This function can throw errors.

applyDamage()

applyDamage(amount, options?): boolean

Parameters

Parameter	Type	Description
`amount`	`number`	Amount of damage to apply.
`options`?	`EntityApplyDamageByProjectileOptions` \| `EntityApplyDamageOptions`	Additional options about the source of damage, which may add additional effects or spur additional behaviors on this entity.

Returns

boolean

Whether the entity takes any damage. This can return false if the entity is invulnerable or if the damage applied is less than or equal to 0.

Inherited from

minecraftserver.Player.applyDamage

Remarks

Applies a set of damage to an entity.

This function can't be called in read-only mode.

Throws

This function can throw errors.

Example

// A function that applies damage and then heals the entity
import { Entity, EntityComponentTypes, system, world } from '@minecraft/server';

function applyDamageAndHeal(entity: Entity) {
    entity.applyDamage(19); // Many mobs have max damage of 20 so this is a near-death mob

    system.runTimeout(() => {
        const health = entity.getComponent(EntityComponentTypes.Health);
        if (health) {
            world.sendMessage(`Entity health before heal: ${health.currentValue}`);

            health.resetToMaxValue();

            world.sendMessage(`Entity after before heal: ${health.currentValue}`);
        } else {
            console.warn('Entity does not have health component');
        }
    }, 40); // Run in a few seconds (40 ticks)
}

applyImpulse()

applyImpulse(vector): void

Parameters

Parameter	Type	Description
`vector`	`Vector3`	Impulse vector.

Returns

void

Inherited from

minecraftserver.Player.applyImpulse

Remarks

Applies impulse vector to the current velocity of the entity.

This function can't be called in read-only mode.

Throws

This function can throw errors.

Example

// A function that throws entities up in the air
import { Entity } from '@minecraft/server';

function yeetEntity(entity: Entity) {

    // Zero out the entity's velocity before applying impulse
    entity.clearVelocity();

    // throw the zombie up in the air
    entity.applyImpulse({ x: 0, y: 15, z: 0 });
}

applyKnockback()

applyKnockback(directionX, directionZ, horizontalStrength, verticalStrength): void

Parameters

Parameter	Type	Description
`directionX`	`number`	X direction in horizontal plane.
`directionZ`	`number`	Z direction in horizontal plane.
`horizontalStrength`	`number`	Knockback strength for the horizontal vector.
`verticalStrength`	`number`	Knockback strength for the vertical vector.

Returns

void

Inherited from

minecraftserver.Player.applyKnockback

Remarks

Applies impulse vector to the current velocity of the entity.

This function can't be called in read-only mode.

Throws

This function can throw errors.

Example

import { EntityQueryOptions, DimensionLocation } from '@minecraft/server';

function mobParty(targetLocation: DimensionLocation) {
    const mobs = ['creeper', 'skeleton', 'sheep'];

    // create some sample mob data
    for (let i = 0; i < 10; i++) {
        targetLocation.dimension.spawnEntity(mobs[i % mobs.length], targetLocation);
    }

    const eqo: EntityQueryOptions = {
        type: 'skeleton',
    };

    for (const entity of targetLocation.dimension.getEntities(eqo)) {
        entity.applyKnockback(0, 0, 0, 1);
    }
}

attack()

attack(): boolean

Returns

boolean

Remarks

Causes the simulated player to make an attack 'swipe'. Returns true if the attack was performed - for example, the player was not on cooldown and had a valid target. Target selection is performed by raycasting from the player's head.

This function can't be called in read-only mode.

Throws

This function can throw errors.

attackEntity()

attackEntity(entity): boolean

Parameters

Parameter	Type
`entity`	`Entity`

Returns

boolean

Remarks

Causes the simulated player to attack the provided target. Returns true if the attack was performed - for example, the player was not on cooldown and had a valid target. The attack can be performed at any distance and does not require line of sight to the target entity.

This function can't be called in read-only mode.

Throws

This function can throw errors.

breakBlock()

breakBlock(blockLocation, direction?): boolean

Parameters

Parameter	Type	Description
`blockLocation`	`Vector3`	Location of the block to interact with.
`direction`?	`Direction`	Direction to place the specified item within.

Returns

boolean

Remarks

Destroys the block at blockLocation, respecting the rules of the server player's game mode. The block will be hit until broken, an item is used or stopBreakingBlock is called. Returns true if the block at blockLocation is solid.

This function can't be called in read-only mode.

Throws

This function can throw errors.

chat()

chat(message): void

Parameters

Parameter	Type
`message`	`string`

Returns

void

Remarks

This function can't be called in read-only mode.

Throws

This function can throw errors.

clearDynamicProperties()

clearDynamicProperties(): void

Returns

void

Inherited from

minecraftserver.Player.clearDynamicProperties

Remarks

Clears all dynamic properties that have been set on this entity.

Throws

This function can throw errors.

clearVelocity()

clearVelocity(): void

Returns

void

Inherited from

minecraftserver.Player.clearVelocity

Remarks

Sets the current velocity of the Entity to zero. Note that this method may not have an impact on Players.

This function can't be called in read-only mode.

Throws

This function can throw errors.

Example

// A function that throws entities up in the air
import { Entity } from '@minecraft/server';

function yeetEntity(entity: Entity) {

    // Zero out the entity's velocity before applying impulse
    entity.clearVelocity();

    // throw the zombie up in the air
    entity.applyImpulse({ x: 0, y: 15, z: 0 });
}

disconnect()

disconnect(): void

Returns

void

Remarks

Simulates and performs a disconnection of the simulated player from the world.

This function can't be called in read-only mode.

Throws

This function can throw errors.

dropSelectedItem()

dropSelectedItem(): boolean

Returns

boolean

Remarks

Drops the simulated player's selected item

This function can't be called in read-only mode.

Throws

This function can throw errors.

eatItem()

Beta

eatItem(itemStack): void

Parameters

Parameter	Type	Description
`itemStack`	`ItemStack`	The item to eat.

Returns

void

Inherited from

minecraftserver.Player.eatItem

Remarks

Eats an item, providing the item's hunger and saturation effects to the player. Can only be used on food items.

This function can't be called in read-only mode.

Throws

Throws if the item is not a food item.

extinguishFire()

extinguishFire(useEffects?): boolean

Parameters

Parameter	Type	Description
`useEffects`?	`boolean`	Whether to show any visual effects connected to the extinguishing.

Returns

boolean

Returns whether the entity was on fire.

Inherited from

minecraftserver.Player.extinguishFire

Remarks

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.

Throws

This function can throw errors.

Example

import { world, Entity, EntityComponentTypes, system } from "@minecraft/server";

function setAblaze(entity: Entity) {
    entity.setOnFire(20, true);

    system.runTimeout(() => {
        const onfire = entity.getComponent(EntityComponentTypes.OnFire);
        if (onfire) {
            world.sendMessage(`${onfire.onFireTicksRemaining} fire ticks remaining, extinguishing the entity.`);
        }
        // This will extinguish the entity
        entity.extinguishFire(true);
    }, 30); // Run in 30 ticks or ~1.5 seconds

}

fly()

fly(): void

Returns

void

Remarks

Causes the simulated player to start flying as though they were flying in creative mode. For flying with Elytra, see function glide.

This function can't be called in read-only mode.

Throws

This function can throw errors.

getBlockFromViewDirection()

getBlockFromViewDirection(options?): BlockRaycastHit

Parameters

Parameter	Type	Description
`options`?	`BlockRaycastOptions`	Additional configuration options for the ray cast.

Returns

BlockRaycastHit

Returns the first intersecting block from the direction that this entity is looking at.

Inherited from

minecraftserver.Player.getBlockFromViewDirection

Remarks

Returns the first intersecting block from the direction that this entity is looking at.

Throws

This function can throw errors.

getComponent()

getComponent<T>(componentId): EntityComponentTypeMap[T]

Type parameters

Type parameter
`T` extends keyof `EntityComponentTypeMap`

Parameters

Parameter	Type	Description
`componentId`	`T`	The identifier of the component (e.g., 'minecraft:health'). If no namespace prefix is specified, 'minecraft:' is assumed. Available component IDs can be found as part of the EntityComponentTypes enum.

Returns

EntityComponentTypeMap[T]

Returns the component if it exists on the entity, otherwise undefined.

Inherited from

minecraftserver.Player.getComponent

Remarks

Gets a component (that represents additional capabilities) for an entity.

getComponents()

getComponents(): EntityComponent[]

Returns

EntityComponent[]

Returns all components that are both present on this entity and supported by the API.

Inherited from

minecraftserver.Player.getComponents

Remarks

Returns all components that are both present on this entity and supported by the API.

getDynamicProperty()

getDynamicProperty(identifier): string | number | boolean | Vector3

Parameters

Parameter	Type	Description
`identifier`	`string`	The property identifier.

Returns

string | number | boolean | Vector3

Returns the value for the property, or undefined if the property has not been set.

Inherited from

minecraftserver.Player.getDynamicProperty

Remarks

Returns a property value.

Throws

This function can throw errors.

getDynamicPropertyIds()

getDynamicPropertyIds(): string[]

Returns

string[]

A string array of the dynamic properties set on this entity.

Inherited from

minecraftserver.Player.getDynamicPropertyIds

Remarks

Returns the available set of dynamic property identifiers that have been used on this entity.

Throws

This function can throw errors.

getDynamicPropertyTotalByteCount()

getDynamicPropertyTotalByteCount(): number

Returns

number

Inherited from

minecraftserver.Player.getDynamicPropertyTotalByteCount

Remarks

Returns the total size, in bytes, of all the dynamic properties that are currently stored for this entity. This includes the size of both the key and the value. This can be useful for diagnosing performance warning signs - if, for example, an entity has many megabytes of associated dynamic properties, it may be slow to load on various devices.

Throws

This function can throw errors.

getEffect()

getEffect(effectType): Effect

Parameters

Parameter	Type	Description
`effectType`	`string` \| `EffectType`	The effect identifier.

Returns

Effect

Effect object for the specified effect, undefined if the effect is not present, or throws an error if the effect does not exist.

Inherited from

minecraftserver.Player.getEffect

Remarks

Returns the effect for the specified EffectType on the entity, undefined if the effect is not present, or throws an error if the effect does not exist.

Throws

This function can throw errors.

getEffects()

getEffects(): Effect[]

Returns

Effect[]

List of effects.

Inherited from

minecraftserver.Player.getEffects

Remarks

Returns a set of effects applied to this entity.

Throws

This function can throw errors.

getEntitiesFromViewDirection()

getEntitiesFromViewDirection(options?): EntityRaycastHit[]

Parameters

Parameter	Type	Description
`options`?	`EntityRaycastOptions`	Additional configuration options for the ray cast.

Returns

EntityRaycastHit[]

Returns a set of entities from the direction that this entity is looking at.

Inherited from

minecraftserver.Player.getEntitiesFromViewDirection

Remarks

Gets the entities that this entity is looking at by performing a ray cast from the view of this entity.

Throws

This function can throw errors.

getGameMode()

Beta

getGameMode(): GameMode

Returns

GameMode

Inherited from

minecraftserver.Player.getGameMode

Throws

This function can throw errors.

getHeadLocation()

getHeadLocation(): Vector3

Returns

Vector3

Returns the current location of the head component of this entity.

Inherited from

minecraftserver.Player.getHeadLocation

Remarks

Returns the current location of the head component of this entity.

Throws

This function can throw errors.

getItemCooldown()

Beta

getItemCooldown(cooldownCategory): number

Parameters

Parameter	Type	Description
`cooldownCategory`	`string`	Specifies the cooldown category to retrieve the current cooldown for.

Returns

number

Inherited from

minecraftserver.Player.getItemCooldown

Remarks

Gets the current item cooldown time for a particular cooldown category.

Throws

This function can throw errors.

getProperty()

getProperty(identifier): string | number | boolean

Parameters

Parameter	Type	Description
`identifier`	`string`	The entity Property identifier.

Returns

string | number | boolean

Returns the current property value. For enum properties, a string is returned. For float and int properties, a number is returned. For undefined properties, undefined is returned.

Inherited from

minecraftserver.Player.getProperty

Remarks

Gets an entity Property value. If the property was set using the setProperty function within the same tick, the updated value will not be reflected until the subsequent tick.

Throws

Throws if the entity is invalid.

getRotation()

getRotation(): Vector2

Returns

Vector2

Returns a Vec2 containing the rotation of this entity (in degrees).

Inherited from

minecraftserver.Player.getRotation

Remarks

Returns the current rotation component of this entity.

Throws

This function can throw errors.

getSpawnPoint()

getSpawnPoint(): DimensionLocation

Returns

DimensionLocation

Inherited from

minecraftserver.Player.getSpawnPoint

Remarks

Gets the current spawn point of the player.

Throws

This function can throw errors.

getTags()

getTags(): string[]

Returns

string[]

An array containing all tags as strings.

Inherited from

minecraftserver.Player.getTags

Remarks

Returns all tags associated with the entity.

Throws

This function can throw errors.

getTotalXp()

getTotalXp(): number

Returns

number

Inherited from

minecraftserver.Player.getTotalXp

Remarks

Gets the total experience of the Player.

Throws

This function can throw errors.

getVelocity()

getVelocity(): Vector3

Returns

Vector3

Returns the current velocity vector of the entity.

Inherited from

minecraftserver.Player.getVelocity

Remarks

Returns the current velocity vector of the entity.

Throws

This function can throw errors.

Example

// A function that spawns fireworks and logs their velocity after 5 ticks
import { DimensionLocation, system, world } from '@minecraft/server';
import { MinecraftEntityTypes } from '@minecraft/vanilla-data';

function spawnFireworks(location: DimensionLocation) {
    const fireworkRocket = location.dimension.spawnEntity(MinecraftEntityTypes.FireworksRocket, location);

    system.runTimeout(() => {
        const velocity = fireworkRocket.getVelocity();

        world.sendMessage(`Velocity of firework is: ${velocity.x}, ${velocity.y}, ${velocity.z}`);
    }, 5);
}

getViewDirection()

getViewDirection(): Vector3

Returns

Vector3

Returns the current view direction of the entity.

Inherited from

minecraftserver.Player.getViewDirection

Remarks

Returns the current view direction of the entity.

Throws

This function can throw errors.

giveItem()

giveItem(itemStack, selectSlot?): boolean

Parameters

Parameter	Type	Description
`itemStack`	`ItemStack`	Item to give.
`selectSlot`?	`boolean`	Whether to set the selected slot once given.

Returns

boolean

Remarks

Gives the simulated player a particular item stack.

This function can't be called in read-only mode.

Throws

This function can throw errors.

glide()

glide(): boolean

Returns

boolean

Returns true if the simulated player begins to glide. Returns false if the player is already gliding, or the player does not have Elytra equipped, is in water or is on the ground.

Remarks

Causes the simulated player to start gliding. Elytra must be equipped and the player must be in the air.

This function can't be called in read-only mode.

Throws

This function can throw errors.

hasComponent()

hasComponent(componentId): boolean

Parameters

Parameter	Type	Description
`componentId`	`string`	The identifier of the component (e.g., 'minecraft:rideable') to retrieve. If no namespace prefix is specified, 'minecraft:' is assumed.

Returns

boolean

Returns true if the specified component is present on this entity.

Inherited from

minecraftserver.Player.hasComponent

Remarks

Returns true if the specified component is present on this entity.

hasTag()

hasTag(tag): boolean

Parameters

Parameter	Type	Description
`tag`	`string`	Identifier of the tag to test for.

Returns

boolean

Returns whether an entity has a particular tag.

Inherited from

minecraftserver.Player.hasTag

Remarks

Returns whether an entity has a particular tag.

Throws

This function can throw errors.

interact()

interact(): boolean

Returns

boolean

Remarks

Performs a raycast from the player’s head and interacts with the first intersected block or entity. Returns true if the interaction was successful. Maximum range is 6 blocks.

This function can't be called in read-only mode.

Throws

This function can throw errors.

interactWithBlock()

interactWithBlock(blockLocation, direction?): boolean

Parameters

Parameter	Type	Description
`blockLocation`	`Vector3`	Location of the block to interact with.
`direction`?	`Direction`	Direction to place the specified item within.

Returns

boolean

Remarks

Causes the simulated player to interact with a block. The block at the specified block location must be solid. Returns true if the interaction was performed.

This function can't be called in read-only mode.

Throws

This function can throw errors.

interactWithEntity()

interactWithEntity(entity): boolean

Parameters

Parameter	Type	Description
`entity`	`Entity`	Entity to interact with.

Returns

boolean

Remarks

Causes the simulated player to interact with a mob. Returns true if the interaction was performed.

This function can't be called in read-only mode.

Throws

This function can throw errors.

isOp()

Beta

isOp(): boolean

Returns

boolean

Inherited from

minecraftserver.Player.isOp

Remarks

Returns true if this player has operator-level permissions.

Throws

This function can throw errors.

isValid()

isValid(): boolean

Returns

boolean

Whether the entity is valid.

Inherited from

minecraftserver.Player.isValid

Remarks

Returns whether the entity can be manipulated by script. A Player is considered valid when it's EntityLifetimeState is set to Loaded.

jump()

jump(): boolean

Returns

boolean

True if a jump was performed.

Remarks

Causes the simulated player to jump.

This function can't be called in read-only mode.

Throws

This function can throw errors.

kill()

kill(): boolean

Returns

boolean

Returns true if entity can be killed (even if it is already dead), otherwise it returns false.

Inherited from

minecraftserver.Player.kill

Remarks

Kills this entity. The entity will drop loot as normal.

This function can't be called in read-only mode.

Throws

This function can throw errors.

Example

import { EntityQueryOptions, DimensionLocation } from '@minecraft/server';

function mobParty(targetLocation: DimensionLocation) {
    const mobs = ['creeper', 'skeleton', 'sheep'];

    // create some sample mob data
    for (let i = 0; i < 10; i++) {
        const mobTypeId = mobs[i % mobs.length];
        const entity = targetLocation.dimension.spawnEntity(mobTypeId, targetLocation);
        entity.addTag('mobparty.' + mobTypeId);
    }

    const eqo: EntityQueryOptions = {
        tags: ['mobparty.skeleton'],
    };

    for (const entity of targetLocation.dimension.getEntities(eqo)) {
        entity.kill();
    }
}

lookAtBlock()

lookAtBlock(blockLocation, duration?): void

Parameters

Parameter	Type
`blockLocation`	`Vector3`
`duration`?	`LookDuration`

Returns

void

Remarks

Rotates the simulated player's head/body to look at the given block location.

This function can't be called in read-only mode.

Throws

This function can throw errors.

lookAtEntity()

lookAtEntity(entity, duration?): void

Parameters

Parameter	Type
`entity`	`Entity`
`duration`?	`LookDuration`

Returns

void

Remarks

Rotates the simulated player's head/body to look at the given entity.

This function can't be called in read-only mode.

Throws

This function can throw errors.

lookAtLocation()

lookAtLocation(location, duration?): void

Parameters

Parameter	Type
`location`	`Vector3`
`duration`?	`LookDuration`

Returns

void

Remarks

Rotates the simulated player's head/body to look at the given location.

This function can't be called in read-only mode.

Throws

This function can throw errors.

matches()

matches(options): boolean

Parameters

Parameter	Type	Description
`options`	`EntityQueryOptions`	The query to perform the match against.

Returns

boolean

Returns true if the entity matches the criteria in the passed in EntityQueryOptions, otherwise it returns false.

Inherited from

minecraftserver.Player.matches

Remarks

Matches the entity against the passed in options. Uses the location of the entity for matching if the location is not specified in the passed in EntityQueryOptions.

Throws

Throws if the query options are misconfigured.

move()

move(westEast, northSouth, speed?): void

Parameters

Parameter	Type
`westEast`	`number`
`northSouth`	`number`
`speed`?	`number`

Returns

void

Remarks

Orders the simulated player to walk in the given direction relative to the GameTest.

This function can't be called in read-only mode.

Throws

This function can throw errors.

moveRelative()

moveRelative(leftRight, backwardForward, speed?): void

Parameters

Parameter	Type
`leftRight`	`number`
`backwardForward`	`number`
`speed`?	`number`

Returns

void

Remarks

Orders the simulated player to walk in the given direction relative to the player's current rotation.

This function can't be called in read-only mode.

Throws

This function can throw errors.

moveToBlock()

moveToBlock(blockLocation, options?): void

Parameters

Parameter	Type
`blockLocation`	`Vector3`
`options`?	`MoveToOptions`

Returns

void

Remarks

Orders the simulated player to move to the given block location in a straight line. If a move or navigation is already playing, this will override the last move/navigation.

This function can't be called in read-only mode.

Throws

This function can throw errors.

moveToLocation()

moveToLocation(location, options?): void

Parameters

Parameter	Type
`location`	`Vector3`
`options`?	`MoveToOptions`

Returns

void

Remarks

Orders the simulated player to move to the given location in a straight line. If a move or navigation is already playing, this will override the last move/navigation.

This function can't be called in read-only mode.

Throws

This function can throw errors.

navigateToBlock()

navigateToBlock(blockLocation, speed?): NavigationResult

Parameters

Parameter	Type
`blockLocation`	`Vector3`
`speed`?	`number`

Returns

NavigationResult

Remarks

Orders the simulated player to move to a specific block location using navigation. If a move or navigation is already playing, this will override the last move/walk. Note that if the simulated player gets stuck, that simulated player will stop. The player must be touching the ground in order to start navigation.

This function can't be called in read-only mode.

Throws

This function can throw errors.

navigateToEntity()

navigateToEntity(entity, speed?): NavigationResult

Parameters

Parameter	Type
`entity`	`Entity`
`speed`?	`number`

Returns

NavigationResult

Remarks

Will use navigation to follow the selected entity to within a one block radius. If a move or navigation is already playing, this will override the last move/navigation.

This function can't be called in read-only mode.

Throws

This function can throw errors.

navigateToLocation()

navigateToLocation(location, speed?): NavigationResult

Parameters

Parameter	Type
`location`	`Vector3`
`speed`?	`number`

Returns

NavigationResult

Remarks

Orders the simulated player to move to a specific location using navigation. If a move or navigation is already playing, this will override the last move/walk. Note that if the simulated player gets stuck, that simulated player will stop. The player must be touching the ground in order to start navigation.

This function can't be called in read-only mode.

Throws

This function can throw errors.

navigateToLocations()

navigateToLocations(locations, speed?): void

Parameters

Parameter	Type	Description
`locations`	`Vector3`[]	A list of locations to use for routing.
`speed`?	`number`	Net speed to use for doing the navigation.

Returns

void

Remarks

Use navigation to follow the route provided via the locations parameter. If a move or navigation is already playing, this will override the last move/navigation.

This function can't be called in read-only mode.

Throws

This function can throw errors.

playAnimation()

playAnimation(animationName, options?): void

Parameters

Parameter	Type	Description
`animationName`	`string`	The animation identifier. e.g. animation.creeper.swelling
`options`?	`PlayAnimationOptions`	Additional options to control the playback and transitions of the animation.

Returns

void

Inherited from

minecraftserver.Player.playAnimation

Remarks

Cause the entity to play the given animation.

This function can't be called in read-only mode.

Throws

This function can throw errors.

playMusic()

playMusic(trackId, musicOptions?): void

Parameters

Parameter	Type	Description
`trackId`	`string`	Identifier of the music track to play.
`musicOptions`?	`MusicOptions`	Additional options for the music track.

Returns

void

Inherited from

minecraftserver.Player.playMusic

Remarks

Plays a music track that only this particular player can hear.

This function can't be called in read-only mode.

Throws

This function can throw errors.

playSound()

playSound(soundId, soundOptions?): void

Parameters

Parameter	Type	Description
`soundId`	`string`	-
`soundOptions`?	`PlayerSoundOptions`	Additional optional options for the sound.

Returns

void

Inherited from

minecraftserver.Player.playSound

Remarks

Plays a sound that only this particular player can hear.

This function can't be called in read-only mode.

Throws

This function can throw errors.

postClientMessage()

Beta

postClientMessage(id, value): void

Parameters

Parameter	Type
`id`	`string`
`value`	`string`

Returns

void

Inherited from

minecraftserver.Player.postClientMessage

Remarks

This is an internal-facing method for posting a system message to downstream clients.

This function can't be called in read-only mode.

Throws

This function can throw errors.

queueMusic()

queueMusic(trackId, musicOptions?): void

Parameters

Parameter	Type	Description
`trackId`	`string`	Identifier of the music track to play.
`musicOptions`?	`MusicOptions`	Additional options for the music track.

Returns

void

Inherited from

minecraftserver.Player.queueMusic

Remarks

Queues an additional music track that only this particular player can hear. If a track is not playing, a music track will play.

This function can't be called in read-only mode.

Throws

An error will be thrown if volume is less than 0.0. An error will be thrown if fade is less than 0.0.

remove()

remove(): void

Returns

void

Inherited from

minecraftserver.Player.remove

Remarks

Immediately removes the entity from the world. The removed entity will not perform a death animation or drop loot upon removal.

This function can't be called in read-only mode.

Throws

This function can throw errors.

removeEffect()

removeEffect(effectType): boolean

Parameters

Parameter	Type	Description
`effectType`	`string` \| `EffectType`	The effect identifier.

Returns

boolean

Returns true if the effect has been removed. Returns false if the effect is not found or does not exist.

Inherited from

minecraftserver.Player.removeEffect

Remarks

Removes the specified EffectType on the entity, or returns false if the effect is not present.

This function can't be called in read-only mode.

Throws

This function can throw errors.

removeTag()

removeTag(tag): boolean

Parameters

Parameter	Type	Description
`tag`	`string`	Content of the tag to remove.

Returns

boolean

Returns whether the tag existed on the entity.

Inherited from

minecraftserver.Player.removeTag

Remarks

Removes a specified tag from an entity.

This function can't be called in read-only mode.

Throws

This function can throw errors.

resetLevel()

resetLevel(): void

Returns

void

Inherited from

minecraftserver.Player.resetLevel

Remarks

Resets the level of the player.

This function can't be called in read-only mode.

Throws

This function can throw errors.

resetProperty()

resetProperty(identifier): string | number | boolean

Parameters

Parameter	Type	Description
`identifier`	`string`	The Entity Property identifier.

Returns

string | number | boolean

Returns the default property value. For enum properties, a string is returned. For float and int properties, a number is returned. For undefined properties, undefined is returned.

Inherited from

minecraftserver.Player.resetProperty

Remarks

Resets an Entity Property back to its default value, as specified in the Entity's definition. This property change is not applied until the next tick.

This function can't be called in read-only mode.

Throws

Throws if the entity is invalid.

minecraftcommon.EngineError

Error

respawn()

respawn(): boolean

Returns

boolean

Remarks

Respawns the particular simulated player.

This function can't be called in read-only mode.

Throws

This function can throw errors.

rotateBody()

rotateBody(angleInDegrees): void

Parameters

Parameter	Type
`angleInDegrees`	`number`

Returns

void

Remarks

Causes the simulated player to turn by the provided angle, relative to the player's current rotation.

This function can't be called in read-only mode.

Throws

This function can throw errors.

runCommand()

runCommand(commandString): CommandResult

Parameters

Parameter	Type	Description
`commandString`	`string`	The command string. Note: This should not include a leading forward slash.

Returns

CommandResult

A command result containing whether the command was successful.

Inherited from

minecraftserver.Player.runCommand

Remarks

Runs a synchronous command on the entity.

This function can't be called in read-only mode.

Throws

This function can throw errors.

CommandError

Error

runCommandAsync()

runCommandAsync(commandString): Promise ↗️<CommandResult>

Parameters

Parameter	Type	Description
`commandString`	`string`	Command to run. Note that command strings should not start with slash.

Returns

Promise ↗️<CommandResult>

For commands that return data, returns a JSON structure with command response values.

Inherited from

minecraftserver.Player.runCommandAsync

Remarks

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.

Throws

This function can throw errors.

sendMessage()

sendMessage(message): void

Parameters

Parameter	Type	Description
`message`	`string` \| `RawMessage` \| (`string` \| `RawMessage`)[]	The message to be displayed.

Returns

void

Inherited from

minecraftserver.Player.sendMessage

Remarks

Sends a message to the player.

Throws

This method can throw if the provided RawMessage is in an invalid format. For example, if an empty name string is provided to score.

Example

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

function sendPlayerMessages(player: Player) {
    // Displays "First or Second"
    const rawMessage = { translate: 'accessibility.list.or.two', with: ['First', 'Second'] };
    player.sendMessage(rawMessage);

    // Displays "Hello, world!"
    player.sendMessage('Hello, world!');

    // Displays "Welcome, Amazing Player 1!"
    player.sendMessage({ translate: 'authentication.welcome', with: ['Amazing Player 1'] });

    // Displays the player's score for objective "obj". Each player will see their own score.
    const rawMessageWithScore = { score: { name: '*', objective: 'obj' } };
    player.sendMessage(rawMessageWithScore);

    // Displays "Apple or Coal"
    const rawMessageWithNestedTranslations = {
        translate: 'accessibility.list.or.two',
        with: { rawtext: [{ translate: 'item.apple.name' }, { translate: 'item.coal.name' }] },
    };
    player.sendMessage(rawMessageWithNestedTranslations);
}

setBodyRotation()

setBodyRotation(angleInDegrees): void

Parameters

Parameter	Type
`angleInDegrees`	`number`

Returns

void

Remarks

Causes the simulated player to turn to face the provided angle, relative to the GameTest.

This function can't be called in read-only mode.

Throws

This function can throw errors.

setDynamicProperty()

setDynamicProperty(identifier, value?): void

Parameters

Parameter	Type	Description
`identifier`	`string`	The property identifier.
`value`?	`string` \| `number` \| `boolean` \| `Vector3`	Data value of the property to set.

Returns

void

Inherited from

minecraftserver.Player.setDynamicProperty

Remarks

Sets a specified property to a value.

Throws

This function can throw errors.

setGameMode()

Beta

setGameMode(gameMode?): void

Parameters

Parameter	Type
`gameMode`?	`GameMode`

Returns

void

Inherited from

minecraftserver.Player.setGameMode

Remarks

This function can't be called in read-only mode.

Throws

This function can throw errors.

setItem()

setItem(itemStack, slot, selectSlot?): boolean

Parameters

Parameter	Type	Description
`itemStack`	`ItemStack`	Item to set.
`slot`	`number`	Slot to place the given item in.
`selectSlot`?	`boolean`	Whether to set the selected slot once set.

Returns

boolean

Remarks

Sets a particular item for the simulated player.

This function can't be called in read-only mode.

Throws

This function can throw errors.

setOnFire()

setOnFire(seconds, useEffects?): boolean

Parameters

Parameter	Type	Description
`seconds`	`number`	Length of time to set the entity on fire.
`useEffects`?	`boolean`	Whether side-effects should be applied (e.g. thawing freeze) and other conditions such as rain or fire protection should be taken into consideration.

Returns

boolean

Whether the entity was set on fire. This can fail if seconds is less than or equal to zero, the entity is wet or the entity is immune to fire.

Inherited from

minecraftserver.Player.setOnFire

Remarks

Sets 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.

Throws

This function can throw errors.

Example

import { world, Entity, EntityComponentTypes, system } from "@minecraft/server";

function setAblaze(entity: Entity) {
    entity.setOnFire(20, true);

    system.runTimeout(() => {
        const onfire = entity.getComponent(EntityComponentTypes.OnFire);
        if (onfire) {
            world.sendMessage(`${onfire.onFireTicksRemaining} fire ticks remaining, extinguishing the entity.`);
        }
        // This will extinguish the entity
        entity.extinguishFire(true);
    }, 30); // Run in 30 ticks or ~1.5 seconds

}

setOp()

Beta

setOp(isOp): void

Parameters

Parameter	Type
`isOp`	`boolean`

Returns

void

Inherited from

minecraftserver.Player.setOp

Remarks

Will change the specified players permissions, and whether they are operator or not.

This function can't be called in read-only mode.

Throws

This function can throw errors.

setProperty()

setProperty(identifier, value): void

Parameters

Parameter	Type	Description
`identifier`	`string`	The Entity Property identifier.
`value`	`string` \| `number` \| `boolean`	The property value. The provided type must be compatible with the type specified in the entity's definition.

Returns

void

Inherited from

minecraftserver.Player.setProperty

Remarks

Sets an Entity Property to the provided value. This property change is not applied until the next tick.

This function can't be called in read-only mode.

Throws

Throws if the entity is invalid. Throws if an invalid identifier is provided. Throws if the provided value type does not match the property type. Throws if the provided value is outside the expected range (int, float properties). Throws if the provided string value does not match the set of accepted enum values (enum properties

setRotation()

setRotation(rotation): void

Parameters

Parameter	Type	Description
`rotation`	`Vector2`	The x and y rotation of the entity (in degrees). For most mobs, the x rotation controls the head tilt and the y rotation controls the body rotation.

Returns

void

Inherited from

minecraftserver.Player.setRotation

Remarks

Sets the main rotation of the entity.

This function can't be called in read-only mode.

Throws

This function can throw errors.

setSpawnPoint()

setSpawnPoint(spawnPoint?): void

Parameters

Parameter	Type
`spawnPoint`?	`DimensionLocation`

Returns

void

Inherited from

minecraftserver.Player.setSpawnPoint

Remarks

Sets the current starting spawn point for this particular player.

This function can't be called in read-only mode.

Throws

This function can throw errors.

Error

LocationOutOfWorldBoundariesError

spawnParticle()

Beta

spawnParticle(effectName, location, molangVariables?): void

Parameters

Parameter	Type	Description
`effectName`	`string`	Identifier of the particle to create.
`location`	`Vector3`	The location at which to create the particle emitter.
`molangVariables`?	`MolangVariableMap`	A set of optional, customizable variables that can be adjusted for this particle.

Returns

void

Inherited from

minecraftserver.Player.spawnParticle

Remarks

Creates a new particle emitter at a specified location in the world. Only visible to the target player.

This function can't be called in read-only mode.

Throws

This function can throw errors.

Error

LocationInUnloadedChunkError

LocationOutOfWorldBoundariesError

Example

import { world, MolangVariableMap, Vector3 } from '@minecraft/server';

world.afterEvents.playerSpawn.subscribe(event => {
    const targetLocation = event.player.location;
    for (let i = 0; i < 100; i++) {
        const molang = new MolangVariableMap();

        molang.setColorRGB('variable.color', {
            red: Math.random(),
            green: Math.random(),
            blue: Math.random()
        });

        const newLocation: Vector3 = {
            x: targetLocation.x + Math.floor(Math.random() * 8) - 4,
            y: targetLocation.y + Math.floor(Math.random() * 8) - 4,
            z: targetLocation.z + Math.floor(Math.random() * 8) - 4,
        };
        event.player.spawnParticle('minecraft:colored_flame_particle', newLocation, molang);
    }
});

startBuild()

startBuild(slot?): void

Parameters

Parameter	Type
`slot`?	`number`

Returns

void

Remarks

This function can't be called in read-only mode.

Throws

This function can throw errors.

startItemCooldown()

Beta

startItemCooldown(cooldownCategory, tickDuration): void

Parameters

Parameter	Type	Description
`cooldownCategory`	`string`	Specifies the cooldown category to retrieve the current cooldown for.
`tickDuration`	`number`	Duration in ticks of the item cooldown.

Returns

void

Inherited from

minecraftserver.Player.startItemCooldown

Remarks

Sets the item cooldown time for a particular cooldown category.

This function can't be called in read-only mode.

Throws

This function can throw errors.

stopBreakingBlock()

stopBreakingBlock(): void

Returns

void

Remarks

Stops destroying the block that is currently being hit.

This function can't be called in read-only mode.

Throws

This function can throw errors.

stopBuild()

stopBuild(): void

Returns

void

Remarks

This function can't be called in read-only mode.

Throws

This function can throw errors.

stopFlying()

stopFlying(): void

Returns

void

Remarks

Causes the simulated player to stop flying.

This function can't be called in read-only mode.

Throws

This function can throw errors.

stopGliding()

stopGliding(): void

Returns

void

Remarks

Causes the simulated player to stop gliding.

This function can't be called in read-only mode.

Throws

This function can throw errors.

stopInteracting()

stopInteracting(): void

Returns

void

Remarks

Stops interacting with entities or blocks.

This function can't be called in read-only mode.

Throws

This function can throw errors.

stopMoving()

stopMoving(): void

Returns

void

Remarks

Stops moving/walking/following if the simulated player is moving.

This function can't be called in read-only mode.

Throws

This function can throw errors.

stopMusic()

stopMusic(): void

Returns

void

Inherited from

minecraftserver.Player.stopMusic

Remarks

Stops any music tracks from playing for this particular player.

This function can't be called in read-only mode.

Throws

This function can throw errors.

stopSwimming()

stopSwimming(): void

Returns

void

Remarks

Causes the simulated player to stop swimming.

This function can't be called in read-only mode.

Throws

This function can throw errors.

stopUsingItem()

stopUsingItem(): ItemStack

Returns

ItemStack

Returns the item that was in use. Undefined if no item was in use.

Remarks

Stops using the currently active item.

This function can't be called in read-only mode.

Throws

This function can throw errors.

swim()

swim(): void

Returns

void

Remarks

Causes the simulated player to start swimming.

This function can't be called in read-only mode.

Throws

This function can throw errors.

teleport()

teleport(location, teleportOptions?): void

Parameters

Parameter	Type	Description
`location`	`Vector3`	New location for the entity.
`teleportOptions`?	`TeleportOptions`	Options regarding the teleport operation.

Returns

void

Inherited from

minecraftserver.Player.teleport

Remarks

Teleports the selected entity to a new location

This function can't be called in read-only mode.

Throws

This function can throw errors.

Example

import { world, system } from '@minecraft/server';

const overworld = world.getDimension('overworld');
const targetLocation = { x: 0, y: 0, z: 0 };

const pig = overworld.spawnEntity('minecraft:pig', targetLocation);

let inc = 1;
const runId = system.runInterval(() => {
    pig.teleport(
        { x: targetLocation.x + inc / 4, y: targetLocation.y + inc / 4, z: targetLocation.z + inc / 4 },
        {
            facingLocation: targetLocation,
        },
    );

    if (inc > 100) {
        system.clearRun(runId);
    }
    inc++;
}, 4);

triggerEvent()

triggerEvent(eventName): void

Parameters

Parameter	Type	Description
`eventName`	`string`	Name of the entity type event to trigger. If a namespace is not specified, minecraft: is assumed.

Returns

void

Inherited from

minecraftserver.Player.triggerEvent

Remarks

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.

Throws

If the event is not defined in the definition of the entity, an error will be thrown.

Example

// A function that spawns a creeper and triggers it to explode immediately
import { DimensionLocation } from '@minecraft/server';
import { MinecraftEntityTypes } from '@minecraft/vanilla-data';

function spawnExplodingCreeper(location: DimensionLocation) {
    const creeper = location.dimension.spawnEntity(MinecraftEntityTypes.Creeper, location);

    creeper.triggerEvent('minecraft:start_exploding_forced');
}

tryTeleport()

tryTeleport(location, teleportOptions?): boolean

Parameters

Parameter	Type	Description
`location`	`Vector3`	Location to teleport the entity to.
`teleportOptions`?	`TeleportOptions`	Options regarding the teleport operation.

Returns

boolean

Returns whether the teleport succeeded. This can fail if the destination chunk is unloaded or if the teleport would result in intersecting with blocks.

Inherited from

minecraftserver.Player.tryTeleport

Remarks

Attempts to try a teleport, but may not complete the teleport operation (for example, if there are blocks at the destination.)

This function can't be called in read-only mode.

Throws

This function can throw errors.

useItem()

useItem(itemStack): boolean

Parameters

Parameter	Type	Description
`itemStack`	`ItemStack`	Item to use.

Returns

boolean

Remarks

Causes the simulated player to use an item. Does not consume the item. Returns false if the item is on cooldown.

This function can't be called in read-only mode.

Throws

This function can throw errors.

useItemInSlot()

useItemInSlot(slot): boolean

Parameters

Parameter	Type	Description
`slot`	`number`	Index of the inventory slot.

Returns

boolean

Remarks

Causes the simulated player to hold and use an item in their inventory.

This function can't be called in read-only mode.

Throws

This function can throw errors.

useItemInSlotOnBlock()

useItemInSlotOnBlock(slot, blockLocation, direction?, faceLocation?): boolean

Parameters

Parameter	Type	Description
`slot`	`number`	Index of the slot to use.
`blockLocation`	`Vector3`	Location to use the item upon.
`direction`?	`Direction`	Direction to place the specified item within.
`faceLocation`?	`Vector3`	Location relative to the bottom north-west corner of the block where the item is placed.

Returns

boolean

Remarks

Causes the simulated player to use an item in their inventory on a block. The block at the specified block location must be solid. Returns true if the item was used.

This function can't be called in read-only mode.

Throws

This function can throw errors.

useItemOnBlock()

useItemOnBlock(itemStack, blockLocation, direction?, faceLocation?): boolean

Parameters

Parameter	Type	Description
`itemStack`	`ItemStack`	Item to use.
`blockLocation`	`Vector3`	Location to use the item upon.
`direction`?	`Direction`	Direction to place the specified item within.
`faceLocation`?	`Vector3`	Location relative to the bottom north-west corner of the block where the item is placed.

Returns

boolean

Remarks

Causes the simulated player to use an item on a block. The block at the specified block location must be solid. Returns true if the item was used.

This function can't be called in read-only mode.

Throws

This function can throw errors.

Class: SimulatedPlayer

Extends​

Constructors​

new SimulatedPlayer()​

Returns​

Overrides​

Properties​

camera​

Remarks​

Throws​

Inherited from​

dimension​

Remarks​

Throws​

Inherited from​

fallDistance​

Remarks​

Throws​

Inherited from​

headRotation​

Remarks​

Throws​

id​

Remarks​

Inherited from​

isClimbing​

Remarks​

Throws​

Inherited from​

isEmoting​

Remarks​

Throws​

Inherited from​

isFalling​

Remarks​

Throws​

Inherited from​

isFlying​

Remarks​

Throws​

Inherited from​

isGliding​

Remarks​

Throws​

Inherited from​

isInWater​

Remarks​

Throws​

Inherited from​

isJumping​

Remarks​

Throws​

Inherited from​

isOnGround​

Remarks​

Throws​

Inherited from​

isSleeping​

Remarks​

Throws​

Inherited from​

isSneaking​

Remarks​

Inherited from​

isSprinting​

Remarks​

Overrides​

isSwimming​

Remarks​

Throws​

Inherited from​

level​

Remarks​

Throws​

Inherited from​

lifetimeState​

Remarks​

Inherited from​

location​

Remarks​

Extends

Constructors

new SimulatedPlayer()

Returns

Overrides

Properties

camera

Remarks

Throws

Inherited from

dimension

Remarks

Throws

Inherited from

fallDistance

Remarks

Throws

Inherited from

headRotation

Remarks

Throws

id

Remarks

Inherited from

isClimbing

Remarks

Throws

Inherited from

isEmoting

Remarks

Throws

Inherited from

isFalling

Remarks

Throws

Inherited from

isFlying

Remarks

Throws

Inherited from

isGliding

Remarks

Throws

Inherited from

isInWater

Remarks

Throws

Inherited from

isJumping

Remarks

Throws

Inherited from

isOnGround

Remarks

Throws

Inherited from

isSleeping

Remarks

Throws

Inherited from

isSneaking

Remarks

Inherited from

isSprinting

Remarks

Overrides

isSwimming

Remarks

Throws

Inherited from

level

Remarks

Throws

Inherited from

lifetimeState

Remarks

Inherited from

location

Remarks

Throws