API Reference / api/actor/Actor / Actor
Class: Actor
Defined in: api/actor/Actor.d.ts:7
活体实体，例如怪物或玩家。这是一个基础抽象类，代表所有具有移动特性的实体。
Extends
Extended by
Methods
addScoreboardTag()
addScoreboardTag(tag): booleanDefined in: api/actor/Actor.d.ts:149
向该实体添加一个标签。如果标签已经存在，则返回 false，否则返回 true。标签通常用于在服务器上显示和管理玩家的统计信息或属性。
Parameters
tag
string
要添加的标签。
Returns
boolean
如果标签成功添加则返回 true，否则返回 false。
asActor()
asActor(): ActorDefined in: api/command/CommandSender.d.ts:25
该方法获取一个CommandSender作为Actor。
Returns
Player，如果不是Actor，则返回null
Inherited from
asCommandSender()
asCommandSender(): CommandSenderDefined in: api/command/CommandSender.d.ts:11
转成命令发送者
Returns
Inherited from
asMob()
asMob(): MobDefined in: api/command/CommandSender.d.ts:30
该方法获取一个CommandSender作为Mob。
Returns
Inherited from
asPlayer()
asPlayer(): PlayerDefined in: api/command/CommandSender.d.ts:37
该方法获取一个CommandSender作为Player。
Returns
Player，如果不是Player，则返回null
Inherited from
getHealth()
getHealth(): numberDefined in: api/actor/Actor.d.ts:120
获取实体的健康值。健康值是从 0 到最大值，其中 0 表示该实体已经死亡。这个方法用于获取和设置实体的健康值。如果健康值小于等于 0，则表示该实体已死亡，并且无法进行任何操作。
Returns
number
实体的健康值。
getId()
getId(): numberDefined in: api/actor/Actor.d.ts:106
获取该实体的唯一标识符（ID）。ID是用于标识单个实体的唯一标识符，通常是一个整数。它在服务器之间传递实体信息，并且可以在命令中引用特定的实体。
Returns
number
实体的唯一标识符（ID）。
getMaxHealth()
getMaxHealth(): numberDefined in: api/actor/Actor.d.ts:134
获取实体的最大健康值。最大健康值是实体可以承受的最大生命值。这个方法用于获取和设置实体的最大健康值。如果最大健康值为零，则表示该实体无法承受任何生命值，并且无法进行任何操作。
Returns
number
实体的最大健康值。
getName()
getName(): stringDefined in: api/command/CommandSender.d.ts:65
获取此命令发送者的名称
Returns
string
发送者的名字
Inherited from
getNameTag()
getNameTag(): stringDefined in: api/actor/Actor.d.ts:195
获取角色的当前名称标签。
Returns
string
名称标签。
getRuntimeId()
getRuntimeId(): numberDefined in: api/actor/Actor.d.ts:26
获取实体的运行时ID。
运行时ID是用于标识单个实体的唯一标识符。它在服务器之间传递实体信息，并且可以在命令中引用特定的实体。
Returns
number
实体的运行时ID。
getScoreboardTags()
getScoreboardTags(): string[]Defined in: api/actor/Actor.d.ts:141
获取该实体的所有 scoreboard 标签。这些标签通常用于在服务器上显示和管理玩家的统计信息或属性。
Returns
string[]
实体的所有 scoreboard 标签列表。
getScoreTag()
getScoreTag(): stringDefined in: api/actor/Actor.d.ts:209
获取角色的当前分数标签。
Returns
string
分数标签。
getServer()
getServer(): ServerDefined in: api/command/CommandSender.d.ts:58
返回运行该命令的服务器实例
Returns
服务器实例
Inherited from
getType()
getType(): stringDefined in: api/actor/Actor.d.ts:17
获取该实体的类型。
该方法返回实体的类型作为字符串，例如minecraft:pig。它用于获取实体的类型信息，以便可以为其提供相应的功能或属性。
Returns
string
实体的类型。
hasPermission()
Call Signature
hasPermission(name): booleanDefined in: api/permissions/Permissible.d.ts:45
获取指定权限的值，如果已设置。如果没有设置此对象中的权限覆盖，则返回权限的默认值
Parameters
name
string
权限名称
Returns
boolean
权限的值
Inherited from
Call Signature
hasPermission(perm): booleanDefined in: api/permissions/Permissible.d.ts:53
获取指定权限的值，如果已设置。如果没有设置此对象中的权限覆盖，则返回权限的默认值
Parameters
perm
权限获取
Returns
boolean
权限的值
Inherited from
isDead()
isDead(): booleanDefined in: api/actor/Actor.d.ts:113
判断该实体是否已经被标记为死亡或已删除。返回真如果是这样的实体，表示该实体已经死亡，并且无法进行任何操作。
Returns
boolean
true如果实体已经被标记为死亡或已删除。
isInLava()
isInLava(): booleanDefined in: api/actor/Actor.d.ts:61
判断该角色是否处于熔岩中
Returns
boolean
如果该角色在熔岩中，返回true
isInWater()
isInWater(): booleanDefined in: api/actor/Actor.d.ts:54
判断该角色是否处于水中
Returns
boolean
如果该角色在水中，返回true
isNameTagAlwaysVisible()
isNameTagAlwaysVisible(): booleanDefined in: api/actor/Actor.d.ts:181
判断该实体的名称标签是否当前不可见。如果名称标签是不可见，则返回 true，否则返回false。名称标签通常用于在服务器上显示和管理玩家的名称信息或属性。
Returns
boolean
名称标签是否当前不可见。
isNameTagVisible()
isNameTagVisible(): booleanDefined in: api/actor/Actor.d.ts:167
判断该实体的名称标签是否当前可见。如果名称标签是当前可见，则返回 true，否则返回false。名称标签通常用于在服务器上显示和管理玩家的名称信息或属性。
Returns
boolean
名称标签是否当前可见。
isOnGround()
isOnGround(): booleanDefined in: api/actor/Actor.d.ts:47
判断该实体是否在地面上（即块下）。返回真如果是这样的实体。
Returns
boolean
true如果实体在地面上（即块下）。
isOp()
isOp(): booleanDefined in: api/permissions/Permissible.d.ts:14
检查此对象是否是服务器管理员
Returns
boolean
true 如果这是服务器管理员，否则 false
Inherited from
isPermissionSet()
Call Signature
isPermissionSet(name): booleanDefined in: api/permissions/Permissible.d.ts:29
检查此对象中是否存在指定权限的完全限定名称的覆盖
Parameters
name
string
权限名称
Returns
boolean
如果权限设置，则为 true，否则为 false
Inherited from
Call Signature
isPermissionSet(perm): booleanDefined in: api/permissions/Permissible.d.ts:37
检查此对象中是否存在指定权限的覆盖
Parameters
perm
权限检查
Returns
boolean
如果权限设置，则为 true，否则为 false
Inherited from
recalculatePermissions()
recalculatePermissions(): voidDefined in: api/permissions/Permissible.d.ts:84
根据附件的变化值重新计算此对象的权限。这通常很少需要从插件中调用。
Returns
void
Inherited from
CommandSender.recalculatePermissions
removeScoreboardTag()
removeScoreboardTag(tag): booleanDefined in: api/actor/Actor.d.ts:157
从该实体中删除一个标签。如果标签不存在，则返回 false，否则返回 true。标签通常用于在服务器上显示和管理玩家的统计信息或属性。
Parameters
tag
string
要删除的标签。
Returns
boolean
如果标签成功删除则返回 true，否则返回 false。
sendErrorMessage()
sendErrorMessage(...message): voidDefined in: api/command/CommandSender.d.ts:51
将这个发送者的错误消息发送出去
Parameters
message
...any[]
错误消息要显示
Returns
void
Inherited from
CommandSender.sendErrorMessage
sendMessage()
sendMessage(...message): voidDefined in: api/command/CommandSender.d.ts:44
将这个发送者的消息发送出去
Parameters
message
...any[]
要显示的消息
Returns
void
Inherited from
setHealth()
setHealth(health): voidDefined in: api/actor/Actor.d.ts:127
设置实体的健康值。健康值是从 0 到最大值，其中 0 表示该实体已经死亡。这个方法用于获取和设置实体的健康值。如果健康值小于等于 0，则表示该实体已死亡，并且无法进行任何操作。
Parameters
health
number
实体的健康值。
Returns
void
setNameTag()
setNameTag(name): voidDefined in: api/actor/Actor.d.ts:202
设置角色的名称标签。
Parameters
name
string
新的名称标签。
Returns
void
setNameTagAlwaysVisible()
setNameTagAlwaysVisible(invisible): booleanDefined in: api/actor/Actor.d.ts:188
设置该实体的名称标签为不可见或可见。如果名称标签是可见，则返回 false，否则返回true。名称标签通常用于在服务器上显示和管理玩家的名称信息或属性。
Parameters
invisible
string
是否设置名称标签为不可见。
Returns
boolean
setNameTagVisible()
setNameTagVisible(visible): voidDefined in: api/actor/Actor.d.ts:174
设置该实体的名称标签为可见或不可见。如果名称标签是不可见，则返回 false，否则返回 true。名称标签通常用于在服务器上显示和管理玩家的名称信息或属性。
Parameters
visible
string
是否设置名称标签为可见。
Returns
void
setOp()
setOp(value): voidDefined in: api/permissions/Permissible.d.ts:21
设置此对象的管理员状态
Parameters
value
boolean
新的管理员值
Returns
void
Inherited from
setScoreTag()
setScoreTag(score): voidDefined in: api/actor/Actor.d.ts:216
设置角色的分数标签。
Parameters
score
string
新的分数标签。
Returns
void
toString()
toString(): stringDefined in: api/actor/Actor.d.ts:8
Returns
string