InventoryAdvancementAccelerator

🚀 Inventory Advancement Accelerator

Когда на сервере много достижений, датапаков или игроков онлайн, ванильный Minecraft часто перебирает все связанные условия достижений. Этот мод создаёт индекс предметов для каждого игрока и отбирает только те условия, которые могут совпасть с текущим изменением инвентаря, при этом для финальной проверки по-прежнему используются ванильные предикаты и логика наград Minecraft.

Проще говоря: меньше лишних проверок при сохранении ванильного поведения. ⚡

🚀 Значительно меньше проверок кандидатов

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

🎯 Точная ванильная оценка

Финальное сопоставление по-прежнему выполняется ванильными TriggerInstance, ItemPredicate и контекстными предикатами Minecraft. Ванильная логика наград не заменяется.

🧩 Поддержка сложных условий для предметов

Корректно обрабатывает количество предметов, теги, компоненты данных, изменения пустых слотов, удаление предметов и комбинации нескольких условий.

🖥️ Установка только на сервер

Клиентам не нужно устанавливать этот мод. Ванильные клиенты могут подключаться к серверу напрямую.

🛡️ Безопасный механизм отката

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

🔍 Теневая проверка и защита автоматическим отключением

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

📊 Встроенные метрики времени выполнения

Просмотр количества срабатываний, коэффициентов сокращения кандидатов, количества полных сканирований, причин отката, распределений задержки, а также самых активных игроков и предметов.

💾 Без изменений данных мира

Мод не добавляет привязок к игроку, capability, изменений формата сохранения или сетевых каналов. Удаление мода не требует миграции сохранений.

Проект включает детерминированный микробенчмарк слоя кандидатов с:

• 5 000 слушателей условий для предметов
• 1 000 уникальных ID предметов
• 50 смоделированными игроками
• Одним изменённым типом предмета на игрока за операцию

Результаты теста:

• В среднем генерируется примерно 5,014 условий-кандидатов за операцию
• Сокращение количества кандидатов примерно на 99,9%
• Ускорение примерно в 4,04× в тесте слоя кандидатов

⚠️ Эти результаты получены из микробенчмарка слоя фильтрации кандидатов и не означают, что каждый сервер получит такое же улучшение MSPT. Фактическая производительность зависит от датапаков, количества достижений, числа игроков онлайн и окружения модпака.

После первого запуска NeoForge создаёт:

config/invadvopt-common.toml

Безопасный режим EXACT включён по умолчанию:

mode = "EXACT"
enabled = true
shadowVerifyRate = 0.01
periodicFullScanTicks = 200
fallbackOnUnknownPredicate = true
fallbackOnOffThreadCall = true
disableOnMismatch = true
metricsEnabled = true
debugLogging = false

Чтобы немедленно отключить оптимизацию, переключите режим на VANILLA. Удалять мод или перезапускать сервер не нужно.

Следующие команды требуют уровня разрешений администратора сервера 4:

/invadvopt status
/invadvopt stats
/invadvopt verify
/invadvopt mode vanilla
/invadvopt mode exact
/invadvopt reset-stats

🎮 Minecraft 1.21.1

🔧 NeoForge 21.1.x

☕ Java 21

🖥️ Выделенный сервер

👤 Установка на клиент не требуется

Поместите JAR-файл мода в папку mods сервера и запустите сервер.

Мод специально разработан с учётом гибридных серверных сред NeoForge/Bukkit/Paper, включая такие серверы, как Youer:

• Не использует @Overwrite
• Не зависит от внутренностей Bukkit
• Не использует Unsafe или хаки ClassLoader
• Автоматически сохраняет ванильную логику при изменении целей Mixin
• Обеспечивает выборочную проверку и защиту через автоматический выключатель на случай возможных различий во время выполнения

Следующие похожие моды оптимизации достижений несовместимы с этим модом:

• achiopt
• cerulean
• icterine

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

Этот мод особенно подходит для:

📚 Серверов с большими датапаками

🏆 Модпаков с большим количеством пользовательских достижений

👥 Многопользовательских серверов выживания

🧱 Модифицированных серверов, которые часто изменяют инвентари игроков

📉 Серверов, стремящихся снизить накладные расходы на проверку достижений

Вы можете откатить изменения в любой момент:

• Использовав /invadvopt mode vanilla для переключения обратно в ванильный режим
• Установив mode = "VANILLA" в файле конфигурации
• Остановив сервер и удалив JAR-файл мода напрямую

Результаты реальных тестов на сервере с 380 модами: