Hauteur

插件

· 作者 maxlananass

一个 Geyser 扩展,调整了高度窗口,使得基岩版玩家能够在 Java 版的高度范围内进行建造和移动,即使这些高度超出了基岩版客户端的范围。

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

需要前置:间歇泉

最新 2.0.0 · 26.2 · Geyser

一键开服(送7天)

Hauteur

Hauteur 是一个 Geyser 扩展,用于解决 Java 服务器上的 Bedrock 玩家因世界高度超出 Bedrock 客户端显示范围而无法正常游玩的问题。

问题所在

Bedrock 客户端渲染一个固定的垂直范围,该范围由客户端自身决定。在一个更高的 Java 世界中(例如 BuildTheEarth 风格的建筑中 Y = 1950 左右),Bedrock 玩家无法看到或触及该范围上方的方块。

Hauteur 的工作原理

Hauteur 并非扩展显示范围,而是移动显示窗口。对于每个 Bedrock 玩家,它维护一个整数偏移量 O,且始终为 16 的倍数。客户端看到的实际 Y 坐标为 真实Y - O。当玩家接近可见范围的边缘时,Hauteur 会调整 O,从缓存中重建客户端所见的内容,并继续运行。在当前窗口未覆盖之前,窗口外的内容不会显示。

  • 所有绝对 Y 坐标数据包都在 Geyser Java 端管道的某个节点进行转换。相对值(运动、光标偏移、相对传送)不会被移位。
  • 原始区块数据包以及自接收以来收到的方块更改会被缓存,因此切换时视图会重绘,而无需再次询问服务器。
  • 在切换后的短暂冻结期间发送的客户端数据包会被保留,在正确的帧中重放,或被丢弃。存在歧义的数据包将被丢弃,绝不会猜测。
  • 普通世界不受影响。如果真实世界已经适应客户端的范围,则不会缓存任何区块,也不会修改任何数据包。
  • 接受绝对 Y 值的聊天命令(默认情况下为 tp、tppos、teleport)会通过相同的偏移量进行重写。带符号的聊天命令保持不变。

你将注意到的现象

  • 每次窗口移动时会出现短暂的可见调整。默认情况下,冻结持续时间为 400 毫秒。
  • Hauteur 无法使 Bedrock 客户端显示超出其自身范围的内容。它只是移动该范围。
  • 大于缓存预算的区块在切换后不会重放(参见已知限制)。

要求

  • 服务器需使用 Java 21 或更高版本。
  • 支持 Geyser 的服务器平台:Spigot/Paper、Fabric、Velocity、BungeeCord 或独立版 Geyser。构建基于 Geyser 2.11.2-SNAPSHOT 编译。
  • 服务器上已安装并正常运行 Geyser。

安装

  1. 在服务器上安装 Geyser。
  2. 从 GitHub releases 下载 hauteur-<version>.jar 并校验: sha256sum -c SHA256SUMS.txt
  3. 将 jar 文件复制到 Geyser 扩展文件夹:
    • Spigot/Paper: plugins/Geyser-Spigot/extensions/
    • Standalone: 与 Geyser jar 同级的 extensions/ 目录
  4. 启动服务器。配置文件将写入 extensions/hauteur/config.properties。
  5. 通过 Bedrock 客户端加入服务器并运行 /hauteur doctor。它将显示管道和世界管理器包装器是否已附加。

从 SkyWindow 1.x 升级:首次启动时,extensions/skywindow/ 中的配置会被复制到 extensions/hauteur/(旧文件会被保留)。旧命令 /skywindow、/sw 和 /bho 仍可作为别名使用。

配置(默认值)

键名 默认值 范围 含义
switch-margin-blocks 64 32–256 当玩家距离窗口边缘近于此数值时重新定位窗口
switch-cooldown-ms 2000 250–60000 单个玩家两次切换之间的最小时间间隔
freeze-ms 400 100–5000 切换后冻结的持续时间
freeze-hold-actions true 冻结期间发送的方块操作将被暂停
freeze-hold-movement true 冻结期间发送的移动数据将被暂停
announce-switches false 每次切换时在聊天中发送消息
chunk-cache-max-chunks 2048 64–32768 每个玩家的缓存区块数上限
chunk-cache-max-megabytes 96 8–1024 每个玩家的缓存字节预算上限
max-offset-blocks 0 偏移量的上限,对齐到 16。0 表示根据世界自动推导
rewrite-commands tp,tppos,teleport 其绝对 Y 值将被移位的命令
log-switches true 每次切换记录一行日志

超出范围的值会产生启动警告并被强制限制。大多数键可通过 /geyser reload 重新加载。

命令

/hauteur(别名 /skywindow、/sw、/bho),仅限 Bedrock 玩家使用:

  • info:显示偏移量、窗口边界、缓存区块。
  • watch on|off 和 recent:显示最近转换的数据包,用于调试。
  • doctor:检查附加状态和世界管理器状态、隔离的数据包类型、Geyser 版本信息。
  • stats [reset]:会话计数器(切换次数、重放次数、暂停和丢弃的数据包、缓存淘汰次数)。

已知限制

  • 未在实时服务器或真实 Bedrock 客户端上测试。 自动化测试覆盖了 Java 端的转换逻辑和决策逻辑。冻结时机、客户端对切换的处理方式以及视觉效果尚未验证。
  • 客户端对新窗口的采纳是通过时间推断得出的。Hauteur 未收到来自客户端的任何确认。
  • 大于 chunk-cache-max-megabytes 的区块不会被缓存,当预算已满时会驱逐最旧的区块。这些区块的地形将保持陈旧状态,直到服务器再次发送它们。
  • 光照数据不会重新定位。在 Geyser 核心中未找到相关参考,但此情况未经过实时测试。
  • 死亡位置以未移位的形式写入,且在切换后不会重新发送。其对指南针和死亡屏幕的影响未经测试。
  • 碰撞检测和容器读取依赖于世界管理器包装器。如果无法安装,/hauteur doctor 会报告此问题。
  • 不包含绝对 Y 值的数据包以及带符号的聊天命令不会被转换。
  • 性能仅在编解码器上进行测量,使用的是合成区块。在实时服务器上的开销尚不清楚。

状态

实验性。最有用的错误报告应包含 /hauteur doctor 和 /hauteur stats 的输出。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源