FastAsyncWorldEdit — плагин для асинхронного и быстрого редактирования мира в Minecraft

FastAsyncWorldEdit — плагин для асинхронного и быстрого редактирования мира в Minecraft

FastAsyncWorldEdit (сокращенно — FAWE) — это форк классического плагина WorldEdit для Minecraft, в котором переписана внутренняя обработка изменений. Обычный WorldEdit выполняет крупные команды в главном потоке сервера, поэтому изменение сотен тысяч блоков вызывает фризы и тайм-ауты. FAWE разбивает работу на потоки, группирует операции по чанкам и выполняет запись параллельно — тот же //set на области 500×500 проходит без зависания тиков.

Если на сервере уже установлены плагины, зависящие от WorldEdit (защита регионов, генераторы структур, плагины для строительства), достаточно заменить WorldEdit на FAWE. Команды и API остаются совместимыми, но скорость выполнения возрастает.

Результат команды //set glass на выделенной области — куб из стекла. Фон — пустая площадка из белого бетона вокруг. 

Что FAWE добавляет поверх WorldEdit

Базовые команды выглядят так же: //pos1, //pos2, //set, //copy, //paste, //undo. Принципиальная разница — в том, как они обрабатываются внутри. К этому добавлено около 200 новых команд: расширенные маски, паттерны, трансформации, специализированные кисти и инструменты для работы с рельефом.

Отдельные вещи, которых в ванильном WorldEdit нет:

• Неограниченный //undo и //redo с историей на диске. Отмена доступна даже после перезапуска сервера.

• //lazycopy — мгновенное копирование выделенной области любого размера без полной загрузки копии в память.

• CFI (Create From Image) — генерация мира из карты высот или изображения (/cfi).

• Anvil-команды — массовые изменения в region-файлах напрямую: удаление всех сундуков, обрезка карты, замена блоков в выбранном регионе.

• Команды освещения — /fixlighting, /setlight, /removelight для ручного перерасчета без перезагрузки чанков.

• Инспекция и откат — //inspect показывает, кто и когда поставил блок, //history rollback возвращает мир к состоянию до определенной даты.

Окно чата с выводом команды /we help — список категорий FAWE с краткими описаниями. 

Выделение и базовые команды

Выделение создается деревянным топором. Левый клик ставит первую точку, правый — вторую. Альтернативно: //pos1 и //pos2 ставят точки по текущим координатам игрока, //hpos1 и //hpos2 — по блоку, на который наведен прицел.

После выделения доступны базовые операции с блоками:

Также полезны: //copy -b копирует вместе с биомами, //copy -e пропускает сущности, //paste -a игнорирует блоки воздуха из схематики (сохраняет то, что уже есть в целевой области).

Кисти и инструменты

Кисти — это команды, привязанные к предмету в руке. После команды /br <тип> правый клик активирует действие в точке прицела. Чаще всего используются:

• /br sphere <блок> <радиус> — сфера заданного радиуса в точке клика.

• /br cyl <блок> <радиус> <высота> — цилиндр.

• /br smooth <радиус> — сглаживание рельефа.

• /br stencil <паттерн> <радиус> <файл> — рисование по карте высот или изображению.

• /br spline <паттерн> — построение кривой через несколько точек (дорог, туннелей, мостов).

• /br sweep — протягивание содержимого буфера обмена по кривой.

• /br scatter <паттерн> <плотность> — случайное разбрасывание блоков или схематик с заданной плотностью.

• /br copy — копирование объекта левым кликом, вставка правым. Флаг -r добавляет случайное вращение при вставке.

Кисть /br smooth 10  в работе 

Для кистей задаются маски (/mask) и паттерны (/mat). Маска определяет, какие блоки можно заменять: /mask >stone — только блоки над камнем, /mask <air — только блоки под воздухом. Паттерн определяет, чем заменять: /mat 50%stone,50%cobblestone даст случайную смесь камня и булыжника в пропорции 50/50, /mat #surfacespread[3][stone] — спред-паттерн с рассеиванием на радиус 3.

Schematics — структуры в файлах

FAWE поддерживает форматы .schem и .schematic. Команды:

• //schem save <имя> — сохраняет текущее выделение в plugins/FastAsyncWorldEdit/schematics/.

• //schem load <имя> — загружает файл в буфер обмена.

• //schem list — список доступных схематик.

• //schem delete <имя> — удаление.

Отдельно работает /download — создает анонимную ссылку на буфер обмена через сервис schem.intellectualsites.com. Ссылка временная, файл можно передать другому игроку или серверу без ручного экспорта через FTP. В конфиге это регулируется секцией web.

Защита регионов и per-player лимиты

FAWE интегрируется с WorldGuard и PlotSquared. Опция region-restrictions: true в config.yml ограничивает редактирование зонами, в которые добавлен игрок.

По умолчанию работает режим MEMBER — игрок редактирует только там, где он является участником региона. Альтернатива — OWNER. Админы обходят ограничения через право fawe.bypass. Для серверов с несколькими защищенными зонами и свободной застройкой в остальном мире более удобен режим черного списка: allow-blacklists: true плюс worldguard-region-blacklist: true позволяет редактирование везде, кроме защищенных регионов.

Для разных групп игроков настраиваются отдельные лимиты. Блок default копируется под новым именем, значения max-changes, max-brush-radius и max-iterations изменяются, игроку выдается право. Так на одном сервере сосуществуют жесткие лимиты для новичков и расширенные для доверенных игроков.

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

Основные файлы расположены здесь: plugins/FastAsyncWorldEdit. Большинство значений по умолчанию подходят для типичного сервера — есть смысл затрагивать лишь несколько ключевых блоков.

Память и ограничения

Очередь и потоки

История и буфер обмена

Вывод

FastAsyncWorldEdit убирает основное ограничение обычного WorldEdit, из-за которого масштабные редактирования останавливали сервер. На серверах-сборках и строительных сетях, где игроки одновременно работают с сотнями тысяч блоков, FAWE убирает тайм-ауты и фризы. На малых survival-серверах с редкими редактированиями выигрыш не так заметен, но плагин не вредит — он обратно совместим по API.

Для серверов с масштабным строительством FastAsyncWorldEdit более практичен для выбора, для эпизодического редактирования ванильного мира — подойдут аналоги.