Ultraborder

UltraBorder

UltraBorder — это серверный плагин с опциональным клиентским модом для Fabric. Он поддерживает круглые или квадратные границы мира и свободно ориентированные двусторонние стены.

Возможности

• Одна настраиваемая граница на мир: circle или square, с настраиваемым центром и радиусом.
• Любое количество именованных прямых или диагональных стен на мир.
• Конечная или бесконечная ширина и конечная или полная высота мира.
• Двусторонняя коллизия для движения и телепортации.
• Право на обход: ultraborder.bypass.
• С клиентским модом: поверхности, отрисовываемые на GPU, с использованием анимированной ванильной текстуры границы мира Minecraft и конвейера отрисовки.
• Отрисовка в пределах эффективной дальности прорисовки клиента, независимо от дальности сущностей и частиц.
• Без клиентского мода: плагин остаётся рабочим и отображает частицы в качестве запасного варианта. Квадратные границы по-прежнему используют нативную границу мира Minecraft.
• Клиентский мод может быть опциональным или обязательным по решению администратора сервера.
• Конфигурация хранится в plugins/UltraBorder/config.yml.
• Включено автодополнение команд по Tab.

Совместимость

• Сервер: разработан для Paper и основан только на классах Bukkit API. Spigot также должен быть совместим, но ещё не тестировался во время выполнения.
• Клиентский мод: требует Fabric Loader и Fabric API версий, совместимых с версией Minecraft, используемой на сервере.
• Игроки без клиентского мода могут присоединиться, если client-mod.required установлено в false.

Установка

1. Поместите собранный JAR серверного плагина UltraBorder в директорию plugins сервера.
2. Опционально установите соответствующий JAR клиентского мода UltraBorder, Fabric Loader и Fabric API на каждом клиенте.
3. Запустите или перезапустите сервер. По умолчанию клиентский мод опционален.

Требование клиентского мода

Требование можно настроить на постоянной основе в plugins/UltraBorder/config.yml:

client-mod:
  required: false
  handshake-timeout-ticks: 100
  kick-message: "§cThe UltraBorder client mod is required on this server."
  disable-particles-for-modded-players: true

• required: false: игроки с клиентским модом и без него могут присоединиться.
• required: true: игроки без совместимого клиентского мода отключаются после тайм-аута рукопожатия.
• handshake-timeout-ticks: время, отведённое на рукопожатие клиентского мода. Двадцать тиков равны примерно одной секунде.
• disable-particles-for-modded-players: отключает запасные частицы для игроков, использующих клиентский мод. Настройку также можно изменить во время работы сервера:

/ub modrequired <true|false>

Эта команда сохраняет новое значение в файл конфигурации.

Команды

/ub border create <circle|square> <radius> [centerX centerZ]
/ub border center <x> <z>
/ub border radius <radius>
/ub border shape <circle|square>
/ub border info
/ub border delete

/ub pos1 [x y z]
/ub pos2 [x y z]
/ub wall create <name> [infiniteWidth] [infiniteHeight]
/ub wall center <name> <x> <z>
/ub wall infinitewidth <name> <true|false>
/ub wall infiniteheight <name> <true|false>
/ub wall info <name>
/ub wall list
/ub wall delete <name>

/ub modrequired <true|false>
/ub reload

Запуск /ub pos1 или /ub pos2 без координат использует текущую позицию игрока. Для стен с конечной высотой две координаты Y определяют нижний и верхний края.

Права

ultraborder.admin
ultraborder.bypass

• ultraborder.admin: даёт доступ к административным командам UltraBorder. По умолчанию назначается операторам сервера.
• ultraborder.bypass: позволяет игроку пересекать все настроенные границы и стены.

Отрисовка

Немодифицированный клиент Minecraft может нативно отображать только одну выровненную по осям квадратную границу мира. Круглые границы, диагональные стены и несколько независимых стен не могут быть переданы как нативные границы мира через ванильный протокол. Поэтому опциональный клиентский мод для Fabric строит круги и стены как мировую геометрию. Он использует встроенную текстуру forcefield Minecraft и конвейер отрисовки границы мира. Для модифицированной отрисовки не используются частицы или сущности, поэтому дальность сущностей не влияет на её видимость. Игроки без мода получают серверный запасной вариант с частицами для круглых границ и стен. Коллизия в обоих случаях обеспечивается сервером.

Сборка

Сборка и тестирование серверного плагина:

mvn test package

Сборка клиентского мода для Fabric на Windows:

cd client-mod
gradlew.bat build

На Linux или macOS:

cd client-mod
./gradlew build

Результат сборки содержит JAR серверного плагина и JAR клиентского мода. Их точные имена и расположение могут различаться в зависимости от версии и конфигурации сборки.

Пример

Создать круглую границу с центром в 0, 0 и радиусом 1 000 блоков:

/ub border create circle 1000 0 0

Создать бесконечно широкую и бесконечно высокую стену, используя текущие позиции игрока:

/ub pos1
/ub pos2
/ub wall create middle true true