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。
安装
- 在服务器上安装 Geyser。
- 从 GitHub releases 下载
hauteur-<version>.jar并校验:sha256sum -c SHA256SUMS.txt - 将 jar 文件复制到 Geyser 扩展文件夹:
- Spigot/Paper:
plugins/Geyser-Spigot/extensions/ - Standalone: 与 Geyser jar 同级的
extensions/目录
- Spigot/Paper:
- 启动服务器。配置文件将写入
extensions/hauteur/config.properties。 - 通过 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 的输出。
Hauteur
Hauteur is a Geyser extension for Bedrock players on Java servers whose world is taller than the Bedrock client can display.
The problem
The Bedrock client renders a fixed vertical range, chosen by the client itself. On a Java world that goes higher (for example around Y = 1950 on a BuildTheEarth-style build), Bedrock players cannot see or reach blocks above that range.
What Hauteur does
Hauteur moves the window instead of extending it. For each Bedrock player it keeps an integer offset O, always a multiple of 16. The client sees real Y minus O. When the player gets close to the edge of the visible range, Hauteur shifts O, rebuilds what the client sees from its cache, and carries on. Content outside the current window is not shown until the window moves over it.
- Every absolute-Y packet is translated at one point in Geyser's Java-side pipeline. Relative values (motion, cursor offsets, relative teleports) are never shifted.
- Original chunk packets and the block changes received since are cached, so a switch redraws the view without asking the server again.
- Client packets sent during the short freeze after a switch are held, replayed in the right frame, or dropped. An ambiguous packet is dropped, never guessed.
- Ordinary worlds are not affected. If the real world already fits the client's range, no chunk is cached and no packet is changed.
- Chat commands that take an absolute Y (
tp,tppos,teleportby default) are rewritten by the same offset. Signed chat commands are left alone.
What you will notice
- A short, visible adjustment each time the window moves. The freeze lasts 400 ms by default.
- Hauteur cannot make the Bedrock client display more than its own range. It moves that range.
- Chunks larger than the cache budget are not replayed after a switch (see Known limits).
Requirements
- Java 21 or newer on the server.
- A Geyser-supported server platform: Spigot/Paper, Fabric, Velocity, BungeeCord or standalone Geyser. The build compiles against Geyser
2.11.2-SNAPSHOT. - Geyser installed and working on your server.
Installation
- Install Geyser on your server.
- Download
hauteur-<version>.jarfrom the GitHub releases and check it:sha256sum -c SHA256SUMS.txt - Copy the jar into the Geyser extensions folder:
- Spigot/Paper:
plugins/Geyser-Spigot/extensions/ - Standalone:
extensions/next to the Geyser jar
- Spigot/Paper:
- Start the server. A config file is written to
extensions/hauteur/config.properties. - Join from a Bedrock client and run
/hauteur doctor. It shows whether the pipeline and the world-manager wrapper are attached.
Upgrading from SkyWindow 1.x: the config in extensions/skywindow/ is copied to extensions/hauteur/ on first start (the old file is kept). The old commands /skywindow, /sw and /bho still work as aliases.
Configuration (defaults)
| Key | Default | Range | Meaning |
|---|---|---|---|
switch-margin-blocks |
64 | 32–256 | Re-home the window when the player is this close to its edge |
switch-cooldown-ms |
2000 | 250–60000 | Minimum time between two switches for one player |
freeze-ms |
400 | 100–5000 | Length of the freeze after a switch |
freeze-hold-actions |
true | Hold block actions sent during a freeze | |
freeze-hold-movement |
true | Hold movement sent during a freeze | |
announce-switches |
false | Chat message on each switch | |
chunk-cache-max-chunks |
2048 | 64–32768 | Cached chunks per player |
chunk-cache-max-megabytes |
96 | 8–1024 | Cache byte budget per player |
max-offset-blocks |
0 | Cap on the offset, aligned to 16. 0 derives it from the world |
|
rewrite-commands |
tp,tppos,teleport | Commands whose absolute Y is shifted | |
log-switches |
true | One log line per switch |
Out-of-range values produce a startup warning and are clamped. Most keys reload with /geyser reload.
Commands
/hauteur (aliases /skywindow, /sw, /bho), Bedrock players only:
info: offset, window bounds, cached chunks.watch on|offandrecent: recent translated packets, for debugging.doctor: attachment and world-manager status, quarantined packet types, Geyser build.stats [reset]: session counters (switches, replays, held and dropped packets, cache evictions).
Known limits
- Not tested on a live server or with a real Bedrock client. Automated tests cover the Java-side translation and the decision logic. Freeze timing, how the client handles a switch, and the visual result are not verified yet.
- The client's adoption of a new window is inferred from time. Hauteur receives no acknowledgement from the client.
- A chunk larger than
chunk-cache-max-megabytesis not cached, and the oldest chunks are evicted when the budget is full. Terrain for those chunks stays stale until the server sends it again. - Light data is not re-homed. No reference was found in Geyser's core, but this has not been tested live.
- The death location is written unshifted and is not re-sent after a switch. Its effect on the compass and the death screen is untested.
- Collision and container reads depend on the world-manager wrapper. If it cannot be installed,
/hauteur doctorreports it. - Packets without an absolute Y, and signed chat commands, are not translated.
- Performance was measured only on the codec, with synthetic chunks. The cost on a live server is unknown.
Status
Experimental. The most useful bug report includes the output of /hauteur doctor and /hauteur stats.
下载 Hauteur
下载 Hauteur
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Hauteur
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Hauteur
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Hauteur
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Hauteur
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Hauteur
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Hauteur
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
暂无更新日志
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
插件
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
评论 0
登录后参与评分
还没有评论,来抢沙发吧