CoreProtect-additions

CoreProtect-additions - аддон для CoreProtect, который добавляет журналирование действий, пока не поддерживаемых самим CoreProtect. Это серверная утилита для администраторов Minecraft: она помогает понять, кто и когда запустил рейд, поджег TNT, сломал поводок, забрал моба ведром или изменил содержимое транспортного контейнера.

Обычный CoreProtect хорошо фиксирует блоки, предметы и стандартные взаимодействия игроков. Но в Minecraft немало событий, которые происходят через мобов, транспорт, физику или особые механики. Именно здесь и нужен CoreProtect-additions. При расследовании грифа такие записи заметно сокращают ручную проверку логов и позволяют точнее подготовить откат.

Что журналирует аддон

CoreProtect-additions отслеживает следующие действия:

• Переименование мобов с помощью бирки
• Использование золотого одуванчика на мобах
• Запуск рейдов
• Покраску существ, включая овец и ошейники собак
• Установку и разрушение лодок и вагонеток
• Посадку в транспорт и выход из него
• Посадку на мобов и спешивание
• Поджигание TNT
• Взрыв огненных шаров криперов и гастов
• Поджигание серных кубов
• Надевание и снятие поводков с мобов
• Установку точки возрождения на кровати или якоре возрождения
• Взрыв кроватей и якорей возрождения
• Открытие интерфейсов контейнеров у существ и транспорта
• Броски wind charge
• Активацию блоков с помощью wind charge
• Поглощение воды губками
• Ломание дверей зомби
• Добавление и извлечение предметов из цветочных горшков
• Размещение паутины эффектом Weaving
• Заражение блоков чешуйницами
• Эффект Frost Walker
• Подбор и размещение мобов, которых можно переносить в ведре
• Превращение жителей и свиней молнией
• Подбор и выбрасывание предметов существами, включая Allay и зомби
• Передачу предметов Allay напрямую от игрока
• Экспериментальное журналирование контейнеров вагонеток с сундуком и воронкой

Это особенно полезно на выживании, анархичных проектах и серверах с активной торговлей. Например, если из базы исчезла лодка с сундуком или моб внезапно оказался в другом месте, стандартного журнала блоков может быть недостаточно. Дополнительные записи CoreProtect-additions дают администратору больше зацепок.

Совместимость и требования

Актуальный релиз CoreProtect-additions 0.11.1 Beta рассчитан на Minecraft Java Edition 26.2, 26.1.x и 1.21.10-1.21.11. Плагин заявлен для серверных платформ Paper, Purpur и Folia. Для работы требуется CoreProtect 23.1.

Это именно плагин для сервера, а не клиентский мод для Fabric, Forge, NeoForge или Quilt. Игрокам не нужно устанавливать отдельный мод или ресурспак: журналирование выполняется на стороне сервера.

В версии 0.11.1 удален отладочный код, улучшена обработка серных кубов и исправлен момент записи их взрыва. Теперь событие фиксируется во время взрыва, а не в момент поджигания.

Формат записей CoreProtect

Для поиска используются те же форматы действий, что и в команде /co lookup. Из-за ограничений API CoreProtect часть событий записывается не отдельными типами, а как a:block, a:click или a:item. Предмет в такой записи служит дополнительным признаком действия.

Для a:block, если не указать + или -, поиск учитывает обе разновидности действия.

Записи a:block

• a:+block i:<dye> - покраска моба, например овцы или ошейника собаки. Координаты указывают место, где находился моб, а предметом считается использованный краситель.
• a:+block i:name_tag - переименование моба. Старое и новое имя не сохраняются, но записывается координата существа.
• a:-block i:ominous_bottle - запуск рейда. Координаты соответствуют месту начала рейда.
• a:-block i:creeper_spawn_egg - действие, приведшее к взрыву крипера. В записи указывается координата крипера.
• a:-block i:fire_charge - взрыв огненного шара гастa. Координаты относятся к самому огненному шару.
• a:block i:<vehicle> - установка или разрушение лодки либо вагонетки любого типа. В поле предмета указывается конкретный транспорт, например oak_chest_boat.
• a:block i:<spawn_egg> - посадка в лодку или вагонетку и выход из нее, если эта опция включена в конфигурации.
• a:block i:<spawn_egg> - посадка на моба или спешивание. Яйцо призыва показывает, на каком существе ехал игрок.
• a:block i:lead - установка или снятие поводка. Сюда также относится случай, когда игрок уезжает верхом на мобе, оставив его на поводке.
• a:block i:lead - установка или снятие поводка с ограждения. Тогда координаты относятся к столбу забора, а не к существу.
• a:block i:<mob_bucket> - помещение моба в ведро или выпуск моба из ведра.

Для поводков есть практический нюанс: если сломать забор, к которому привязан моб, запись появится как a:-block i:lead от пользователя #physics. Чтобы установить, кто именно разрушил ограждение, потребуется отдельный ручной поиск по логам.

Записи a:click

Тип a:click используется для большинства остальных взаимодействий:

• a:click i:tnt - поджигание TNT.
• a:click i:creeper_spawn_egg - поджигание крипера огнивом или огненным зарядом. Координаты относятся к криперу в момент взрыва, а не к моменту поджигания.
• a:click i:sulfur_cube_spawn_egg - поджигание серного куба огнивом, попадание куба в огонь или привязывание его к огню. Запись создается в месте взрыва.
• a:click i:<bed> - установка точки возрождения на кровати или ее взрыв. Цвет кровати указывается отдельно, например magenta_bed.
• a:click i:respawn_anchor - установка точки возрождения на якоре возрождения или взрыв якоря.
• a:click i:<spawn_egg> - открытие контейнера моба с сундуком, например ламы или осла.
• a:click i:<vehicle> - открытие инвентаря транспорта, такого как вагонетка с воронкой или лодка с сундуком, а также посадка в лодку или вагонетку и выход из нее.
• a:click i:golden_dandelion - использование золотого одуванчика на мобе для блокировки или разблокировки роста. Координаты указывают место существа.

Название a:click не означает обычный клик по блоку в привычном смысле. В CoreProtect-additions это технический способ представить событие через доступный API CoreProtect, поэтому при расследовании лучше учитывать и действие, и значение i:.

Wind charge и связанные события

Броски wind charge записываются как a:item. В результатах /co lookup это отображается примерно как запись о том, что пользователь бросил wind_charge, по аналогии с другими снарядами.

Кнопки, двери, рычаги и другие блоки, активированные wind charge, журналируются так, будто их нажал игрок или Breeze, выпустивший заряд. Это позволяет отследить не только сам снаряд, но и последствия его попадания по механизму.

Особые пользователи в журнале

Некоторые действия выполняются не игроком напрямую. В таких случаях аддон использует технические имена пользователей, чтобы событие можно было найти и откатить:

• Губки записываются от пользователя #sponge. В журнал попадают блоки, поглощенные губкой, включая воду, ламинарии и морскую траву.
• Ломание дверей зомби записывается от #zombie. То же относится к вариантам зомби, например кадаврам и зомби-жителям.
• Паутина, размещенная эффектом Weaving, записывается от #weaving.
• Превращение молнией записывается от #lightning. Событие отображается как убийство моба, благодаря чему его можно откатить.
• Когда игрок передает предмет Allay, операция отображается как выбрасывание предмета игроком, а его подбор фиксируется от #allay. Координаты относятся к месту, где находился Allay.

Цветочные горшки тоже обрабатываются особым образом. При замене растения аддон записывает разрушение старого горшка и установку нового potted_plant. Поэтому такую операцию можно откатить средствами CoreProtect.

Инвентари мобов и транспорта

В конфигурации есть экспериментальная функция журналирования инвентарей сущностей. Она предназначена для контейнеров, с которыми обычный CoreProtect не всегда умеет работать напрямую:

• ослы и мулы;
• лодки с сундуками;
• вагонетки с сундуками;
• вагонетки с воронками;
• другие сущности с собственным инвентарем.

Функция отключена по умолчанию. Это технический обходной путь: у CoreProtect нет официального API для полноценного перехвата таких транзакций. В ограниченных проверках возможность работала, но при нестандартных сценариях могут появиться ошибки. При сбое журналирование должно отключиться до следующего перезапуска сервера.

На рабочем сервере эту опцию лучше включать после резервной копии и проверки на тестовом мире. Особенно внимательно стоит проверить перенос предметов через сундуки лодок, вагонетки и инвентари мобов, потому что экспериментальная функция затрагивает именно эти операции.

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

Настройки доступны в конфигурационном файле плагина. Названия параметров рассчитаны на самостоятельное чтение, а рядом с ними есть комментарии.

Есть важный нюанс: пользовательские комментарии в конфиге удаляются при следующей перезагрузке плагина. Поэтому собственные заметки лучше хранить отдельно, а не добавлять прямо в файл настроек.

Известная проблема с предпросмотром отката

Из-за ошибки в CoreProtect предпросмотр отката через #preview иногда завершается неожиданно. Проблема связана с отдельными предметами, которые могут вызывать сбой при формировании предварительного результата.

Чтобы избежать ошибки, придется исключить все потенциально проблемные предметы из такого запроса. Полный список зависит от версии CoreProtect и самого набора данных сервера, поэтому перед массовым откатом стоит сначала проверить запрос на копии мира.

Обычный откат без параметра #preview должен работать корректно. Но перед серьезными операциями резервная копия мира все равно обязательна: CoreProtect-additions расширяет журналирование, а не заменяет стандартную процедуру восстановления сервера.

Ограничения

Если TNT поджигается взрывом кровати или якоря возрождения, событие сейчас записывается как a:click i:tnt от пользователя #block. В идеальном варианте такая запись должна была бы указывать игрока, который активировал кровать или якорь, но текущая цепочка событий этого не сохраняет.

Взрыв крипера фиксируется по координатам существа в момент взрыва. Поэтому запись о поджигании и запись о самом взрыве могут не совпадать по времени или отсутствовать как отдельное действие.

То же относится к некоторым физическим взаимодействиям. Например, разрушение забора с поводком фиксируется через #physics, и для определения реального игрока потребуется сопоставить несколько записей /co lookup.

Зачем нужен CoreProtect-additions

CoreProtect-additions не добавляет новые блоки, предметы или механики в Minecraft. Его задача практичнее: расширить аудит сервера там, где обычного журнала CoreProtect недостаточно. Администратор получает записи о действиях мобов, специальных предметах, транспорте, взрывах и нестандартных взаимодействиях.

Для небольшого приватного мира плагин может оказаться избыточным. На сервере с несколькими игроками, торговлей, рейдами и общей инфраструктурой он заметно полезнее: проще выяснить, кто запустил рейд, почему исчез моб, откуда взялся взрыв или каким образом изменилось содержимое вагонетки.

По факту это инструмент для точного расследования и отката. Он работает в привычной экосистеме CoreProtect, использует его форматы a:block, a:click и a:item, но закрывает заметные пробелы в журналировании Minecraft Java Edition.