InventoryAdvancementAccelerator (Инвентори адвансмент акселератор)

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

Возможности

Мод создаёт отдельный индекс предметов для каждого игрока и при изменении инвентаря проверяет только условия достижений, которые могут подойти изменившимся предметам. Финальная проверка условий и выдача наград остаются ванильными.

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

Мод не изменяет данные мира, формат сохранений и сетевые каналы.

Как пользоваться

Команды для администратора сервера с уровнем прав 4:

• /invadvopt status — состояние мода.
• /invadvopt stats — статистика работы.
• /invadvopt verify — проверка результатов.
• /invadvopt mode vanilla — немедленно перейти на ванильную обработку.
• /invadvopt mode exact — включить точный режим оптимизации.
• /invadvopt reset-stats — очистить статистику.

Настройки

После первого запуска конфиг NeoForge создаётся по пути config/invadvopt-common.toml. Безопасный режим EXACT включён по умолчанию; для отключения оптимизации укажите mode = "VANILLA". Основные параметры:

• enabled — включает мод.
• shadowVerifyRate — доля проверок, сравниваемых с полной ванильной проверкой.
• periodicFullScanTicks — период полной проверки.
• fallbackOnUnknownPredicate и fallbackOnOffThreadCall — возврат к ванильной обработке в нестандартных ситуациях.
• disableOnMismatch — отключение затронутого индекса при расхождении результатов.
• metricsEnabled — сбор встроенной статистики.
• debugLogging — отладочные записи в журнале.

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

Мод предназначен для выделенного сервера на NeoForge и требует Java 21. Он рассчитан в том числе на гибридные окружения NeoForge/Bukkit/Paper.

Несовместим с achiopt, cerulean и icterine; при обнаружении конфликта сохраняется ванильная обработка достижений.