跳到主要内容

伪方块

伪方块功能让你可以向指定玩家发送方块变更,只有目标玩家能看到这些变化,服务端的实际方块数据不会被修改。

基本用法

单个方块

通过 sendBlockChange 向指定玩家发送单个方块变更:

sendBlockChange(viewer, location, blockData)
参数说明
viewer目标玩家,只有该玩家能看到变更
location方块位置
blockData要显示的方块数据

批量方块

通过 sendBlockChanges 一次性发送多个方块变更,减少网络开销:

sendBlockChanges(viewer, list<location, blockData>)
参数说明
viewer目标玩家
list位置与方块数据的配对列表

注意事项

  • 伪方块只是客户端视觉效果,玩家与伪方块交互(如破坏、放置)时,服务端会以实际方块数据为准
  • 当区块重新加载(如玩家远离后返回)时,伪方块会被真实方块覆盖
  • 如果需要持久化的伪方块效果,建议配合幻象会话使用