OneEntity

:::info{title=提示} OneEntity相较于Entity损耗性能更大，且更适用于对单一实体精细调整使用。 :::

对象参数

参数名	数据类型	说明
EntityId	str	实体Id
IsLogging	bool	是否输出常规日志，默认为False

流式索引

属性/方法	端	类型	描述	可修改
Health	服务端	float	实体生命值	✅
Speed	服务端	float	实体速度	✅
Position	服务端	tuple	实体坐标位置	✅
Rotation	服务端	tuple	实体旋转角度	✅
Damage	服务端	float	实体攻击力	✅
Family	服务端	list[str]	实体类型的type_family列表，例['cow', 'mob']，仅可读	❌
ChineseName	服务端	str	实体类型的中文名称，仅可读	❌
CustomName	服务端	str	实体自定义名称	✅
EffectList	服务端	list	实体药水效果列表	✅
Scale	服务端	float	实体缩放倍率	✅
Size	服务端	tuple	实体碰撞盒大小	✅
IsFire	服务端	bool	是否处于着火状态	✅
MaxHealth	服务端	float	实体最大生命值	✅
BossName	服务端	str	实体 Boss 血条名称	✅
BossRange	服务端	int	实体Boss血条显示范围格数	✅
UnderWaterSpeed	服务端	float	实体水下速度	✅
Hunger	服务端	float	实体饥饿值	✅
Saturation	服务端	float	实体饱和值	✅
Absorption	服务端	float	实体伤害吸收值	✅
LavaSpeed	服务端	float	实体岩浆移动速度	✅
Luck	服务端	float	实体幸运值	✅
FollowRange	服务端	float	实体跟随距离	✅
KnockBackResistance	服务端	float	实体抗击退系数	✅
JumpStrength	服务端	float	实体跳跃强度	✅
Armor	服务端	float	实体护甲值	✅
AI	服务端	bool	是否屏蔽实体原生AI	✅
Name	服务端	str	实体名称，如minecraft:zombie	❌
DimensionId	服务端	int	实体所在维度	❌
OwnerId	服务端	str	实体主人Id	❌
RiderId	服务端	str	实体所骑乘的实体Id	❌
BeRiderIdList	服务端	list[str]	实体被其他实体骑乘的实体列表Id	❌
TargetId	服务端	str	实体目标Id	✅

---

Health

服务端

• 描述
  实体生命值

• 类型 float

• 示例

entity = LASystem.OneEntity(EntityId)
currentHealth = entity.Health
entity.Health = 40.0

---

Speed

服务端

• 描述
  实体速度

• 类型 float

• 示例 无

---

Position

服务端

• 描述
  实体世界坐标位置，三维坐标元组

• 类型 tuple (x, y, z)

  	数据类型	说明
  x	float	X坐标
  y	float	Y坐标
  z	float	Z坐标

• 示例

player = LASystem.OneEntity(EntityId)
newPos = (100, 65, 200)
player.Position = newPos

---

Rotation

服务端

• 描述
  实体旋转角度，二维坐标元组。单位是角度而不是弧度。

• 类型 tuple (x, y)

  	数据类型	说明
  x	float	上下角度
  y	float	左右角度

• 示例

player = LASystem.OneEntity(EntityId)
player.Rotation = (0, 0)

---

Damage

服务端

• 描述
  实体攻击力

• 类型 float

• 示例

mob = LASystem.OneEntity(MobId)
mob.Damage = 10.0

---

Family

服务端

• 描述
  实体类型的type_family列表，例['cow', 'mob']，仅可读

• 类型 list[str]

• 示例

print(LASystem.OneEntity(EntityId).Family)

---

ChineseName

服务端

• 描述
  获取实体的中文名称，仅可读

• 类型 str

• 示例

print(LASystem.OneEntity(EntityId).ChineseName)

---

CustomName

服务端

• 描述
  实体自定义名称（不是 EntityName）

• 类型 str

• 示例

ent = LASystem.OneEntity(EntityId)
ent.CustomName = "神秘之影"

---

EffectList

服务端

• 描述
  实体药水效果列表，会产生覆盖。

• 类型 list(dict)

• dict样式

  key	数据类型	说明
  effectName	str	药水效果名称
  duration	int	药水效果持续时间，默认为10秒
  amplifier	int	药水效果等级，默认为0级
  showParticles	bool	是否显示药水效果例子，默认为True

• 示例

Entity = LASystem.OneEntity(EntityId)
Entity.EffectList = [{
    'effectName': 'speed',
    'duration': 30,
    'amplifier': 0,
    'showParticles': False
}]

---

Scale

服务端

• 描述
  实体缩放体积倍率

• 类型 float

• 示例

LASystem.OneEntity(EntityId).Scale = 2.0

---

Size

服务端

• 描述
  实体碰撞盒尺寸宽高，单位为格，元组格式。

• 类型 tuple (width, height)

  	数据类型	说明
  width	float	宽
  height	float	高

• 示例

size = LASystem.OneEntity(EntityId).Size

---

IsFire

服务端

• 描述
  实体是否处于着火状态（True / False），支持读写。

• 类型 bool

• 示例

LASystem.OneEntity(EntityId).IsFire = True

---

MaxHealth

服务端

• 描述
  实体的最大生命值，支持读写。

• 类型 float

• 示例

LASystem.OneEntity(EntityId).MaxHealth = 200

---

BossName

服务端

• 描述
  Boss 血条名称，None的时候删除

• 类型 str, None

• 示例

Boss = LASystem.OneEntity(BossEntity)
Boss.BossName = "最终审判者"

---

BossRange

服务端

• 描述
  实体Boss血条显示范围格数

• 类型 int

• 示例 无

---

UnderWaterSpeed

服务端

• 描述
  实体水下速度

• 类型 float

• 示例 无

---

Hunger

服务端

• 描述
  实体饥饿值

• 类型 float

• 示例 无

---

Saturation

服务端

• 描述
  实体饱和值

• 类型 float

• 示例 无

---

Absorption

服务端

• 描述
  实体伤害吸收值

• 类型 float

• 示例 无

---

LavaSpeed

服务端

• 描述
  实体岩浆移动速度

• 类型 float

• 示例 无

---

Luck

服务端

• 描述
  实体幸运值

• 类型 float

• 示例 无

---

FollowRange

服务端

• 描述
  实体跟随距离

• 类型 float

• 示例 无

---

KnockBackResistance

服务端

• 描述
  实体抗击退系数

• 类型 float

• 示例 无

---

JumpStrength

服务端

• 描述
  实体跳跃强度

• 类型 float

• 示例 无

---

Armor

服务端

• 描述
  实体护甲值

• 类型 float

• 示例 无

---

AI

服务端

• 描述
  是否屏蔽实体原生AI
  设置时，需要为list[bool, bool]，第一个代表是否保留AI，False为屏蔽，第二个代表屏蔽AI时是否冻结动作，默认为False，仅当isBlock为False时生效。重进世界会恢复成初始动作

• 类型 bool

• 示例 无

---

Name

服务端

• 描述
  实体名称，如minecraft:zombie(无法更改)

• 类型 str

• 示例 无

---

DimensionId

服务端

• 描述
  实体所在维度(无法更改)

• 类型 int

• 示例 无

---

OwnerId

服务端

• 描述
  实体主人Id(无法更改)

• 类型 str

• 示例

---

RiderId

服务端

• 描述
  实体所骑乘的实体Id(无法更改)

• 类型 str

• 示例

---

BeRiderIdList

服务端

• 描述
  实体被其他实体骑乘的实体列表Id(无法更改)

• 类型 list[str]

• 示例 无

---

TargetId

服务端

• 描述
  实体目标Id

• 类型 str

• 示例 无

---