AsyncWorldEdit помогает уменьшить лаги при выполнении крупных операций WorldEdit, обрабатывая изменения блоков через настраиваемую очередь. Плагин работает вместе с WorldEdit и не заменяет его, поэтому игроки могут пользоваться привычными инструментами и командами WorldEdit.
### Возможности
✅ **Постановка блоков через очередь** — распределяйте крупные изменения по игровым тикам сервера, настраивая скорость обработки и размер пакетов.
✅ **Совместимость с WorldEdit** — продолжайте пользоваться операциями, командами и привычным процессом редактирования WorldEdit.
✅ **Адаптивные профили производительности** — выбирайте безопасный, сбалансированный или быстрый режим с настраиваемыми лимитами блоков и времени.
✅ **Защита с учётом TPS** — автоматически приостанавливайте и возобновляйте обработку очереди при достижении заданных порогов TPS.
✅ **Защита очереди и памяти** — задавайте общие лимиты, лимиты для игроков и миров, а также защиту на случай нехватки памяти.
✅ **Адаптеры Paper DirectChunk** — адаптеры для разных версий Paper 1.21+ и API DirectChunk для интеграций, которым нужны операции на уровне чанков.
✅ **Асинхронные операции с чанками** — очистка, обновление освещения, копирование, вставка, клонирование, заполнение и замена блоков, а также установка биомов через очередь.
✅ **Управление заданиями** — просмотр очереди, отмена заданий, очистка очередей и настройка скорости установки блоков.
✅ **API прогресса и паузы** — интеграции могут отправлять задания, отслеживать их выполнение, отмену и прогресс, а также приостанавливать и возобновлять отдельные задания.
✅ **Настройки данных отмены** — задавайте обработку данных отмены при нехватке памяти и сохраняйте их на диск.
✅ **Состояние сервера** — команда `/awe status` показывает TPS, размер очереди, активные задания, состояние паузы, использование памяти, перцентили длительности тиков и размеры очередей по мирам.
✅ **Журнал прерванных изменений** — просматривайте записи об операциях, прерванных из-за аварийного завершения сервера. Записи требуют проверки администратором; автоматического повторного выполнения нет.
✅ **Метрики Prometheus** — при необходимости публикуйте метрики очереди, миров, TPS, длительности тиков и использования памяти JVM.
✅ **Тестовый стенд производительности** — отдельно соберите тестовый плагин для измерения производительности вставки, отмены и повтора изменений на изолированном тестовом сервере.
✅ **Настраиваемые сообщения и управление** — настраивайте параметры AWE, скорость для игроков, работу очереди и уведомления с помощью команд и конфигурации.
### Происхождение проекта
AsyncWorldEdit - форк [оригинального проекта SBPrime].
### Поддержка
- Paper 1.21.4–1.21.11: Java 21 и WorldEdit 7.4.2
- Paper 26.3: Java 25 и WorldEdit 7.4.6
- WorldEdit обязателен.
- Совместимость с Paper проверяется при сборке и тестовом запуске сервера.
### Зависимости
- [WorldEdit] - обязателен. Перед установкой AsyncWorldEdit скачайте и установите версию, совместимую с вашим сервером Paper. AsyncWorldEdit расширяет возможности WorldEdit, но не заменяет его.
### Основные команды
#### Задания и очереди
- `/awe jobs [page]` - список ваших заданий в очереди
- `/awe jobs [page]` - просмотр заданий другого игрока
- `/awe jobs all [page]` - список всех заданий в очереди
- `/awe cancel #` - отмена одного из ваших заданий
- `/awe cancel #` - отмена заданий другого игрока или всех заданий
- `/awe purge [player|all]` - удаление операций с блоками из очереди
#### Настройки игрока
- `/awe speed [player] [speed]` - просмотр или изменение скорости установки блоков
- `/awe toggle [player] [on|off]` - включение или отключение обработки AWE
- `/awe undo [player] [on|off]` - настройка режима отмены изменений
- `/awe messages` — настройка отображения сообщений AWE
#### Администрирование
- `/awe status` - просмотр статистики очереди, TPS, памяти и обработки
- `/awe recovery` - просмотр записей о прерванных изменениях
- `/awe recovery ack ` - удаление проверенной записи восстановления
- `/awe reload [all|config|groups]` - перезагрузка конфигурации или групп игроков
- `/awe help [command]` - справка по командам
AsyncWorldEdit предназначен для серверов Paper с WorldEdit, где выполняются крупные постройки и редактирование спавнов, карт, городов и других больших территорий.
### Условия использования
- Запрещено распространять этот плагин в любой форме.
- Запрещено декомпилировать или изменять код, а также выдавать его за свой.
- Использовать плагин можно только на собственном сервере или в собственной сети.