CustomWorldHeight

插件

· 作者 Lumine1909

一个 Paper 插件,允许你修改 Minecraft 世界的海拔高度

0 本站下载 0 关注 更新于 1 个月前

最新 2.3.1 · 26.3 · Bukkit / Folia

一键开服(送7天)

CustomWorldHeight

CustomWorldHeight 是一款适用于 Paper 的插件,允许你修改 Minecraft 世界的垂直高度。它提供了一种简单高效的方式来扩展或限制世界的垂直维度,适用于创意建筑、玩法调整或服务器优化。

Github 页面:

重要提示

本插件类似于原版数据包(datapack),因此会存在与数据包类似的一些问题。

一旦设置了某个世界的高度,缩小该世界的高度将非常危险,所有数据都会丢失。

扩展高度相对无害,但如果降低最小 Y 坐标(min-Y),新生成的区块将与已生成的区块不同。

增加高度只会导致区块的高度贴图被重新计算,所有数据都会被妥善保留。

功能特性

  • 自定义你的 Minecraft 世界高度。
  • 与 Paper 无缝集成。
  • 为服务器管理员提供易于配置的设置。

安装

请按照以下步骤安装插件:

  1. 从 Releases 页面下载 CustomWorldHeight 的最新发布版本。
  2. 将下载的 .jar 文件放入服务器的 plugins 文件夹中,然后启动服务器。
  3. 插件生成配置模板后会自动禁用,请完成配置编辑。
  4. 重启 Minecraft 服务器,配置好的世界高度将会生效。

API 用法

repositories {
    mavenCentral()
}
dependencies {
    compileOnly("io.github.lumine1909:CustomWorldHeight-API:0.0.1")
}
public void modifyHeight() {
    /*
    以下操作仅在世界尚未加载时有效!
    这不是永久性的修改!如果你想永久设置,
    请在你的插件中存储高度数据,并在每次启动时 SET IT ON EACH STARTUP!
    */

    // 设置主世界的高度
    WorldHeightService.get().registerWorld(
        Identifier.of("demo", "height1"), "world",
        new Height(1088, -64, 512, Height.CloudHeight.DEFAULT),
        BaseDimensionType.OVERWORLD
    );
    // 设置所有以 "test_" 开头的世界的高度
    WorldHeightService.get().registerRegex(
        Identifier.of("demo", "height2"), "test_\\w+",
        new Height(1088, -64, 512, Height.CloudHeight.DEFAULT),
        BaseDimensionType.CUSTOM
    );
}

配置

# 你可以设置为任意值 ([a-z0-9/._-]),它将用于生成 Identifier (ResourceLocation)
example-namespace:

  # 为特定世界设置高度,你需要将其设置为你想要修改高度的世界名称
  world: 'example-world-value'

  # 最小 Y 坐标位置
  min-y: -64

  # 高度 (最大 Y 坐标 = min-y + height - 1)
  height: 1024

  # 紫颂果传送等的高度,不能大于 height。详见 Minecraft wiki#DimensionType
  logical-height: 512

  # 云层高度 (空 -> 无云, default -> 使用默认高度)
  # 此功能仅适用于 1.21.6+
  cloud-height: 'default'

  # 对于 'overworld', 'the_nether', 'the_end', 'overworld_cave',将在世界初始化前使用内置数据生成
  dimension-type: 'overworld'

# 你可以设置为任意值 ([a-z0-9/._-]),它将用于生成 Identifier (ResourceLocation)
example-regex:

  # 本插件也支持正则表达式匹配
  regex: '^test_\w+'

  # 最小 Y 坐标位置
  min-y: -64

  # 高度 (最大 Y 坐标 = min-y + height - 1)
  height: 1024

  # 紫颂果传送等的高度,不能大于 height。详见 Minecraft wiki#DimensionType
  logical-height: 512

  # 云层高度 (空 -> 无云, default -> 使用默认高度)
  # 此功能仅适用于 1.21.6+
  cloud-height: 256

  # 这将使插件在世界加载时处理注册数据
  dimension-type: 'custom'

许可证

本项目遵循 GPL 3.0 License 开源许可。 API 部分遵循 LGPL 3.0 License 开源许可。

支持

如果你遇到任何问题或有疑问,欢迎提交 issue。


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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源