CollisionFix

插件

· 作者 warrior_404_error

修复 Geyser/Floodgate 玩家在竹子和滴水石上卡住的问题,且不会像其他修复方案那样破坏生物碰撞体积。

0 本站下载 0 关注 更新于 3 个月前

最新 2.1-SNAPSHOT · 26.1.2 · Folia / Paper

一键开服(送7天)

CollisionFix

通过移除特定方块的碰撞箱来修复 Bedrock 玩家在使用 Geyser/Floodgate 连接时因竹子(bamboo)和尖锥滴石(pointed dripstone)而卡住(“延迟回退”/lagback)的问题——但仅针对确实需要此修复的玩家生效。

功能说明

基岩版(Bedrock Edition)使用的碰撞模型与 Java 版不同。在跨平台服务器中,这会导致基岩版玩家在靠近某些方块时出现橡皮筋现象(rubber-band),最典型的就是竹子和尖锥滴石。CollisionFix 会移除这些方块的碰撞箱,但仅对通过 Floodgate 检测到的玩家生效。Java 版玩家和其他客户端不受影响。

工作原理

  • FloodgateTracker —— 监听加入/退出事件,并通过 Floodgate API 标记当前在线的基岩版玩家
  • CollisionGate —— 一个线程安全的注册表,用于存储当前在线的 Floodgate 玩家 UUID
  • CollisionAgent —— 在运行时自我附加 ByteBuddy Java Agent,并修补服务器的碰撞形状方法,使被跟踪的玩家获得空碰撞体
  • PlacementGuard —— 重新验证方块放置(竹子的堆叠、滴石的厚度/方向),确保在移除碰撞后建筑逻辑依然正确
  • NMSReflection / ReflectionAPI —— 版本无关的 Mojang 映射反射辅助工具,以确保兼容不同的 Minecraft/Paper 版本

特性

  • 修复基岩版玩家的竹子碰撞卡顿问题
  • 修复尖锥滴石碰撞卡顿问题(需要 1.17+ 版本)
  • 每个修复项均可通过 collisionfix.conf 独立开关
  • 支持 Folia
  • 对 Java 版玩家无任何影响
  • 软依赖 Geyser-Spigot / floodgate —— 即使未安装它们也能安全安装,只是在没有 Floodgate 存在时将不会生效

注意事项

“修复”了基岩版玩家在特定方块上运行时的延迟回退问题,方法是从给定方块中移除所有碰撞检测。注意事项:自定义客户端——无论是 Java 版还是基岩版——都可能利用无碰撞的特性直接穿过这些方块。此外,在这两个平台上放置这些方块可能会比平时更容易出现 Bug。

插件信息

版本 2.1-SNAPSHOT
API 版本 1.13
作者 warrior_404_error
软依赖 Geyser-Spigot, floodgate
Folia 支持 是

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源