OneEntity

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

对象参数

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

流式索引

属性/方法	端	类型	描述	可修改
Health	服务端	float	实体生命值	✅
Speed	服务端	float	实体速度	✅
Position	服务端	tuple	实体坐标位置	✅
Damage	服务端	float	实体攻击力	✅
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	实体护甲值	✅
Name	服务端	str	实体名称，如minecraft:zombie	❌
DimensionId	服务端	int	实体所在维度	❌
OwnerId	服务端	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

---

Damage

服务端

• 描述
  实体攻击力

• 类型 float

• 示例

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

---

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

• 示例 无

---

Name

服务端

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

• 类型 str

• 示例 无

---

DimensionId

服务端

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

• 类型 int

• 示例 无

---

OwnerId

服务端

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

• 类型 str

• 示例 无

---

TargetId

服务端

• 描述
  实体目标Id

• 类型 str

• 示例 无

---