CustomWorldHeight

CustomWorldHeight - это плагин для Paper, который дает возможность менять высоту мира в Minecraft. По сути, это инструмент для тех, кому стандартные 256 блоков (или 384 с 1.18) стали тесны. Хочешь построить башню до небес или выкопать шахту до самого bedrock, но с размахом? Этот плагин для тебя.

Зачем это вообще нужно? В ванильном Майнкрафте высота мира фиксирована, и если ты захочешь сделать, скажем, огромный подземный город или небоскреб выше облаков - упрешься в лимит. CustomWorldHeight решает эту проблему: ты сам решаешь, где будет нижняя и верхняя граница. Удобно для креативных серверов, мини-игр или просто чтобы добавить вариативности в выживание.

Важно знать

Плагин работает похоже на ванильный датапак, так что у него есть те же ограничения.

Если ты уже задал высоту для мира, ОЧЕНЬ ОПАСНО ее уменьшать - все данные за пределами нового лимита просто пропадут. Расширение высоты относительно безопасно, но если опустить нижнюю границу (min-Y), новые чанки будут отличаться от уже сгенерированных.

Увеличение высоты просто пересчитывает карту высот чанка, все данные сохраняются нормально.

Возможности

• Настройка высоты мира под свои нужды.
• Работает напрямую с Paper, без костылей.
• Простой конфиг для админов сервера.

Установка

1. Скачай последнюю версию CustomWorldHeight со страницы релизов.
2. Кинь .jar файл в папку plugins на сервере и запусти его.
3. Плагин сам создаст шаблон конфига и отключится - тебе нужно его заполнить.
4. Перезапусти сервер, и высота настроенного мира изменится.

Использование API

Если ты разработчик и хочешь встроить поддержку CustomWorldHeight в свой плагин, вот пример на Kotlin и Java:

repositories {
    mavenCentral()
}
dependencies {
    compileOnly("io.github.lumine1909:CustomWorldHeight-API:0.0.1")
}

public void modifyHeight() {
    /*
    Все это работает только если мир еще не загружен!
    Изменения не постоянны! Чтобы сохранить их навсегда,
    храни данные о высоте в своем плагине и УСТАНАВЛИВАЙ ИХ ПРИ КАЖДОМ ЗАПУСКЕ!
    */

    // Устанавливаем высоту для overworld
    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'

  # Нижняя граница (min Y)
  min-y: -64

  # Высота (верхняя граница = 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'

# Можно использовать регулярные выражения
example-regex:

  regex: '^test_\\w+'

  min-y: -64

  height: 1024

  logical-height: 512

  cloud-height: 256

  dimension-type: 'custom'

Лицензия

Проект распространяется под лицензией GPL 3.0. API часть - под LGPL 3.0.

Скачайте CustomWorldHeight и настройте высоту мира под себя - будь то огромные подземелья или небесные города. На серверах с этим плагином Minecraft заиграет новыми красками.