VoxelParity
在不改变 Java 玩家移动方式的情况下,平滑 Java 服务器上的基岩版移动体验。
VoxelParity 是一个面向 Geyser 服务器的服务端插件,用于修复 Minecraft 基岩版(Bedrock Edition) 与 Java 版(Java Edition) 之间的多项移动和碰撞差异。
基岩版玩家有时会被推回、卡住,或与方块的碰撞表现与其客户端预期不符。VoxelParity 仅针对基岩版玩家修复这些不匹配问题,同时保持 Java 物理引擎不受影响。
✨ 它修复了哪些问题?
? 竹子
基岩版和 Java 版在竹子的碰撞检测上略有不同。
VoxelParity 为基岩版玩家提供其客户端所预期的碰撞效果,减少在竹子附近移动时出现的奇怪卡顿和回弹现象。
幼年竹笋仍按预期允许穿透。
? 滴水石锥
滴水石锥在不同版本间也可能存在碰撞差异。
VoxelParity 调整了基岩版玩家的滴水石锥碰撞检测,包括:
- 悬挂的滴水石锥
- 向上的滴水石锥
- 不同形状和厚度的滴水石锥
- 紧密排列的滴水石锥之间的移动
? 爬行和低矮空间
基岩版玩家在站立、潜行以及爬行/游泳姿态之间的切换可能与 Java 版玩家不同。
VoxelParity 考虑了这些姿态转换,使服务器不会在玩家通过其基岩版客户端认为有效的空间时不必要地将其推回。
该插件不会强制设定玩家姿态——Geyser 和服务器仍正常控制它们。
❄️ 细雪
VoxelParity 还包含对细雪移动不匹配的保守修复方案。
仅在 Java 服务器拒绝本应对基岩版玩家有效的移动时才介入。其他情况下,正常的细雪行为保持不变。
?️ 设计初衷:不打扰他人
VoxelParity 不会替换服务器的整个碰撞系统。
它仅在检测到已知的基岩版/Java 版不匹配时应用针对性修复。
- ✅ 基岩版玩家获得修正后的兼容行为
- ✅ Java 玩家保留正常的 Java 碰撞
- ✅ 生物保留正常的 Java 碰撞
- ✅ 无需安装任何客户端模组
- ✅ 无需全局替换方块碰撞
- ✅ 无需为了检查移动而加载区块
? 要求
- Minecraft 26.3
- Java 25
- Leaf 或现代 Paper 兼容服务器
- Geyser-Spigot 或 Floodgate
VoxelParity 优先基于 Leaf 开发。
如果 Geyser 运行在代理或其他机器上,后端也应部署 Floodgate,以便 VoxelParity 能够识别基岩版玩家。
⚙️ 命令
| 命令 |
描述 |
/vp status |
显示 VoxelParity 状态 |
/vp modules |
显示激活的兼容性模块及计数器 |
/vp debug <player> [on|off] |
切换某玩家的详细诊断模式 |
/vp reload |
重新加载 VoxelParity 配置 |
管理员权限:
voxelparity.admin
? 调试
VoxelParity 为服务器所有者和开发者提供了详细的单玩家调试功能。
调试模式可以显示移动决策、碰撞几何体、细雪状态、玩家姿态变化以及其他有助于复现基岩版移动问题的信息。
对于常规服务器使用,您可以简单地保持调试禁用。
? 项目目标
VoxelParity 并非试图取代 Geyser 或重写 Minecraft 的移动机制。
其目标是使用小巧且安全的服务端修正,修复特定的、可复现的基岩版 ↔ Java 版移动差异。
随着更多实际不匹配情况被发现和测试,可能会添加更多的兼容性修复。
VoxelParity
Smooth out Bedrock movement on Java servers without changing how Java players move.
VoxelParity is a server-side plugin for Geyser servers that fixes several movement and collision differences between Minecraft Bedrock Edition and Java Edition.
Bedrock players can sometimes be pushed back, get stuck, or collide with blocks differently from how their client expects. VoxelParity fixes those mismatches only for Bedrock players, while leaving normal Java physics untouched.
✨ What does it fix?
? Bamboo
Bedrock and Java use slightly different bamboo collision.
VoxelParity gives Bedrock players the collision their client expects, reducing strange bumps and rubberbanding when moving around bamboo.
Young bamboo sprouts remain pass-through as expected.
? Pointed Dripstone
Pointed dripstone can also have different collision between editions.
VoxelParity adjusts its collision for Bedrock players, including:
- hanging dripstone
- upward dripstone
- different dripstone shapes and thicknesses
- movement between closely placed dripstone
? Crawling and low spaces
Bedrock players may switch between standing, sneaking, and crawling/swimming poses differently from Java players.
VoxelParity accounts for these transitions so the server does not unnecessarily push a player back while they are moving through a space their Bedrock client considers valid.
The plugin does not force player poses — Geyser and the server still control them normally.
❄️ Powder Snow
VoxelParity also contains a conservative fix for powder-snow movement mismatches.
It only steps in when the Java server rejects movement that should be valid for the Bedrock player. Normal powder-snow behavior is otherwise left alone.
?️ Designed to stay out of the way
VoxelParity does not replace the server's entire collision system.
It only applies targeted fixes when a known Bedrock/Java mismatch is detected.
- ✅ Bedrock players get corrected parity behavior
- ✅ Java players keep normal Java collision
- ✅ Mobs keep normal Java collision
- ✅ No client-side mod is required
- ✅ No global block collision replacement
- ✅ No chunk loading just to check movement
? Requirements
- Minecraft 26.3
- Java 25
- Leaf or a modern Paper-compatible server
- Geyser-Spigot or Floodgate
VoxelParity is developed Leaf-first.
If Geyser is running on a proxy or another machine, Floodgate should also be available on the backend so VoxelParity can identify Bedrock players.
⚙️ Commands
| Command |
Description |
/vp status |
Shows VoxelParity status |
/vp modules |
Shows active parity modules and counters |
/vp debug <player> [on|off] |
Toggles detailed diagnostics for a player |
/vp reload |
Reloads VoxelParity configuration |
Admin permission:
voxelparity.admin
? Debugging
VoxelParity includes detailed per-player debugging for server owners and developers.
Debug mode can show movement decisions, collision geometry, powder-snow state, player pose changes, and other information useful for reproducing Bedrock movement issues.
For normal server use, you can simply leave debug disabled.
? Project goal
VoxelParity is not trying to replace Geyser or rewrite Minecraft movement.
The goal is to fix specific, reproducible Bedrock ↔ Java movement differences with small and safe server-side corrections.
More parity fixes may be added as real mismatches are found and tested.
评论 0
登录后参与评分
还没有评论,来抢沙发吧