Quantified API

Quantified API (QAPI) — это производительный фреймворк, предназначенный для работы с ресурсоемными задачами в модах. Он позволяет эффективно распределять нагрузку между ядрами процессора и видеокартой, минимизируя лаги и обеспечивая стабильность игры.

Quantified API (QAPI) — это фреймворк производительности, созданный для того, чтобы моды могли выполнять сложные задачи без перегрузки основного потока игры. Вместо того чтобы просто добавлять асинхронность во все процессы в надежде на стабильность, QAPI предоставляет единую среду выполнения (runtime), которая правильно управляет вычислительными задачами CPU, параллельными процессами, графами зависимостей и GPU-ускорением.

• Настоящее асинхронное планирование с использованием рабочих линий, маршрутизации нагрузки, телеметрии и безопасных сценариев отката.
• Параллельное выполнение задач, которые могут быть безопасно разделены между несколькими потоками CPU.
• Графы задач с учетом зависимостей для рабочих процессов, требующих строгого порядка выполнения.
• Маршрутизация вычислений в зависимости от бэкенда: поддержка CPU, Vulkan и OpenCL.
• Подавление дублирующихся задач: повторяющиеся идентичные операции объединяются вместо многократного выполнения.
• Продвинутое кэширование с поддержкой памяти, диска, персистентности, срока действия, сжатия и обновления.
• Автоматическая регистрация модов через метаданные Fabric, Forge и NeoForge.
• Живая диагностика через телеметрию времени выполнения и веб-панель Quantified.

QAPI предоставляет ускорение вычислений через Vulkan, которое работает без необходимости ручной настройки сложных параметров. Vulkan является предпочтительным бэкендом для GPU, в то время как OpenCL доступен в качестве альтернативы и средства отката для старого или менее совместимого оборудования.

• Изолированный поиск Vulkan: ошибки драйверов или загрузчика не приводят к краху игры.
• Отложенная инициализация: запуск GPU не конфликтует с загрузкой Minecraft.
• Чистые состояния среды выполнения: неудачно инициализированные бэкенды не считаются готовыми.
• Автоматическая маршрутизация отката: переход с Vulkan на OpenCL и, при необходимости, на CPU.
• Выбор устройств и диагностика через веб-панель.

В версии V2 среда выполнения была полностью переработана для снижения накладных расходов на выполнение задач. Это позволило значительно ускорить обработку различных типов нагрузок. Внутренние тесты показали значительный прирост производительности по сравнению с версией v1.4.4:

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

Веб-панель можно включить через конфигурационный файл или командой /quantified webpanel.

• Поддержка платформ: Fabric, Forge и NeoForge.
• Поддержка версий игры: от 1.20.1 до актуальных линий 1.21.X и 1.26.X.
• Vulkan является опциональным и корректно отключается при отсутствии поддержки.
• OpenCL доступен для старого оборудования.
• Выполнение на CPU всегда доступно как финальный вариант отката.
• Слой совместимости позволяет модам, созданным для старого API (V1), продолжать работу.

Требования проверенного файла

• По манифесту для файла quantified api-omni-2.2.0.jar (Minecraft 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2; Fabric, Forge, NeoForge) требуется fabric-api. Встроенных JAR-библиотек в проверенном файле нет.