Quantified API

模组

· 作者 Admany

一个专为 Minecraft 模组打造的高性能 API,旨在高效处理任务、减少卡顿、利用 GPU 加速、智能缓存与多线程技术——让你的游戏保持流畅稳定。

0 本站下载 0 关注 更新于 3 个月前

最新 2.2.0 · 26.2 · Fabric / Forge

一键开服(送7天)

《▓ Quantified API ▓》

Quantified API Banner

Quantified API(简称 QAPI)是一个专为模组设计的性能框架,旨在处理那些不仅仅是在所有地方随意添加异步操作并祈祷它们不会崩溃的模组。

它的目标非常简单:阻止模组烧坏主线程,并提供一个共享运行时环境,能够妥善管理 CPU 工作、并行任务、缓存、依赖图以及 GPU 加速,而无需将游戏变成死锁模拟器。

《▒ 欢迎来到新一代 ▒》

随着 V2 的发布,Quantified API 得到了巨大的提升。

调度器、CPU 运行时、缓存系统、任务图、GPU 路由、兼容层、支持平台、构建系统以及整体 API 设计均已得到大幅改进或完全重建。

Quantified API 现已提供完整的官方文档,涵盖从基础安装到高级计算工作负载、GPU 路由、缓存、迁移、故障排除以及示例等所有内容 :DDD

探索新的 Quantified API 文档

《▒ 它实际能做什么 ▒》

  • 完善的异步调度,支持工作区、负载路由、遥测以及合理的回退行为
  • 并行执行,适用于可以安全地在多个 CPU 线程间分割的负载
  • 感知依赖的任务图,适用于需要按特定顺序运行的工作流
  • 后端感知的计算路由,涵盖 CPU、Vulkan 和 OpenCL
  • 重复任务抑制,使得重复的相同工作可以被合并,而不是执行数百次
  • 高级缓存,支持内存、磁盘、持久化、过期、压缩和刷新
  • 自动模组注册,通过 Fabric、Forge 和 NeoForge 的元数据实现
  • 实时诊断,通过运行时遥测和 Quantified 网页面板实现

《▒ Vulkan 与 OpenCL 加速 ▒》

量化 API 提供了 Vulkan 计算加速功能,无需用户先手动配置一堆随机设置即可直接运行。

Vulkan 是首选的 GPU 后端,而 OpenCL 仍作为兼容性和备用选项提供。

GPU 加速也并非盲目地用于每一个微小的任务。Quantified API 在决定工作应在何处运行之前,会权衡工作量、运行时状态、可用硬件以及首选后端。

  • 隔离的 Vulkan 探测,以便损坏的驱动程序或加载器问题不会立即导致游戏崩溃
  • 延迟初始化,使 GPU 启动不会在游戏仍在加载时与 Minecraft 争抢资源
  • 更清晰的运行时状态,确保失败或未完全初始化的后端不会被当作就绪状态处理
  • 自动回退路由,在需要时从 Vulkan 回退到 OpenCL,最终回退到 CPU
  • 设备选择与诊断,通过 Quantified Webpanel 进行管理

《▒ 更快的运行时 ▒》

Quantified API 底层的运行时经过大幅重构,旨在减少围绕模组实际想要执行的工作所增加的开销。

  • 降低对微小且独特任务的开销
  • 显著增强的重复突发抑制能力
  • 更廉价的并行工作负载编排
  • 对小规模任务图实现极快的执行速度
  • 更好地处理线程安全与非线程安全的工作负载
  • 改进持久化与异步缓存行为

基本上,现在它花在管理工作上的时间少了很多,而真正执行工作的时间多了一大截。疯狂的想法,我知道吧 xd

《▒ 性能提升 ▒》

与旧版 v1.4.4 发布版的内部运行时基准测试显示,在所有测试的工作负载类型中均有显著提升。

  • 微小独特任务突发:快约 3.95x
  • 重复任务突发:快约 45.4x
  • 小规模并行工作负载:快约 5.54x
  • 中等规模并行工作负载:快约 9.16x
  • 小规模 DAG 工作负载:在测试设置下,最高快约 2952x

重复抑制也有所改善,在测试的重复突发中,实际执行次数从 2048 次减少到仅 1 次。

所以嘛,V2 绝对不是一个小小的更新 :DDD

《▒ Quantified Webpanel ▒》

量化 API 包含一个实时 Web 面板,让开发者和用户能够直观地查看运行时实际执行的操作,而不是盲目信任那些神秘的后台线程。

可通过配置文件或使用 /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 路由、兼容性、迁移步骤、故障排除以及完整示例。

浏览 Quantified API 官方文档

《▒ 许可与支持 ▒》

本软件依据 BRSSLA V1.5 许可证授权,个人与非商业用途免费使用。

将 Quantified API 作为依赖项包含在内的模组开发者,其模组自动获得商业使用权。

Quantified API 旨在保持灵活、易于集成,并在尽可能提供用户友好体验的同时,赋予开发者对其任务负载的充分控制权。

如果您有任何需求、建议、文档改进意见或发现了 Bug,欢迎提交 GitHub Issue 或直接发起 Pull Request :]

由 Admany - BlackRift Studios 开发与维护 © 2026

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源