Artemis

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

Интеграция с Forge

Хотя базовая функциональность Artemis теперь встроена в загрузчик модов Forge, его реализация значительно упрощена и не включает такие возможности, как вывод многострочных стеков вызовов, игнорирование внутренних классов и создание файлов отчетов. Artemis берет на себя управление стандартными потоками от FML на этапе предварительной инициализации. До этого момента (например, во время инициализации кор-модов) перенаправлением занимается FML — это ограничение связано с тем, что Artemis загружается как обычный мод после кор-модов.

Установка

Просто скачайте файл JAR и поместите его в папку mods. Мод работает как на клиенте, так и на сервере.

Использование

Мод не добавляет внутриигровых команд или элементов управления — его единственная задача заключается в улучшении файлов логов.

Настройки

Файл конфигурации находится в стандартной папке config под именем Artemis.cfg. Доступны следующие параметры:

• Отчеты
  • (Логический) createBlamefile — создает файл отчетов Artemis при завершении игры (по умолчанию false; см. раздел "Крюк завершения JVM" ниже)
• Логирование
  • (Логический) ignoreBuiltins — игнорировать внутренние классы, соответствующие встроенному регулярному выражению (по умолчанию false; см. раздел "Встроенные" ниже)
  • (Целочисленный) stackDepth — количество строк стека вызовов для отображения в каждой записи лога (по умолчанию 1)
• Встроенные
  • (Строка) customRegex — регулярное выражение для определения внутренних классов (по умолчанию "^paulscode..|^java.lang..|^com.intellij..|^sun..")
  • (Логический) useCustomRegex — использовать регулярное выражение из конфигурации вместо стандартного (по умолчанию false)
• Карта идентификаторов
  • (Логический) mapModIds — заменять имена классов на идентификаторы соответствующих модов (не влияет на формат вывода в файле отчетов)

Крюк завершения JVM

Для создания файла отчетов при завершении работы сервера мод добавляет так называемый "крюк завершения JVM" во время предварительной инициализации. Это позволяет запланировать задачу, которая выполнится при закрытии игры (и, соответственно, JVM). Такое решение необходимо, поскольку Forge не предоставляет соответствующих событий, а моды могут продолжать записывать логи в процессе завершения работы. Крюк гарантирует, что эта операция выполняется последней. По умолчанию функция отключена, поэтому файл отчетов не создается.