Quantified API

Что такое Quantified API и зачем он нужен

Quantified API (или просто QAPI) - это не мод, который ты визуально заметишь в игре. Это производительный фреймворк для разработчиков, который решает одну из главных проблем Майнкрафт-моддинга: перегрузку основного потока (main thread).

В ванильном Minecraft все игровые процессы - тики, рендер, логика - крутятся в одном потоке. Когда моды начинают делать там свои расчёты, игра начинает тормозить, фризить и в целом вести себя нестабильно. Quantified API предлагает единую среду для выполнения задач: асинхронный планировщик, многопоточность, графы зависимостей, продвинутое кэширование и GPU-ускорение. Всё это работает без танцев с бубном.

Что изменилось в V2

С выходом второй версии Quantified API переписали практически с нуля. Планировщик, система кэширования, GPU-роутинг, совместимость с загрузчиками - всё стало быстрее и надёжнее. Появилась полноценная документация: от установки до продвинутых вычислительных нагрузок и примеров.

Основные возможности

• Асинхронный планировщик с рабочими линиями (worker lanes), роутингом нагрузки и телеметрией. Если что-то пошло не так - есть разумное поведение по умолчанию (fallback).
• Параллельное выполнение задач, которые можно безопасно разделить между потоками CPU.
• Графы задач с зависимостями - когда одни джобы должны выполняться строго после других.
• GPU-ускорение через Vulkan (основной бэкенд) и OpenCL (запасной). Причём GPU не используется для каждой мелочи - система оценивает нагрузку, состояние рантайма и доступное железо.
• Подавление дублирующихся задач - если один и тот же расчёт запускается сотни раз, он выполняется один раз, а результат кэшируется.
• Продвинутое кэширование с поддержкой памяти, диска, персистентности, сжатия и автообновления.
• Автоматическая регистрация модов через метаданные Fabric, Forge и NeoForge.
• Живая диагностика через встроенную веб-панель (Quantified Webpanel).

Производительность: цифры говорят сами за себя

Внутренние тесты по сравнению с версией v1.4.4 показали впечатляющий прирост:

Тип нагрузки	Ускорение
Мелкие уникальные задачи	~3.95x быстрее
Потоки дублирующихся задач	~45.4x быстрее
Малые параллельные нагрузки	~5.54x быстрее
Средние параллельные нагрузки	~9.16x быстрее
Малые DAG-нагрузки (графы зависимостей)	до ~2952x быстрее

Подавление дублирования улучшилось с 2048 реальных выполнений до 1 в тестовом сценарии. То есть V2 - это не просто апдейт, а полноценный переворот.

Совместимость

Quantified API поддерживает Fabric, Forge и NeoForge для версий Minecraft от 1.20.1 до актуальных 1.21.X и 1.26.X. Vulkan опционален и при отсутствии деградирует чисто на CPU. OpenCL остаётся для старого или менее совместимого железа. Моды, написанные под V1, продолжают работать через слой совместимости.

Веб-панель Quantified

Встроенная веб-панель позволяет разработчикам и пользователям в реальном времени видеть, чем заняты фоновые потоки. Включается через конфиг или командой /quantified webpanel. Показывает:

• активность планировщика и очереди,
• состояние CPU и GPU бэкендов,
• какие моды используют API,
• диагностику Vulkan и OpenCL,
• выбор предпочтительного GPU,
• экспорт диагностики для отладки.

Лицензия и использование

Quantified API распространяется под лицензией BRSSLA V1.5 - бесплатно для личного и некоммерческого использования. Разработчики модов, которые добавляют QAPI как зависимость, автоматически получают коммерческие права на свой мод.

Если у тебя есть идеи, багрепорты или предложения по документации - можно открыть issue или pull request на GitHub.

Итог

Quantified API - это не очередная "оптимизация ради оптимизации", а серьёзный инструмент для разработчиков, которые хотят делать моды без лагов и фризов. Если ты собираешь сборку модов или пишешь свой мод - QAPI может стать тем самым фундаментом, который сделает всё стабильным и быстрым.