WorldEditDisplay

О плагине

WorldEditDisplay - это серверный плагин для Майнкрафт, который решает старую проблему: игроки с WorldEdit не видят, что именно они выделили, пока не установят WorldEditCUI. Теперь им не нужно ничего ставить на клиент. Плагин перехватывает CUI-пакеты WorldEdit и отображает выделения с помощью Display Entities прямо на сервере. Всё работает на ванильных клиентах - никаких модов, никаких текстурпаков.

Возможности

Типы выделений

• Cuboid - прямоугольная область с линиями границ и сеткой
• Polygon - двухмерный многоугольник с вертикальными стенками
• Ellipsoid - гладкие эллиптические формы
• Cylinder - круговые выделения с регулируемой высотой
• Polyhedron - сложные трёхмерные многогранники

Визуал

• Использует систему Display Entity (TextDisplay) - производительнее частиц
• Настраиваемые цвета в HEX (#RRGGBBAA) для всех элементов
• Толщина линий и плотность сетки регулируется
• Полупрозрачная заливка граней для Cuboid, Polygon, Polyhedron
• Сетка, чтобы проще прикинуть размер выделения

Поддержка языков

• Традиционный китайский (zh_tw)
• Английский (en_us)
• Автоматическое определение языка клиента

Настройки игрока

Каждый игрок может подогнать отображение под себя:

• Выбрать цвета для всех элементов
• Включить/выключить заливку
• Изменить толщину линий в дозволенных сервером пределах
• Контролировать шаг и плотность сетки
• Все изменения применяются мгновенно

Шеринг выделений

• Покажите свою текущую выделенную область другим игрокам в реальном времени
• Команды: /wedisplay share invite, accept, revoke, unwatch
• Каждому общему выделению присваивается уникальный автоматически сгенерированный цвет
• Связи сохраняются даже после перезапуска сервера

Режим просмотра за всеми (только для операторов по умолчанию)

• /wedisplay view - включить просмотр выделений всех онлайн-игроков
• Скрыть конкретного игрока, включить/выключить метки с именами
• Посмотреть список отслеживаемых

Конфигурация

• Серверные настройки по умолчанию в config.yml
• Индивидуальные настройки игроков в player_config/*.yml
• Горячая перезагрузка без перезапуска сервера

Требования

• Minecraft 1.20 - 1.21.x (Paper / Folia / Spigot)
• Java 21 или выше
• Обязательные плагины:
  • PacketEvents 2.11.1+
  • WorldEdit (любая версия, поддерживающая CUI)

Установка

1. Убедитесь, что WorldEdit и PacketEvents установлены на сервере.
2. Скачайте WorldEditDisplay.jar.
3. Поместите его в папку plugins.
4. Перезапустите сервер.
5. При необходимости отредактируйте plugins/WorldEditDisplay/config.yml.
6. Используйте /wedisplayreload, чтобы применить изменения без перезапуска.

Команды

Административные

• /wedisplayreload - перезагрузить конфигурацию плагина (право: worldeditdisplay.reload, по умолчанию только op)

Игроков

Настройка внешнего вида

• /wedisplay set <renderer> <setting> <value> - изменить настройку отображения для конкретного типа выделения Пример: /wedisplay set cuboid edge_color #FFD700FF Право: worldeditdisplay.use.settings
• /wedisplay reset <renderer> [setting] - сбросить настройки до серверных Пример: /wedisplay reset cuboid (все настройки кубоида) Пример: /wedisplay reset cuboid edge_color (только цвет границы)
• /wedisplay show [renderer] - показать текущие настройки Пример: /wedisplay show (все), /wedisplay show cuboid (конкретный рендерер)
• /wedisplay toggle - включить/выключить отображение выделения
• /wedisplay reloadplayer - перезагрузить личный конфиг
• /wedisplay lang <language> - выбрать язык интерфейса (zh_tw, en_us)

Работа с общими выделениями

• /wedisplay share invite <player> - пригласить игрока смотреть ваше выделение
• /wedisplay share accept <player> - принять приглашение
• /wedisplay share revoke <player> - отозвать доступ
• /wedisplay share unwatch <player> - перестать смотреть выделение другого
• /wedisplay share list [page] - список текущих общих выделений

Режим просмотра за всеми (op)

• /wedisplay view - включить/выключить просмотр выделений всех игроков
• /wedisplay view hide <player> - скрыть игрока из вашего просмотра
• /wedisplay view hideall - скрыть всех
• /wedisplay view unhide <player> - убрать скрытие
• /wedisplay view label - включить/выключить метки с именами
• /wedisplay view list [page] - список отслеживаемых игроков

Права доступа

Все права и их описание:

• worldeditdisplay.use - базовая возможность визуализации (вкл для всех)
• worldeditdisplay.use.settings - управление личными настройками
• worldeditdisplay.use.share.* - подправа для общих выделений
• worldeditdisplay.use.view - режим просмотра за всеми (op)
• worldeditdisplay.use.view.hide - скрытие игроков (op)
• worldeditdisplay.use.view.label - включение меток (op)
• worldeditdisplay.reload - перезагрузка конфига (op)
• worldeditdisplay.render.auto-enable - автоматическое включение рендера при входе (по умолчанию да)

Конфигурация

Основной файл config.yml:

language:
  default: "en-us"
  auto_detect: true
  allow_player_change: true

renderer:
  cuboid:
    edge_color: "#FFD700FF"
    edge_thickness: 0.05
    grid_spacing: 8
    fill_enabled: true
    fill_color: "#FF000040"
    # ... и так для всех типов

player_limits:
  thickness:
    min: 0.01
    max: 0.5

У каждого типа (cuboid, polygon, ellipsoid, cylinder, polyhedron) свой набор параметров.

Как это работает

• Плагин перехватывает CUI-протокол WorldEdit на уровне пакетов
• Создаёт Display Entities (TextDisplay) для отображения форм
• При изменении выделения сущности обновляются только при необходимости - производительность не страдает
• Все расчёты выполняются на сервере, клиент остаётся ванильным

Сборка из исходников (опционально):

mvn clean package

Результат: target/WorldEditDisplay-version-platform.jar

Итог

WorldEditDisplay - это буквально must-have для любого сервера, где используется WorldEdit. Раньше игроки либо ставили WorldEditCUI, либо тыкали вслепую. Теперь достаточно установить один плагин - и все видят свои выделения цветными линиями, сеткой и заливкой. Настройки гибкие, шеринг удобный, а производительность на высоте. Скачайте WorldEditDisplay на свой сервер и забудьте про невидимые выделения.