[QAPI] | Quantified API
一款专为 Minecraft 模组打造的高性能前置库，支持高效处理任务、降低卡顿，并利用 GPU 加速、智能缓存和多线程，让游戏运行更流畅、更稳定。
截图
介绍
《▓ Quantified API ▓》
Quantified API（简称 QAPI）是一个面向模组的性能框架，不是那种给所有东西随手塞上异步处理、然后祈祷它别崩掉的方案 xd
它的目标很简单：避免模组拖垮主线程，并提供一个共享运行时，妥善管理 CPU 运算、并行任务、缓存、依赖图和 GPU 加速，同时不把游戏变成死锁模拟器。
《▒ 欢迎来到新一代 ▒》
随着 V2 发布，Quantified API 得到了大幅升级。
调度器、CPU 运行时、缓存系统、任务图、GPU 路由、兼容层、支持的平台、构建系统以及整体 API 设计，都经过了大幅改进或彻底重建。
Quantified API 现在还提供了完整的官方文档，涵盖从基础安装到高级计算工作负载、GPU 路由、缓存、迁移、故障排查和示例的所有内容 :DDD
《▒ 它究竟能做什么 ▒》
- 完善的异步调度，包括工作线程通道、工作负载路由、遥测以及合理的回退行为
- 并行执行可安全拆分到多个 CPU 线程上的工作负载
- 依赖感知任务图，适用于作业必须按特定顺序运行的工作流
- 后端感知的计算路由，可在 CPU、Vulkan 和 OpenCL 之间进行调度
- 重复任务抑制，可合并重复的相同工作，避免执行数百次
- 高级缓存，支持内存、磁盘、持久化、过期、压缩和刷新
- 通过 Fabric、Forge 和 NeoForge 元数据自动注册模组
- 通过运行时遥测和 Quantified 网页面板提供实时诊断
《▒ Vulkan 与 OpenCL 加速 ▒》
Quantified API 提供开箱即用的 Vulkan 计算加速，无需用户事先手动配置一大堆杂乱的设置。
Vulkan 是首选 GPU 后端，同时也支持 OpenCL，作为兼容和回退选项。
GPU 加速也不会被盲目用于每一项微小任务。Quantified API 会综合考虑工作负载、运行时状态、可用硬件和首选后端，再决定任务应在哪里运行。
- 隔离式 Vulkan 探测，避免有问题的驱动或加载器问题立刻导致游戏崩溃
- 延迟初始化，避免 GPU 启动过程与仍在加载的 Minecraft 相互冲突
- 更清晰的运行时状态，避免将失败或仅部分初始化的后端误判为就绪
- 自动回退路由，必要时从 Vulkan 切换到 OpenCL，最后回退到 CPU
- 通过 Quantified 网页面板进行设备选择与诊断
《▒ 更快的运行时 ▒》
Quantified API 底层的运行时经过了大幅重新设计，以减少模组实际想要执行的工作周围所增加的额外开销。
- 降低小型和独特任务的开销
- 大幅增强重复突发抑制
- 更廉价的并行工作负载编排
- 小型任务图的执行速度大幅提升
- 更好地处理线程安全和非线程安全的工作负载
- 改进持久化和异步缓存行为
基本上，它现在花在管理工作上的时间少了很多，而花在实际执行上的时间多了很多。疯狂的想法，我知道 xd
《▒ 性能改进 ▒》
针对旧版 v1.4.4 的内部运行时基准测试显示，所有测试的工作负载类型均有重大改进。
- 小型独特任务突发：约快
3.95x - 重复任务突发：约快
45.4x - 小型并行工作负载：约快
5.54x - 中型并行工作负载：约快
9.16x - 小型 DAG 工作负载：在测试设置中最高约快
2952x
在测试的重复突发中，重复抑制也从 2048 次实际执行改进为仅 1 次实际执行。
所以是的，V2 并不是一个小更新 :DDD
《▒ Quantified 网页面板 ▒》
Quantified API 包含一个实时网页面板，让开发者和用户可以看到运行时实际在做什么，而不是盲目信任那些神秘的后台线程。
可以通过配置或使用 /quantified webpanel 启用。
- 调度器和队列活动
- CPU 和 GPU 后端状态
- 已连接模组的使用情况
- Vulkan 和 OpenCL 诊断
- 首选 GPU 和后端选择
- 诊断导出以便于调试
- 可选的身份验证和 HTTPS 支持
《▒ 兼容性 ▒》
- 支持 Fabric、Forge 和 NeoForge
- 支持从
1.20.1到当前支持的1.21.X和1.26.X平台线的 Minecraft 版本 - Vulkan 完全可选，在不可用时能够干净地降级
- OpenCL 仍可用于较旧或兼容性较差的硬件
- CPU 执行始终作为最终回退方案可用
- 为旧版 V1 API 制作的模组可以通过兼容层继续工作
- 自动加载器元数据检测减少了开发者的手动设置
《▒ 官方文档 ▒》
Quantified API 现在为新老开发者提供了完善的官方文档。
涵盖安装、支持的平台、计算工作负载、并行处理、任务图、缓存、Vulkan 和 OpenCL 路由、兼容性、迁移、故障排除以及完整示例。
《▒ 许可与支持 ▒》
依据 BRSSLA 授权，可免费用于个人及非商业用途。
将 Quantified API 作为前置库纳入的模组开发者，将自动获得其模组的商业使用权。
Quantified API 以灵活、易于集成为设计目标，并在尽可能保持用户友好的同时，让开发者能够妥善掌控自身的工作负载。
如果你有任何请求、想法、文档改进建议，或发现了 bug，欢迎提交 GitHub issue，甚至直接发起 pull request :]
由 Admany 开发与维护 – BlackRift Studios 2026
常见问题
[QAPI] | Quantified API 支持哪些 Minecraft 版本？
[QAPI] | Quantified API 支持 Minecraft Java 版 1.18.2–26.3，共 19 个版本，可用的加载器：Fabric / Forge / NeoForge。下载时注意选择和你游戏版本一致的文件。
[QAPI] | Quantified API 怎么安装？
先用 PCL2 或 HMCL 启动器安装对应版本的 Fabric / Forge / NeoForge，再把下载的 .jar 文件放进游戏目录的 mods 文件夹，重新启动游戏即可。开启了版本隔离的，mods 文件夹在 versions/版本名 下面。
Admany 的其他作品
查看全部 →
LC²H [Lost Cities: Multithreaded]
LC2H V3 为 The Lost Cities 注入强劲动力，打造规模庞大的城市，让游戏运行飞快又丝滑流畅。完全兼容 C²ME。我为这个作品感到自豪，希望大家都能玩得开心 :]
ADM Anticheat
Revolutionary Anticheat system for Forge.
[TaCZ:Accel] | Timeless and Classics Zero Guns: Accelerated
Performance addon for TaCZ that cuts down CPU and memory usage, bloat, speeds up gun rendering while fixing stability issues. Made with love at BlackRift Studios :]
[IWT] | Immersive Weathering: Tweaks
A high performance addon for Immersive Weathering, built to speed up weathering and growth checks, reduce memory usage, and keep your game smoother without changing gameplay behavior ;]
评论
登录后评论和评分