跳到主要内容

实体元数据

实体元数据功能让你可以修改指定玩家看到的实体视觉状态,而不影响服务端的实际实体数据。只有目标玩家能看到这些变化。

EntityFlag 标志

可用的实体标志:

标志说明
ON_FIRE着火效果
SNEAKING潜行姿态
SPRINTING疾跑状态
INVISIBLE隐身
GLOWING发光轮廓

可用操作

setFlag

切换实体的视觉标志:

setFlag(viewer, entity, flag, value)
参数说明
viewer目标玩家
entity要修改的实体
flagEntityFlag 标志
valuetrue 启用 / false 关闭

setPose

修改实体的姿态:

setPose(viewer, entity, pose)
参数说明
viewer目标玩家
entity要修改的实体
pose目标姿态

updateHealth

伪造实体的生命值显示:

updateHealth(viewer, entity, health)
参数说明
viewer目标玩家
entity要修改的实体
health显示的生命值

mount

伪造骑乘效果:

mount(viewer, entity)
参数说明
viewer目标玩家
entity要骑乘的实体

注意事项

  • 所有修改都是纯客户端效果,服务端的实体数据不会改变
  • 只有目标玩家能看到这些视觉变化
  • 如果需要多个机制同时修改同一实体的标志并支持精准回滚,建议配合幻象会话使用