Перейти к содержимому
Mineforgian

Quantified API

A high-performance API for Minecraft mods, built to handle tasks efficiently, reduce lag, use GPU acceleration, smart caching, and multithreading - keeping your game smooth and stable.

Загрузки
29K
Подписчики
5
Обновлён
28 июня 2026 г.
Лицензия
BRSSLA-V1.5

Опубликован 28 января 2026 г.

Исходный код

《▓ Quantified API ▓》

Quantified API Banner

Quantified API, or QAPI, is a performance framework for mods that do a bit more than just slap random async onto everything and pray it doesn't implode xd

Its goal is pretty simple: stop mods from frying the main thread and provide one shared runtime that can properly manage CPU work, parallel tasks, caching, dependency graphs, and GPU acceleration without turning the game into a deadlock simulator.

《▒ Welcome to the New Generation ▒》

With the release of V2, Quantified API has been upgraded by a LOT.

The scheduler, CPU runtime, caching system, task graphs, GPU routing, compatibility layer, supported platforms, build system, and general API design have all been heavily improved or completely rebuilt.

Quantified API now also has full official documentation, covering everything from basic installation to advanced compute workloads, GPU routing, caching, migration, troubleshooting, and examples :DDD

Explore the new Quantified API documentation

《▒ What It Actually Does ▒》

  • Proper async scheduling with worker lanes, workload routing, telemetry, and sane fallback behaviour
  • Parallel execution for workloads that can be safely divided across multiple CPU threads
  • Dependency-aware task graphs for workflows where jobs need to run in a specific order
  • Backend-aware compute routing across CPU, Vulkan, and OpenCL
  • Duplicate task suppression so repeated identical work can be merged instead of executed hundreds of times
  • Advanced caching with memory, disk, persistence, expiration, compression, and refresh support
  • Automatic mod registration through Fabric, Forge, and NeoForge metadata
  • Live diagnostics through runtime telemetry and the Quantified webpanel

《▒ Vulkan and OpenCL Acceleration ▒》

Quantified API provides Vulkan compute acceleration that simply works without requiring users to manually configure a bunch of random settings first.

Vulkan is the preferred GPU backend, while OpenCL remains available as a compatibility and fallback option.

GPU acceleration isn't blindly used for every tiny task either. Quantified API considers the workload, runtime state, available hardware, and preferred backend before deciding where the work should run.

  • Isolated Vulkan probing so broken drivers or loader issues don't instantly brick the game
  • Deferred initialization so GPU startup doesn't fight with Minecraft while the game is still loading
  • Cleaner runtime states so failed or half-initialized backends aren't treated as ready
  • Automatic fallback routing from Vulkan to OpenCL and finally to CPU when needed
  • Device selection and diagnostics through the Quantified webpanel

《▒ Faster Runtime ▒》

The runtime underneath Quantified API was heavily redesigned to reduce the amount of overhead added around the work mods actually want to execute.

  • Lower overhead for tiny and unique tasks
  • Much stronger duplicate burst suppression
  • Cheaper parallel workload orchestration
  • Massively faster execution for smaller task graphs
  • Better handling of thread-safe and non-thread-safe workloads
  • Improved persistent and asynchronous cache behaviour

Basically, it now spends a lot less time managing work and a lot more time actually doing it. Crazy idea, ik xd

《▒ Performance Improvements ▒》

Internal runtime benchmarks against the older v1.4.4 release showed major improvements across all tested workload types.

  • Tiny unique task bursts: around 3.95x faster
  • Duplicate task bursts: around 45.4x faster
  • Small parallel workloads: around 5.54x faster
  • Medium parallel workloads: around 9.16x faster
  • Small DAG workloads: up to around 2952x faster in the tested setup

Duplicate suppression also improved from 2048 real executions to only 1 real execution in the tested duplicate burst.

So yh, V2 wasn't exactly a small update :DDD

《▒ Quantified Webpanel ▒》

Quantified API includes a live webpanel so developers and users can see what the runtime is actually doing instead of blindly trusting the mysterious background threads.

It can be enabled through the config or with /quantified webpanel.

  • Scheduler and queue activity
  • CPU and GPU backend states
  • Connected mod usage
  • Vulkan and OpenCL diagnostics
  • Preferred GPU and backend selection
  • Diagnostics export for easier debugging
  • Optional authentication and HTTPS support

《▒ Compatibility ▒》

  • Supports Fabric, Forge, and NeoForge
  • Supports Minecraft versions from 1.20.1 through the currently supported 1.21.X and 1.26.X platform lines
  • Vulkan is completely optional and degrades cleanly when unavailable
  • OpenCL remains available for older or less compatible hardware
  • CPU execution is always available as the final fallback
  • Mods made for the older V1 API can continue working through the compatibility layer
  • Automatic loader metadata detection reduces manual setup for developers

《▒ Official Documentation ▒》

Quantified API now has proper official documentation for both new and existing developers.

It covers installation, supported platforms, compute workloads, parallel processing, task graphs, caching, Vulkan and OpenCL routing, compatibility, migration, troubleshooting, and full examples.

Explore the Quantified API Documentation

《▒ Licensing and Support ▒》

Licensed under BRSSLA V1.5, which is free for personal and non-commercial use.

Mod developers who include Quantified API as a dependency automatically gain Commercial Rights for their mod.

Quantified API is built to be flexible, easy to integrate, and as user-friendly as possible while still giving developers proper control over their workloads.

If you have any requests, ideas, documentation improvements, or found a bug, feel free to open a GitHub issue or even a pull request :]

Developed and Maintained by Admany - BlackRift Studios 2026

Ченджлог

2.1.0Релиз26.1.1, 26.1.2, 26.2 · 28 июня 2026 г.

V2.1.0 - Vulkan Runtime & Panel Fixes :DDD

What's changed

  • Fixed issue #5 reported on Github
  • Added proper Vulkan residency tracking
  • Fixed the Vulkan Residency dashboard panel
  • Fixed older/secured Vulkan runtime paths showing as inactive when they were actually live
  • Fixed GPU compute in the panel getting stuck at 100%
  • Improved Vulkan activity/runtime reporting so the dashboard now reflects actual Quantified API GPU usage instead of misleading global telemetry
2.0.0Релиз26.1.1, 26.1.2, 26.2 · 26 июня 2026 г.

Official release of V2. Changelog in the GitHub repo :]

1.4.4Релиз1.20.1, 1.21.1 · 27 апреля 2026 г.

V1.4.4 - New API for Compiled Density shaders --- What's changed ---

Public API:

  • QuantifiedVulkan.registerDensityShader(String key, byte[] spirv)
  • QuantifiedVulkan.unregisterDensityShader(String key)

Internal:

  • VulkanManager: Added a static registry of REGISTERED_DENSITY_SHADERS (ConcurrentHashMap) and method registerDensityShader/unregisterDensityShader with null-safe checks at inputs and defensive spirv. copy() and clone() and a destroy program helper.

  • createProgramFromBytes / createProgramFromBuffer: variant of createProgram that accepts bytes[] raw instead of being class path resource.

  • resolveProgram: The program is compiled and cached inside a VkPipeline at the first batch dispatch for that key.

  • McDensityVulkanTask: Added a shaderKey field, there is now the 11-argument constructor to them (previously constructors transparently delegated through a null key).

  • McDensityBatchGroup: Added shaderKey field and updated matches() implementation to compare it, so you never batch tasks with different compiled shaders into the same group.

1.4.3Релиз1.20.1, 1.21.1 · 26 апреля 2026 г.

V1.4.3 - New Multiloader Architecture & End of Life for Legacy Versions :L It's sad to say farewell to Forge 1.18.2 and Forge 1.19.2. They served their time, but the time has come to let them nap. Both versions are officially now EOL and will no longer receive updates or support in any way.

--- What's changed ---

Architecture:

  • Complete rebuild of the project structure around a new multiloader design (peak). All platform implementations (Forge 1.20.1, Forge 1.21.1, Fabric 1.20.1, Fabric 1.21.1, NeoForge 1.21.1) now live under platforms/ as subprojects, sharing a single core/ source set (one jar, all loaders)
  • Universal jars now built per-version (universal-1.20.1, universal-1.21.1) plus a combined omniversal jar covering all supported loaders and versions.
  • Gradle build orchestration fully centralised in the root build.gradle with dedicated GradleBuild tasks per platform.

Platforms dropped:

  • forge-1.18.2 (EOL)
  • forge-1.19.2 (EOL)

Old/New Platforms:

  • platforms/forge-1.20.1
  • platforms/forge-1.21.1
  • platforms/fabric-1.20.1
  • platforms/fabric-1.21.1
  • platforms/neoforge-1.21.1

Description changes:

  • Updated README and added a new CFREADME file for Curseforge Description.
  • Updated the Curseforge Description.

Core fixes (since V1.4.2-HOTFIX):

  • VulkanBatchWorkload, GpuTaskDispatcher: async dispatch improvements.
  • AutoHealthChecker, MemoryCore, DeveloperDashboardServer: internal cleanup.
  • ConnectedModImpl: compatibility fixes.
  • New McDensityProgram and McDensityVulkanTask added to core.
  • New platform abstraction layer under core/common/platform/.
  • Fixed Vulkan GPU acceleration selecting an worser GPU by default, due to higher VRAM size.
  • Fixed an issue where switching between preferred Vulkan Devices doesn't reprobe the newly selected GPU and falls back to OpenCL.
1.4.2-HOTFIXРелиз1.20.4, 1.20.5, 1.20.6 · 16 апреля 2026 г.

Changelog on Github (Pow Pow) :DDD

1.4.1-HOTFIXРелиз1.20.4, 1.20.5, 1.20.6 · 5 апреля 2026 г.

Fixed major VK issue

1.4.0Релиз1.20.4, 1.20.5, 1.20.6 · 2 апреля 2026 г.

Changelog on GitHub

1.3.0Релиз1.20.4, 1.20.5, 1.20.6 · 7 марта 2026 г.

Changelog on GitHub

Комментарии

Загружаем…