MCEntity - CraftTweaker Documentation

Version:

Language:

Home Migration Guide Getting Started With Scripts Commands Examples

Importare la Classe

It might be required for you to import the package if you encounter any issues (like casting an Array), so better be safe than sorry and add the import at the very top of the file.

ZenScript
 Copy
import crafttweaker.api.entity.MCEntity;

Extending CapabilityProvider<MCEntity>

MCEntity extends CapabilityProvider<MCEntity>. That means all methods available in CapabilityProvider<MCEntity> are also available in MCEntity

Metodi

addTag

Name: addTag

Adds a new tag to the Entity.

There is a limit of 1024 tags per Entity.

These are not tags like MCTag, these are tags that are added by the /tag command.

You can read more about how they can be used here: https://minecraft.fandom.com/wiki/Commands/tag

Returns: True if the tag could ba added, and it did not replace a preexisting tag. False otherwise.
Return Type: boolean

ZenScript
 Copy
// MCEntity.addTag(tag as string) as boolean

myMCEntity.addTag("foundMesa");

Parametro	Tipo	Descrizione
Parametro tag	Tipo string	Descrizione The name of the tag to add.

addVelocity

Name: addVelocity

Adds velocity to this Entity.

Return Type: void

ZenScript
 Copy
// MCEntity.addVelocity(x as double, y as double, z as double) as void

myMCEntity.addVelocity(5, 9, -1);

Parametro	Tipo	Descrizione
Parametro x	Tipo double	Descrizione The amount of X velocity to add.
Parametro y	Tipo double	Descrizione The amount of Y velocity to add.
Parametro z	Tipo double	Descrizione The amount of Z velocity to add.

applyEntityCollision

Name: applyEntityCollision

Applies entity collision between this Entity and the other Entity, pushing them away from each other.

Return Type: void

ZenScript
 Copy
// MCEntity.applyEntityCollision(other as MCEntity) as void

myMCEntity.applyEntityCollision(entity);

Parametro	Tipo	Descrizione
Parametro other	Tipo MCEntity	Descrizione The Entity to collide with.

canSwim

Name: canSwim

Checks if this Entity can swim.

Returns: True if this Entity can swim. False otherwise.
Return Type: boolean

ZenScript
 Copy
// MCEntity.canSwim() as boolean

myMCEntity.canSwim();

changeDimension

Name: changeDimension

Teleports this Entity to the given world.

Return Type: void

ZenScript
 Copy
// MCEntity.changeDimension(world as MCServerWorld) as void

myMCEntity.changeDimension(world);

Parametro	Tipo	Descrizione
Parametro world	Tipo MCServerWorld	Descrizione The new world for the Entity.

dismount

Name: dismount

Return Type: void

ZenScript
 Copy
// MCEntity.dismount() as void

myMCEntity.dismount();

extinguish

Name: extinguish

Extinguishes the Entity if it is on fire.

Return Type: void

ZenScript
 Copy
// MCEntity.extinguish() as void

myMCEntity.extinguish();

forceFireTicks

Name: forceFireTicks

Sets the Entity on fire for the given amount of ticks.

This method can be used to override how long the Entity is on fire for.

Return Type: void

ZenScript
 Copy
// MCEntity.forceFireTicks(ticks as int) as void

myMCEntity.forceFireTicks(25);

Parametro	Tipo	Descrizione
Parametro ticks	Tipo int	Descrizione The amount of ticks the Entity should burn for.

forceSetPosition

Name: forceSetPosition

Forcefully sets this Entity to the new position.

Return Type: void

ZenScript
 Copy
// MCEntity.forceSetPosition(x as double, y as double, z as double) as void

myMCEntity.forceSetPosition(5, 2, 9);

Parametro	Tipo	Descrizione
Parametro x	Tipo double	Descrizione The new X value.
Parametro y	Tipo double	Descrizione The new Y value.
Parametro z	Tipo double	Descrizione The new Z value.

getAir

Name: getAir

Gets the air value for the Entity. The air value is used to determine when the Entity will start drowning when swimming.

Returns: The air value of the Entity.
Return Type: int

ZenScript
 Copy
// MCEntity.getAir() as int

myMCEntity.getAir();

getBrightness

Name: getBrightness

Gets how bright this Entity is.

Returns: How bright the Entity is.
Return Type: float

ZenScript
 Copy
// MCEntity.getBrightness() as float

myMCEntity.getBrightness();

getData

Name: getData

Gets the NBT data of this Entity.

Returns: The NBT data of this Entity.
Return Type: MapData

ZenScript
 Copy
// MCEntity.getData() as MapData

myMCEntity.getData();

getDistance

Name: getDistance

Gets the distance between this Entity and the given Entity.

Returns: The distance between this Entity and the other Entity.
Return Type: float

ZenScript
 Copy
// MCEntity.getDistance(other as MCEntity) as float

myMCEntity.getDistance(entity);

Parametro	Tipo	Descrizione
Parametro other	Tipo MCEntity	Descrizione The Entity to get the distance to.

getDistanceSq

Name: getDistanceSq

Gets the squared distance from this Entity to the given Entity.

Returns: The squared distance between this Entity and the other Entity.
Return Type: double

ZenScript
 Copy
// MCEntity.getDistanceSq(other as MCEntity) as double

myMCEntity.getDistanceSq(entity);

Parametro	Tipo	Descrizione
Parametro other	Tipo MCEntity	Descrizione The other Entity to check the squared distance to.

getDistanceSq

Name: getDistanceSq

Gets the squared distance from this Entity's position to the given position.

Returns: The squared distance from this Entity to the given position.
Return Type: double

ZenScript
 Copy
// MCEntity.getDistanceSq(x as double, y as double, z as double) as double

myMCEntity.getDistanceSq(5, 6, 3);

Parametro	Tipo	Descrizione
Parametro x	Tipo double	Descrizione The X value of the position to check against.
Parametro y	Tipo double	Descrizione The Y value of the position to check against.
Parametro z	Tipo double	Descrizione The Z value of the position to check against.

getEntityId

Name: getEntityId

Gets this Entity's id that can be used to reference this Entity.

Returns: The id of this Entity.
Return Type: int

ZenScript
 Copy
// MCEntity.getEntityId() as int

myMCEntity.getEntityId();

getFacingDirections

Name: getFacingDirections

Gets which directions the Entity is currently facing.

Returns: An array of direction that the Entity is currently facing
Return Type: Direction[]

ZenScript
 Copy
// MCEntity.getFacingDirections() as Direction[]

myMCEntity.getFacingDirections();

getFireTimer

Name: getFireTimer

Gets the amount of ticks the Entity will be on fire for.

Returns: The amount of ticks the Entity will be on fire for.
Return Type: int

ZenScript
 Copy
// MCEntity.getFireTimer() as int

myMCEntity.getFireTimer();

getMaxInPortalTime

Name: getMaxInPortalTime

Gets the maximum amount of time the Entity needs to be in the portal before they are teleported.

Returns: The amount of time required for the Entity to be in the nether portal before being teleported.
Return Type: int

ZenScript
 Copy
// MCEntity.getMaxInPortalTime() as int

myMCEntity.getMaxInPortalTime();

getName

Name: getName

Gets the name of the Entity.

Returns: The name of the Entity.
Return Type: string

ZenScript
 Copy
// MCEntity.getName() as string

myMCEntity.getName();

getPersistentData

Name: getPersistentData

Gets the persisted NBT tag.

Return Type: MapData

ZenScript
 Copy
// MCEntity.getPersistentData() as MapData

myMCEntity.getPersistentData();

getPosition

Name: getPosition

Gets this Entity's position in the world.

Returns: This Entity's position in the world.
Return Type: BlockPos

ZenScript
 Copy
// MCEntity.getPosition() as BlockPos

myMCEntity.getPosition();

getPositionVec

Name: getPositionVec

Return Type: MCVector3d

ZenScript
 Copy
// MCEntity.getPositionVec() as MCVector3d

myMCEntity.getPositionVec();

getRotationPitch

Name: getRotationPitch

Return Type: float

ZenScript
 Copy
// MCEntity.getRotationPitch() as float

myMCEntity.getRotationPitch();

getRotationYaw

Name: getRotationYaw

Return Type: float

ZenScript
 Copy
// MCEntity.getRotationYaw() as float

myMCEntity.getRotationYaw();

getTags

Name: getTags

Gets all the tags that are attached to the entity.

These are not tags like MCTag, these are tags that are added by the /tag command.

You can read more about how they can be used here: https://minecraft.fandom.com/wiki/Commands/tag

Returns: A set of all the Tags that an Entity has.
Return Type: Set<string>

ZenScript
 Copy
// MCEntity.getTags() as Set<string>

myMCEntity.getTags();

getType

Name: getType

Gets this Entity's type.

Returns: The type of this Entity.
Return Type: MCEntityType

ZenScript
 Copy
// MCEntity.getType() as MCEntityType

myMCEntity.getType();

getUUID

Name: getUUID

Gets the UUID of this Entity.

Returns: The UUID of this Entity.
Return Type: string

ZenScript
 Copy
// MCEntity.getUUID() as string

myMCEntity.getUUID();

getWorld

Name: getWorld

Gets the World that this Entity is in.

Returns: The World this Entity is in.
Return Type: MCWorld

ZenScript
 Copy
// MCEntity.getWorld() as MCWorld

myMCEntity.getWorld();

hasNoGravity

Name: hasNoGravity

Checks if this Entity has no gravity.

Returns: True if this Entity does not have gravity. False otherwise.
Return Type: boolean

ZenScript
 Copy
// MCEntity.hasNoGravity() as boolean

myMCEntity.hasNoGravity();

isEntityInRange

Name: isEntityInRange

Checks if this Entity is in the given range (distance) of the other Entity.

Returns: True if this Entity is in range. False otherwise.
Return Type: boolean

ZenScript
 Copy
// MCEntity.isEntityInRange(entity as MCEntity, distance as double) as boolean

myMCEntity.isEntityInRange(entity, 2.5);

Parametro	Tipo	Descrizione
Parametro entity	Tipo MCEntity	Descrizione The Entity to check if it is in range.
Parametro distance	Tipo double	Descrizione The distance to check for.

isImmuneToFire

Name: isImmuneToFire

Checks if this Entity is immune to fire.

Returns: True if this Entity is immune to fire. False otherwise.
Return Type: boolean

ZenScript
 Copy
// MCEntity.isImmuneToFire() as boolean

myMCEntity.isImmuneToFire();

isInLava

Name: isInLava

Checks if this Entity is in lava or not.

Returns: True if the this Entity is in lava.
Return Type: boolean

ZenScript
 Copy
// MCEntity.isInLava() as boolean

myMCEntity.isInLava();

isInWater

Name: isInWater

Checks if this Entity is in water.

Returns: True if this Entity is in water. False otherwise.
Return Type: boolean

ZenScript
 Copy
// MCEntity.isInWater() as boolean

myMCEntity.isInWater();

isInWaterOrBubbleColumn

Name: isInWaterOrBubbleColumn

Checks if this Entity is in water or a bubble column.

Returns: True if this entity is in water or a bubble column. False otherwise.
Return Type: boolean

ZenScript
 Copy
// MCEntity.isInWaterOrBubbleColumn() as boolean

myMCEntity.isInWaterOrBubbleColumn();

isInWaterRainOrBubbleColumn

Name: isInWaterRainOrBubbleColumn

Checks if this Entity is in rain or a bubble column.

Returns: True if this entity is in rain or a bubble column. False otherwise.
Return Type: boolean

ZenScript
 Copy
// MCEntity.isInWaterRainOrBubbleColumn() as boolean

myMCEntity.isInWaterRainOrBubbleColumn();

isOffsetPositionInLiquid

Name: isOffsetPositionInLiquid

Checks if the offset position from the Entity's current position is inside of a liquid.

Returns: True if the offset position is in a liquid. False otherwise.
Return Type: boolean

ZenScript
 Copy
// MCEntity.isOffsetPositionInLiquid(x as double, y as double, z as double) as boolean

myMCEntity.isOffsetPositionInLiquid(5, 4, 5);

Parametro	Tipo	Descrizione
Parametro x	Tipo double	Descrizione The X offset.
Parametro y	Tipo double	Descrizione The Y offset.
Parametro z	Tipo double	Descrizione The Z offset.

isOnGround

Name: isOnGround

Checks whether the Entity is on the ground or not.

Returns: True if the Entity is on the ground. False otherwise.
Return Type: boolean

ZenScript
 Copy
// MCEntity.isOnGround() as boolean

myMCEntity.isOnGround();

isSilent

Name: isSilent

Checks if this Entity is silent.

Silent Entities do not play sounds.

Returns: True if this Entity is silent. False otherwise.
Return Type: boolean

ZenScript
 Copy
// MCEntity.isSilent() as boolean

myMCEntity.isSilent();

isSneaking

Name: isSneaking

Checks if this Entity is sneaking or not.

Returns: True if sneaking. False otherwise.
Return Type: boolean

ZenScript
 Copy
// MCEntity.isSneaking() as boolean

myMCEntity.isSneaking();

isSpectator

Name: isSpectator

Checks if this Entity is in spectator mode.

Returns: True if this Entity is in spectator mode. False otherwise.
Return Type: boolean

ZenScript
 Copy
// MCEntity.isSpectator() as boolean

myMCEntity.isSpectator();

isWet

Name: isWet

Checks if this Entity is wet.

Returns: True if this Entity is wet. False otherwise.
Return Type: boolean

ZenScript
 Copy
// MCEntity.isWet() as boolean

myMCEntity.isWet();

moveForced

Name: moveForced

Forcefully moves this Entity to the new position.

Return Type: void

ZenScript
 Copy
// MCEntity.moveForced(x as double, y as double, z as double) as void

myMCEntity.moveForced(5, 2, 9);

Parametro	Tipo	Descrizione
Parametro x	Tipo double	Descrizione The new X value.
Parametro y	Tipo double	Descrizione The new Y value.
Parametro z	Tipo double	Descrizione The new Z value.

onCollideWithPlayer

Name: onCollideWithPlayer

Triggers the collide effect between this Entity and the player.

Some examples of collide effects are: Puffer fish damaging and applying poison. Experience orbs being collected.

Return Type: void

ZenScript
 Copy
// MCEntity.onCollideWithPlayer(playerEntity as MCPlayerEntity) as void

myMCEntity.onCollideWithPlayer(player);

Parametro	Tipo	Descrizione
Parametro playerEntity	Tipo MCPlayerEntity	Descrizione The player to collide with.

onKillCommand

Name: onKillCommand

Can be used to simulate the /kill command being used on the Entity.

Return Type: void

ZenScript
 Copy
// MCEntity.onKillCommand() as void

myMCEntity.onKillCommand();

onLivingFall

Name: onLivingFall

Can be used to simulate the Entity falling the given distance with the given damage multiplier.

Returns: True if the Entity took damage. False otherwise.
Return Type: boolean

ZenScript
 Copy
// MCEntity.onLivingFall(distance as float, damageMultiplier as float) as boolean

myMCEntity.onLivingFall(5, 5);

Parametro	Tipo	Descrizione
Parametro distance	Tipo float	Descrizione The distance the Entity has fallen.
Parametro damageMultiplier	Tipo float	Descrizione The damage multiplier.

remove

Name: remove

Removes the entity from the world.

Return Type: void

ZenScript
 Copy
// MCEntity.remove() as void

myMCEntity.remove();

removePassengers

Name: removePassengers

Return Type: void

ZenScript
 Copy
// MCEntity.removePassengers() as void

myMCEntity.removePassengers();

removeTag

Name: removeTag

Removes a tag from the Entity.

These are not tags like MCTag, these are tags that are added by the /tag command.

You can read more about how they can be used here: https://minecraft.fandom.com/wiki/Commands/tag

Returns: True if the Entity had the tag and it was removed. False otherwise.
Return Type: boolean

ZenScript
 Copy
// MCEntity.removeTag(tag as string) as boolean

myMCEntity.removeTag("foundMesa");

Parametro	Tipo	Descrizione
Parametro tag	Tipo string	Descrizione The name of the tag to remove.

setAir

Name: setAir

Sets the air value for the Entity

Return Type: void

ZenScript
 Copy
// MCEntity.setAir(air as int) as void

myMCEntity.setAir(20);

Parametro	Tipo	Descrizione
Parametro air	Tipo int	Descrizione The new air value.

setEntityId

Name: setEntityId

This method is marked for removal next breaking change.

It sets the ID of the entity, which is only used in networking code and should never have to be called by mods or scripts.

Return Type: void

ZenScript
 Copy
// MCEntity.setEntityId(id as int) as void

myMCEntity.setEntityId(0);

Parametro	Tipo	Descrizione
Parametro id	Tipo int	Descrizione 0

setFire

Name: setFire

Sets the Entity on fire for the given amount of seconds.

This does not take ticks, it only takes full seconds, and you cannot lower the amount of fire ticks the entity has.

Return Type: void

ZenScript
 Copy
// MCEntity.setFire(seconds as int) as void

myMCEntity.setFire(5);

Parametro	Tipo	Descrizione
Parametro seconds	Tipo int	Descrizione The amount of seconds the Entity should be on fire for.

setLocationAndAngles

Name: setLocationAndAngles

Sets the location and looking angles of the entity.

Return Type: void

ZenScript
 Copy
// MCEntity.setLocationAndAngles(x as double, y as double, z as double, yaw as float, pitch as float) as void

myMCEntity.setLocationAndAngles(5, 1, 9, 90, 120);

Parametro	Tipo	Descrizione
Parametro x	Tipo double	Descrizione The new x position.
Parametro y	Tipo double	Descrizione The new y position.
Parametro z	Tipo double	Descrizione The new z position.
Parametro yaw	Tipo float	Descrizione The new yaw value.
Parametro pitch	Tipo float	Descrizione The new pitch value.

setNoGravity

Name: setNoGravity

Sets this Entity to have no gravity.

Return Type: void

ZenScript
 Copy
// MCEntity.setNoGravity(noGravity as boolean) as void

myMCEntity.setNoGravity(true);

Parametro	Tipo	Descrizione
Parametro noGravity	Tipo boolean	Descrizione The new gravity value.

setOnGround

Name: setOnGround

Sets if the Entity should be considered on the ground or not.

Return Type: void

ZenScript
 Copy
MCEntity.setOnGround(grounded as boolean) as void

Parametro	Tipo	Descrizione
Parametro grounded	Tipo boolean	Descrizione If the Entity is on the ground or not.

setPosition

Name: setPosition

Sets the position of this Entity.

Return Type: void

ZenScript
 Copy
// MCEntity.setPosition(x as double, y as double, z as double) as void

myMCEntity.setPosition(5, 2, 59);

Parametro	Tipo	Descrizione
Parametro x	Tipo double	Descrizione The new X position of the Entity.
Parametro y	Tipo double	Descrizione The new Y position of the Entity.
Parametro z	Tipo double	Descrizione The new Z position of the Entity.

setPositionAndUpdate

Name: setPositionAndUpdate

Return Type: void

ZenScript
 Copy
MCEntity.setPositionAndUpdate(x as double, y as double, z as double) as void

Parametro	Tipo	Descrizione
Parametro x	Tipo double	Descrizione No Description Provided
Parametro y	Tipo double	Descrizione No Description Provided
Parametro z	Tipo double	Descrizione No Description Provided

setRotationPitch

Name: setRotationPitch

Return Type: void

ZenScript
 Copy
MCEntity.setRotationPitch(newPitch as float) as void

Parametro	Tipo	Descrizione
Parametro newPitch	Tipo float	Descrizione No Description Provided

setRotationYaw

Name: setRotationYaw

Return Type: void

ZenScript
 Copy
MCEntity.setRotationYaw(newYaw as float) as void

Parametro	Tipo	Descrizione
Parametro newYaw	Tipo float	Descrizione No Description Provided

setSilent

Name: setSilent

Sets if this Entity is silent or not.

silent Entities do not play sounds.

Return Type: void

ZenScript
 Copy
// MCEntity.setSilent(isSilent as boolean) as void

myMCEntity.setSilent(true);

Parametro	Tipo	Descrizione
Parametro isSilent	Tipo boolean	Descrizione If the Entity should be silent or not.

setSneaking

Name: setSneaking

Sets the sneaking value of this Entity.

Return Type: void

ZenScript
 Copy
// MCEntity.setSneaking(value as boolean) as void

myMCEntity.setSneaking(true);

Parametro	Tipo	Descrizione
Parametro valore	Tipo boolean	Descrizione The new sneaking value

startRiding

Name: startRiding

Return Type: boolean

ZenScript
 Copy
MCEntity.startRiding(other as MCEntity, forced as boolean) as boolean

Parametro	Tipo	Descrizione	Optional	DefaultValue
Parametro other	Tipo MCEntity	Descrizione No Description Provided	Optional no	DefaultValue
Parametro forced	Tipo boolean	Descrizione No Description Provided	Optional sì	DefaultValue no

teleportKeepLoaded

Name: teleportKeepLoaded

Teleports the entity, forcing the destination to stay loaded for a short time

Return Type: void

ZenScript
 Copy
// MCEntity.teleportKeepLoaded(x as double, y as double, z as double) as void

myMCEntity.teleportKeepLoaded(20, 40, 60);

Parametro	Tipo	Descrizione
Parametro x	Tipo double	Descrizione No Description Provided
Parametro y	Tipo double	Descrizione No Description Provided
Parametro z	Tipo double	Descrizione No Description Provided

updateData

Name: updateData

Updates the NBT data of this Entity.

Return Type: void

ZenScript
 Copy
// MCEntity.updateData(data as MapData) as void

myMCEntity.updateData({key: "value"});

Parametro	Tipo	Descrizione
Parametro data	Tipo MapData	Descrizione The new Data for this Entity

updatePersistentData

Name: updatePersistentData

Updates the persisted data.

Return Type: void

ZenScript
 Copy
MCEntity.updatePersistentData(data as MapData) as void

Parametro	Tipo	Descrizione
Parametro data	Tipo MapData	Descrizione No Description Provided

Proprietà

Nome	Tipo	Ha Getter	Ha Setter	Descrizione
Nome air	Tipo int	Ha Getter sì	Ha Setter sì	Descrizione Gets the air value for the Entity. The air value is used to determine when the Entity will start drowning when swimming.
Nome canSwim	Tipo boolean	Ha Getter sì	Ha Setter no	Descrizione Checks if this Entity can swim.
Nome data	Tipo MapData	Ha Getter sì	Ha Setter no	Descrizione Gets the NBT data of this Entity.
Nome facingDirections	Tipo Direction[]	Ha Getter sì	Ha Setter no	Descrizione Gets which directions the Entity is currently facing.
Nome id	Tipo int	Ha Getter sì	Ha Setter no	Descrizione Gets this Entity's id that can be used to reference this Entity.
Nome inLava	Tipo boolean	Ha Getter sì	Ha Setter no	Descrizione Checks if this Entity is in lava or not.
Nome inWater	Tipo boolean	Ha Getter sì	Ha Setter no	Descrizione Checks if this Entity is in water.
Nome isWet	Tipo boolean	Ha Getter sì	Ha Setter no	Descrizione Checks if this Entity is wet.
Nome nome	Tipo string	Ha Getter sì	Ha Setter no	Descrizione Gets the name of the Entity.
Nome onGround	Tipo MCEntity	Ha Getter sì	Ha Setter sì	Descrizione Sets if the Entity should be considered on the ground or not.
Nome persistedData	Tipo MapData	Ha Getter sì	Ha Setter no	Descrizione Gets the persisted NBT tag.
Nome position	Tipo BlockPos	Ha Getter sì	Ha Setter no	Descrizione Gets this Entity's position in the world.
Nome positionVec	Tipo MCVector3d	Ha Getter sì	Ha Setter no	Descrizione No Description Provided
Nome rotationPitch	Tipo float	Ha Getter sì	Ha Setter sì	Descrizione No Description Provided
Nome rotationYaw	Tipo float	Ha Getter sì	Ha Setter sì	Descrizione No Description Provided
Nome silent	Tipo boolean	Ha Getter sì	Ha Setter sì	Descrizione Checks if this Entity is silent. Silent Entities do not play sounds.
Nome sneaking	Tipo boolean	Ha Getter sì	Ha Setter sì	Descrizione Checks if this Entity is sneaking or not.
Nome spectator	Tipo boolean	Ha Getter sì	Ha Setter no	Descrizione Checks if this Entity is in spectator mode.
Nome type	Tipo MCEntityType	Ha Getter sì	Ha Setter no	Descrizione Gets this Entity's type.
Nome uuid	Tipo string	Ha Getter sì	Ha Setter no	Descrizione Gets the UUID of this Entity.
Nome world	Tipo MCWorld	Ha Getter sì	Ha Setter no	Descrizione Gets the World that this Entity is in.