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 支持 |
是 |
CollisionFix
Fixes Bedrock players getting stuck ("lagback") on bamboo and pointed dripstone when connecting through Geyser/Floodgate, by removing collision from those blocks — but only for the players who actually need it.
What It Does
Bedrock Edition uses a different collision model than Java Edition. On cross-play servers, this causes Bedrock players to rubber-band near certain blocks, most notably bamboo and pointed dripstone. CollisionFix strips the collision box from these blocks, but only for players detected as connecting through Floodgate. Java players and other clients are unaffected.
How It Works
- FloodgateTracker — listens for joins/quits and tags which online players are Bedrock via the Floodgate API
- CollisionGate — a thread-safe registry of currently-online Floodgate player UUIDs
- CollisionAgent — self-attaches a ByteBuddy Java agent at runtime and patches the server's collision-shape method so tracked players get an empty shape
- PlacementGuard — re-validates block placement (bamboo stacking, dripstone thickness/orientation) so builds stay correct once collision is removed
- NMSReflection / ReflectionAPI — version-agnostic, Mojang-mapped reflection helpers for compatibility across Minecraft/Paper versions
Features
- Fixes bamboo collision lag for Bedrock players
- Fixes pointed dripstone collision lag (requires 1.17+)
- Each fix can be toggled independently via
collisionfix.conf
- Folia supported
- No effect on Java Edition players
- Soft-depends on Geyser-Spigot / floodgate — safe to install without them, it just won't do anything until Floodgate is present
Caveats
"Fixes" Bedrock players running into lagback issues on certain blocks by removing any collision detection from the given block. Caveats: a custom client — Java or Bedrock — could take advantage of no collision and walk right through. Additionally, placement of these blocks on both platforms may be buggier than usual.
Plugin Info
|
|
| Version |
2.1-SNAPSHOT |
| API Version |
1.13 |
| Author |
warrior_404_error |
| Soft Dependencies |
Geyser-Spigot, floodgate |
| Folia Support |
Yes |
评论 0
登录后参与评分
还没有评论,来抢沙发吧