Обзор CraftAudit – инструмент для аудита изменений и отката действий

CraftAudit представляет собой мод для сервера Minecraft Forge, который ведет детальный учет всех изменений игрового мира - как вызванных действиями игроков, так и природными факторами. Полученные данные можно просматривать непосредственно в игре, выполнять пространственно-временные запросы, выполнять откат действий и восстановление объектов с поддержкой хранения в базах данных SQLite или MySQL.

Основные возможности

Регистрация изменений блоков

• Фиксация установки и разрушения блоков игроками (с опциональным сохранением состояния и NBT-данных)
• Отслеживание естественного разрушения от взрывов, жидкостей и гравитации

Логирование взаимодействий

• Операции с контейнерами: изъятие и размещение предметов
• Редактирование табличек с сохранением текста
• Воспламенение объектов: костров, свечей, динамита, огня
• Взаимодействия с редстоуном: кнопки, рычаги, двери
• Действия с рамками для предметов и картинами
• Использование ведер: наполнение, опустошение, ловля
• Убийства: запись информации об убийце, жертве, причине, оружии, дистанции и других деталях

Функции запросов

• В режиме аудита доступен просмотр логов по конкретным позициям при клике левой или правой кнопкой мыши
• Пространственно-временные запросы через команду near

Откат и восстановление

• Откат действий конкретного игрока по установке/разрушению в определенном радиусе и временном промежутке (команда rollback)
• Восстановление всех разрушений (от игроков и природы) или с фильтрацией по типу через restore
• Возврат убитых существ: возрождение неигровых сущностей на записанных позициях
• Отмена последних операций отката/восстановления командой undo

Система хранения данных

• Поддержка SQLite (по умолчанию) и MySQL
• Настраиваемое расположение файлов и параметры подключения к MySQL

Дополнительные возможности

• Локализованные названия предметов и блоков
• Режим аудита исключает логирование действий аудитора для предотвращения рекурсии

Команды и опции

Альтернативой для команды /craftaudit служит /ca. Все команды требуют уровня привилегий 2.

Базовые команды

• /craftaudit status - отображение состояния базы данных и режимов
• /craftaudit inspect (или /ca i) - переключение режима аудита
• /craftaudit log [страница] - просмотр логов взаимодействий для последнего проверенного блока
• /craftaudit blocklog [страница] - просмотр логов изменений блоков для последнего проверенного блока

Пространственные запросы

• /craftaudit near <радиус> <время> [страница] - поиск записей вблизи игрока по радиусу и времени

  Временной формат: Nс/Nм/Nч/Nд (например, 30м, 12ч, 5д)

Функции отката и восстановления

• /craftaudit rollback <игрок> <время> [радиус=10] - откат действий игрока по размещению/разрушению
• /craftaudit restore <время> [радиус=10] [тип] - восстановление различных типов событий:
  • Без указания типа - все разрушения
  • break - только разрушения игроками
  • natural или natural_break - только природные разрушения
  • explosion/fluid/gravity - разрушения от конкретных причин
  • kill или kill:<ID_сущности> - восстановление убитых сущностей
• /craftaudit undo - отмена последней операции отката/восстановления
• /craftaudit purge <время> - удаление записей старше указанного времени

Примеры временных форматов

30с, 15м, 12ч, 7д

Установка

• Поместите файл мода в папку mods сервера Forge
• Требуется Java 17 (для версий начиная с Minecraft 1.19+)
• Файл конфигурации создается после первого запуска

Конфигурация базы данных

• SQLite: стандартное расположение gameDir/craftaudit/craftaudit.db
• MySQL: настраиваемые параметры подключения включая хост, порт, имя базы, пользователя, пароль, SSL-параметры

Политика сбора данных

• Сохраняется только базовая информация о событиях, координатах и идентификаторах объектов
• NBT BlockEntity хранится сжатым, ограниченного размера для типов блоков с поддержкой настроек
• Рекомендуется регулярное использование purge для очистки устаревших записей

Технические требования для сборки

• Требуется JDK 17 и Forge MDK

1. Импортируйте проект Gradle
2. Синхронизируйте зависимости
3. Соберите JAR-файл

Участие в развитии

• Приветствуются сообщения о проблемах, запросы функций и pull-запросы

Лицензирование

Распространяется по лицензии Creative Commons Attribution 4.0 International (CC BY 4.0)