HighBuildPaper 26.2 插件,用于移除 Minecraft 的建筑高度限制,并将额外空间保留给管理员使用。
功能说明
原版游戏在主世界(Overworld)禁止在 Y 319 以上建造(下界和末地则为 Y 255)。本插件将实际限制提升至 Y 2031——这是游戏引擎能够加载的最高 Y 坐标。这意味着增加了 1712 个方块的空间。
该插件全局生效,随后阻止没有权限的玩家使用原版限制线以上的任何内容。非管理员玩家不会察觉到它的存在。
|
原版 (Vanilla) |
HighBuild (管理员) |
非管理员 (Non-admins) |
| 主世界 |
-64 … 319 |
-64 … 2031 |
-64 … 319 |
| 下界 |
0 … 255 |
0 … 2031 |
0 … 255 |
| 末地 |
0 … 255 |
0 … 2031 |
0 … 255 |
无需客户端模组,无需命令。安装后重启两次服务器,即可正常建造。
工作原理
维度的高度定义在其 dimension_type 中,而只能通过数据包读取。Bukkit 的 World#setBlockState 以及通过 Level#isInWorldBounds 运行的所有原版命令都会拒绝超出已加载列范围的内容——因此没有任何插件能通过 Bukkit API 提高天花板。必须更改的是列本身。
插件在启动时执行以下操作:
- 直接从运行中的服务器 jar 包中读取
data/minecraft/dimension_type/*.json
- 将它们复制到
<world>/datapacks/highbuild/,仅重写 min_y、height 和 logical_height
- 在
level.dat 中注册该数据包
第 1 步是重要的设计选择。因为它修补的是实时原版文件,而不是在插件内部携带副本,所以其他所有设置——天空颜色、床的规则、背景音乐、无限燃烧、默认时钟、未来版本添加的任何内容——都会自动保留,而不会被静默恢复为旧形态。
两个需要深入挖掘的细节:
- Paper 26.2 要求在
pack.mcmeta 中包含全部四个字段:pack_format、supported_formats、min_format 和 max_format。其他三种格式会被拒绝,服务器的错误消息揭示了这一规则。
Bukkit.dispatchCommand 会在 / 处截断参数,因此 datapack enable file/highbuild 会静默变为 datapack enable file。因此需要使用直接的 PackRepository 访问。
仅限管理员的执行
没有 highbuild.bypass 权限的玩家,其在原版限制线以上的放置、破坏、方块伤害和桶的使用将被取消。可选功能:完全阻止他们飞到那里。
使用的限制是 min(配置的原版限制, 世界自身的天花板),因此未触及的数据包的世界永远不会被修改。
命令
| 命令 |
功能 |
/hb status |
显示每个世界的建筑范围 |
/hb reload |
重新读取配置,重新生成数据包 |
| `/hb fill <x1 y1 z1> <x2 y2 z2> <block> [replace |
air]` |
/hb platform <radius> <block> [y] |
在你脚下创建平台 |
/hb tp <y> |
传送你自己到指定的 Y 坐标 |
/hb 和 /highbuildlimit 是别名。fill 命令受到速率限制,以防止 50 万个方块的建造触发看门狗机制。
权限:highbuild.bypass(在高处建造)和 highbuild.admin(使用命令)。两者默认均给予 op 权限。
配置
完全注释的 config.yml:target-max-y、各维度的 min-y / logical-height / vanilla-max-y、防护开关、填充限制,以及所有 MiniMessage 格式的消息。
logical-height 默认为整列,这意味着生物可以在高处自然生成。如果这让你感到困扰,可以降低它——代价是天空光照会在阈值上方停止。
值得注意的限制
Y 2031 是一个硬性引擎限制,而非可设置项。我在真实服务器上验证过:Y 2032 和 Y 3000 均返回“该位置不属于这个世界!”。这是区块格式的节索引,因此没有任何数据包、插件或模组能突破它。
安装或任何高度更改后需要完全重启服务器。正在运行的世界会保持其启动时的列状态。
请先备份。从已经使用该插件的世界中移除数据包可能会导致 319 以上的方块损坏。
不要降低已经拥有高于原限制方块的块的高度。
“Ignoring heightmap data for chunk…”(忽略区块的高度图数据…)会出现一次,即在列增长后现有区块首次加载时。它们会被重新计算。无害。
在真实服务器上验证
不仅编译完成——还在 Paper 26.2 上启动并测试:所有三个维度的列均已提升,在 Y 700 和 Y 2031 天花板处放置并确认方块存在,Y 2032 和 Y -65 正确被拒绝,方块在完整关闭/重启周期后幸存,数据包自动启用有效,重载具有幂等性。日志中零异常。
要求:Paper 26.2,Java 25。从 HighBuild/ 目录构建,通过 build.cmd → target/HighBuild-1.0.0.jar。
HighBuildA Paper26.2 plugin that removes Minecraft's build height limit and keeps the extra space for admins.
What it does
Vanilla stops you building above Y 319 in the overworld (Y 255 in the Nether and End). This raises the real limit to Y 2031 — the highest Y the game will load at all. That's 1712 extra blocks.
It does that world-wide, then blocks players without permission from using anything above the vanilla line. Non-admins don't notice it exists.
Vanilla With HighBuild (admins) Non-admins
Overworld -64 … 319 -64 … 2031 -64 … 319
Nether 0 … 255 0 … 2031 0 … 255
End 0 … 255 0 … 2031 0 … 255
No client mod. No commands needed. Install, restart twice, build normally.
How it works
A dimension's height lives in its dimension_type, which is only readable from a data pack. Bukkit's World#setBlockState and every vanilla command run through Level#isInWorldBounds, which rejects anything outside the loaded column — so no plugin can raise the ceiling through the Bukkit API. The column itself has to change.
On startup the plugin:
Reads data/minecraft/dimension_type/*.json straight out of the running server jar
Copies them into <world>/datapacks/highbuild/, rewriting only min_y, height and logical_height
Registers the pack in level.dat
Step 1 is the important design choice. Because it patches the live vanilla files rather than carrying a copy inside the plugin, every other setting — sky colour, bed rules, background music, infiniburn, default_clock, anything a future version adds — is preserved automatically instead of being silently reverted to an older shape.
Two details that took real digging:
26.2 requires all four of pack_format, supported_formats, min_format and max_format in pack.mcmeta. Three other shapes are rejected, and the server's own error messages are what revealed the rule.
Bukkit.dispatchCommand truncates arguments at the /, so datapack enable file/highbuild silently becomes datapack enable file. Hence direct PackRepository access instead.
Admin-only enforcement
Players without highbuild.bypass have placements, breaks, block damage and bucket use above the vanilla limit cancelled. Optional: block them from flying up there at all.
The limit used is min(configured vanilla limit, the world's own ceiling), so a world the data pack didn't reach is never touched.
Commands
Command What it does
/hb status Build ranges per world
/hb reload Re-read config, regenerate data pack
/hb fill <x1 y1 z1> <x2 y2 z2> <block> [replace|air] Bulk fill, spread over ticks
/hb platform <radius> <block> [y] Platform under your feet
/hb tp <y> Teleport yourself to a Y level
/hb and /highbuildlimit are aliases. fill is rate-limited so a500k-block build can't trip the watchdog.
Permissions: highbuild.bypass (build high) and highbuild.admin (use the commands). Both default to op.
Configuration
Fully commented config.yml: target-max-y, per-dimension min-y / logical-height / vanilla-max-y, guard toggles, fill limits, and all messages in MiniMessage.
logical-height defaults to the full column, which means mobs can naturally spawn up high. Lower it if that bothers you — the trade-off is sky light stops above the threshold.
Limits worth knowing
Y 2031 is a hard engine limit, not a setting. I verified on a live server: Y 2032 and Y 3000 both return "That position is out of this world!". It's the chunk format's section index, so no data pack, plugin or mod can beat it.
Full restart required after install or any height change. A running world keeps the column it booted with.
Back up first. Removing the pack from a world that already used it can corrupt blocks above 319.
Don't lower the height of a world that already has blocks above the old limit.
"Ignoring heightmap data for chunk…" appears once, the first time existing chunks load after the column grows. They get recomputed. Harmless.
Verified on a real server
Not just compiled — booted Paper 26.2 and tested: column raised in all three dimensions, blocks placed and confirmed present at Y 700 and at the Y 2031 ceiling, Y 2032 and Y -65 correctly refused, blocks survived a full shutdown/restart cycle, data pack auto-enable works, and reload is idempotent. Zero exceptions in the log.
Requires: Paper 26.2, Java 25. Built from HighBuild/ with build.cmd → target/HighBuild-1.0.0.jar.
评论 0
登录后参与评分
还没有评论,来抢沙发吧