WorldEdit — плагин редактирования мира для Minecraft¶
WorldEdit — плагин (модификация) для игры Minecraft, предназначенный для массового редактирования блоков и структур в игровом мире. Первоначально разработанный как плагин для серверов на Bukkit, позднее он был портирован на Forge и Fabric, а также включён в состав модпака Create. WorldEdit позволяет выполнять операции над тысячами блоков за одну команду, что делает его стандартным инструментом для строителей, картмейкеров и администраторов серверов.
¶Возможности и принцип работы
Основной принцип WorldEdit — выделение области (кубической или произвольной формы) с помощью специальных инструментов, после чего над этой областью выполняется команда. Плагин работает с локальным клиентом сервера и обрабатывает изменения пакетно, что значительно быстрее ручной установки блоков.
Ключевые возможности:
- установка и замена блоков в заданной области;
- копирование, вставка, перемещение и вращение структур;
- генерация фигур (цилиндры, сфера, кольца, мосты);
- заполнение полостей и удаление лишних блоков;
- работа с масками и шаблонами;
- отмена и повтор последних действий (undo/redo).
¶Инструменты выделения
Для задания области используются два основных инструмента:
| Инструмент | Команда получения | Назначение |
|---|---|---|
| Wooden Axe (деревянная кирка) | //wand | Установка первой и второй точки выделения кликами по блокам |
| //pos1, //pos2 | — | Установка точек по координатам игрока |
Клик левой кнопкой по блоку устанавливает первую точку, правой — вторую. Область образуется как куб между этими точками. Альтернативный способ — команда //sel cuboid для выбора типа выделения (куб, плоскость, сфера, цилиндр, многоугольник).
¶Основные команды
¶Установка и замена блоков
//set <блок>— заполнить выделенную область указанным блоком. Пример://set stoneзаполнит область камнем.//replace <старый> <новый>— заменить один тип блоков на другой внутри выделения. Пример://replace grass dirtзаменит траву на землю.//overlay <блок>— разместить блоки поверх существующего рельефа.//naturalize— сделать верхний слой похожим на естественный грунт (трава, земля, камень).
¶Формы и генерация
//hcyl <блок> <радиус> <высота>— полый цилиндр.//cyl <блок> <радиус> <высота>— сплошной цилиндр.//hsphere <блок> <радиус>— полая сфера.//sphere <блок> <радиус>— сплошная сфера.//torus <блок> <внутренний радиус> <внешний радиус>— тор.//pyramid <блок> <размер>— пирамида.
¶Работа со структурами
//copy— скопировать выделенную область в буфер обмена.//cut— вырезать область (скопировать и заменить на воздух).//paste— вставить скопированное в позицию относительно игрока.//rotate <градусы>— повернуть содержимое буфера.//flip <направление>— отразить содержимое буфера.//stack <кол-во>— повторить содержимое выделения в заданном направлении.
¶Утилиты
//undo,//redo— отмена и повтор последнего действия (по умолчанию хранится до 15 шагов).//expand <кол-во>///contract <кол-во>— расширить или сжать выделение в направлении взгляда.//outline <блок>— создать оболочку из блоков вокруг выделения.//walls <блок>— построить стены по периметру выделения.//outlineи//faces— оболочка и грани выделения.
¶Маски и шаблоны
Маски (//mask) позволяют ограничить действие команды определёнными блоками. Например, //mask grass при выполнении //set stone заменит только траву, не затрагивая остальные блоки. Маска поддерживает комбинации через запятую и отрицание (например, //mask !stone — всё, кроме камня).
Шаблоны (//pattern) задают не один блок, а набор блоков с вероятностями. Пример: //set 75%stone,25%ore заполнит область камнем с вкраплениями руды.
¶Генераторы и схемы
WorldEdit поддерживает генераторы — плагины, создающие блоки по математическим правилам. Встроенный генератор //gen позволяет строить мосты, лестницы и другие конструкции. Команда //gen <формула> вычисляет формулу для каждой координаты.
Функции (//function) выполняют последовательность команд из файла, что упрощает повторяющиеся операции.
¶Установка и настройка
Для серверов на Spigot/Paper плагин устанавливается в папку plugins — достаточно положить туда файл worldedit-bukkit.jar. Для модовых сборок (Forge/Fabric) WorldEdit входит в состав соответствующих модпаков или устанавливается отдельно.
Основные настройки в файле config.yml:
max-blocks-changed— максимальное число изменяемых блоков за одну команду;navigation-wand— предмет для навигации;shell-save— ограничение на сохранение схем;use-inventory— требовать наличие блоков в инвентаре.
Права на команды выдаются через систему плагинов (LuckPerms, PermissionsEx). По умолчанию неопытным игрокам выдаётся только базовый набор команд.
¶Распространённые ошибки
- «Maximum blocks changed exceeded» — область слишком велика, нужно увеличить лимит в конфигурации или уменьшить выделение.
- «You don't have permission» — не выданы права на команду.
- Ошибка при
//paste— не было предварительного//copy, буфер пуст.
¶Связанные инструменты
Аналогом WorldEdit для одиночной игры является мод WorldPainter, а для визуального редактирования — Amulet. Плагин FAWE (FastAsyncWorldEdit) является асинхронным форком WorldEdit с расширенными возможностями и большей производительностью.