ATHENA

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

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

• Java 16
• Minecraft версии 1.17 или новее
• Paper или любые его форки

Доступные команды

• /athena listen <Название события> — начинает отслеживание определенного события. Если команда не срабатывает, необходимо указать полное имя пакета.
• /athena listeners <Название события|Плагин> — показывает список всех плагинов, которые отслеживают указанное событие, или все активные слушатели в конкретном плагине.
• /athena stop [Название события] — прекращает отслеживание определенного события или всех событий, если параметр не указан.
• /athena lookup <Команда> — находит источник команды и соответствующие права доступа для ее выполнения.

Права доступа

• athena.command.stop — доступ к команде /athena stop
• athena.command.lookup — доступ к команде /athena lookup
• athena.command.listen — доступ к команде /athena listen
• athena.command.listeners — доступ к команде /athena listeners

Важные замечания

ATHENA разработан с акцентом на удобство использования, стабильность и детализацию информации. Однако производительность не является приоритетом для этого плагина. Хотя были приложены все усилия для оптимизации, не рекомендуется использовать ATHENA постоянно, если в этом нет необходимости. Плагин активно использует механизм рефлексии для сбора данных о событиях, что может негативно сказаться на производительности сервера.

Кроме того, ATHENA старается не вмешиваться в работу других плагинов, но может влиять на показатели их оптимизации в системе мониторинга Paper Timings. Если вы измеряете производительность событий с помощью Timings и ATHENA, рекомендуется делать отдельные замеры.

Для владельцев серверов: стоит обращать внимание на производительность только в том случае, если время выполнения отдельного слушателя превышает 40 мс. Поскольку один тик в Minecraft занимает 50 мс, важно поддерживать показатель 20 TPS. Не стоит беспокоиться, если время выполнения слушателей у разных плагинов отличается — это нормально, так как некоторые плагины выполняют больше задач.

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

В случае ошибки ATHENA продолжит работу с другими слушателями, поэтому это не должно повлиять на функциональность других плагинов. События, выполняемые асинхронно, могут не определять источник плагина.

Предложения по улучшению плагина, включая оптимизацию производительности, всегда приветствуются.