Neruina - Ticking Entity Fixer

Мод Neruina - Ticking Entity Fixer для Minecraft 1.21.11

Neruina — это утилита для Minecraft, которая спасает мир от необратимой порчи при возникновении крашей во время обработки тиков (ticking crashes). Мод перехватывает ошибки, вызванные сущностями, блоками или предметами, и предоставляет игрокам и администраторам набор инструментов для диагностики, локализации проблемы и принудительного завершения зависшего объекта без потери данных.

Когда сущность, блок или предмет вызывают краш при тике, Neruina перехватывает ошибку и переводит объект в безопасное состояние. Вместо того чтобы мир превратился в 'кирпич' и стал неиграбельным, зависший объект просто перестает обрабатываться. Вы можете продолжать взаимодействовать с ним (например, открыть инвентарь сущности), но атаковать его уже нельзя. Предметы в инвентаре перестают тикать, но сохраняются и продолжают работать в рецептах. Если краш вызван игроком, его выкинет из сервера, но мир останется целым.

Мод предоставляет несколько действий для управления зависшими объектами. Команда What Is This? открывает страницу вики с объяснением проблемы. Copy Crash копирует текст исключения в буфер обмена для анализа. Teleport телепортирует вас к месту нахождения зависшего объекта. Try Resume пытается возобновить тикирование объекта. Kill мгновенно уничтожает объект. В версиях 1.19 и новее доступна команда Report, которая автоматически создаёт запрос в репозиторий NeruinaAutoReports, если другие моды подключены к системе отчётности.

Для сохранения данных о проблемах между перезапусками сервера, Neruina отслеживает зависшие объекты и сохраняет эту информацию. При запуске мира мод транслирует список пространств имен (namespaces), в которых находятся объекты, требующие внимания. Это позволяет администраторам быстро оценить ситуацию после рестарта.

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

Настройки модифицируются через конфиг-файл. Можно задать минимальный уровень прав для получения сообщений от мода (по умолчанию 0) и для выполнения команд (по умолчанию 2). Параметр ticking_exception_threshold позволяет изменить лимит исключений (значение -1 отключает проверку) или полностью отключить обработку тиков (handle_ticking), вернув сервер к стандартному поведению.

Связанные материалы

• Mod Menu — похожий мод
• YetAnotherConfigLib (YACL) — похожий мод

Автор: Bawnorton · Лицензия: MIT