伪世界边界
伪世界边界功能让你可以向指定玩家发送虚拟的世界边界效果,只有目标玩家能看到,不会影响服务端的实际世界边界设置。
静态边界
通过 WorldBorderState 定义一个固定的世界边界:
| 参数 | 说明 |
|---|---|
world | 所属世界 |
size | 边界大小(直径,单位:方块) |
center | 边界中心坐标 |
warningTime | 警告时间(秒),边界缩小时提前多久显示红色警告 |
warningDistance | 警告距离(方块),距离边界多近时显示红色警告 |
damageBuffer | 伤害缓冲区(方块),超出边界多远后开始受到伤害 |
damageAmount | 每秒伤害量 |
动态边界
通过 DynamicWorldBorderState 定义一个带动画过渡的世界边界:
| 参数 | 说明 |
|---|---|
oldSize | 起始大小 |
newSize | 目标大小 |
speedMs | 过渡时间(毫秒),边界从 oldSize 平滑变化到 newSize 的耗时 |
动态边界会在客户端播放平滑的缩放动画,适合用于倒计时缩圈等玩法。
注意事项
- 伪世界边界只是客户端视觉效果,不会对玩家造成实际伤害或移动限制(除非客户端自身的边界逻辑生效)
- 只有目标玩家能看到虚拟边界,其他玩家看到的是服务端的真实世界边界
- 如果需要同时管理多个来源的边界效果,建议配合幻象会话使用