伪方块
伪方块功能让你可以向指定玩家发送方块变更,只有目标玩家能看到这些变化,服务端的实际方块数据不会被修改。
基本用法
单个方块
通过 sendBlockChange 向指定玩家发送单个方块变更:
sendBlockChange(viewer, location, blockData)
| 参数 | 说明 |
|---|---|
viewer | 目标玩家,只有该玩家能看到变更 |
location | 方块位置 |
blockData | 要显示的方块数据 |
批量方块
通过 sendBlockChanges 一次性发送多个方块变更,减少网络开销:
sendBlockChanges(viewer, list<location, blockData>)
| 参数 | 说明 |
|---|---|
viewer | 目标玩家 |
list | 位置与方块数据的配对列表 |
注意事项
- 伪方块只是客户端视觉效果,玩家与伪方块交互(如破坏、放置)时,服务端会以实际方块数据为准
- 当区块重新加载(如玩家远离后返回)时,伪方块会被真实方块覆盖
- 如果需要持久化的伪方块效果,建议配合幻象会话使用