跳到主要内容

伪世界边界

伪世界边界功能让你可以向指定玩家发送虚拟的世界边界效果,只有目标玩家能看到,不会影响服务端的实际世界边界设置。

静态边界

通过 WorldBorderState 定义一个固定的世界边界:

参数说明
world所属世界
size边界大小(直径,单位:方块)
center边界中心坐标
warningTime警告时间(秒),边界缩小时提前多久显示红色警告
warningDistance警告距离(方块),距离边界多近时显示红色警告
damageBuffer伤害缓冲区(方块),超出边界多远后开始受到伤害
damageAmount每秒伤害量

动态边界

通过 DynamicWorldBorderState 定义一个带动画过渡的世界边界:

参数说明
oldSize起始大小
newSize目标大小
speedMs过渡时间(毫秒),边界从 oldSize 平滑变化到 newSize 的耗时

动态边界会在客户端播放平滑的缩放动画,适合用于倒计时缩圈等玩法。

注意事项

  • 伪世界边界只是客户端视觉效果,不会对玩家造成实际伤害或移动限制(除非客户端自身的边界逻辑生效)
  • 只有目标玩家能看到虚拟边界,其他玩家看到的是服务端的真实世界边界
  • 如果需要同时管理多个来源的边界效果,建议配合幻象会话使用