AccurateFPS+
超越帧率显示! 一款轻量级的 Minecraft 客户端 HUD,用于实时显示 FPS、帧时间、平均值、低百分位读数以及扩展的帧率限制。
最新版本:1.4-r2 - 更高效的统计历史记录和更安全的手动 FPS 颜色阈值。

当前 HUD:v1.2-r1 及更高版本中,所有七个指标均带有动态 FPS 颜色变化。

v1.0-r1 的动态预览;此后 HUD 布局和配色已发生变化。
功能介绍
- 显示七项指标: 在你的历史窗口范围内,显示 FPS、帧时间、AVG(平均)、MAX(最高)和 MIN(最低),以及 1% Low 和 0.1% Low。
- 有助于揭示掉帧情况: 低百分位指标基于你选定历史窗口内的有效渲染帧样本;它们并非最慢帧的平均值。
- 适配你的 HUD: 可选择预设、位置、大小、指标顺序、精度、文本、颜色、阴影和背景。
- 设置帧率上限: 支持以 1 FPS 为步长选择 1–1,000 FPS 或无限制(Unlimited)。
- 一目了然的 FPS 颜色指示: 可选择根据游戏情况自适应的自动阈值,或设置手动阈值。
支持版本
| 发布版 | Minecraft 版本 | 加载器 |
|---|---|---|
1.4-r2 (最新) |
1.21.1, 1.21.11, 26.1.x, 26.2, 26.3 | Fabric, NeoForge |
1.4-r1 |
1.21.1, 1.21.11, 26.1.x, 26.2, 26.3 | Fabric, NeoForge |
1.3-r1, 1.2-r2 |
1.21.1, 1.21.11 | Fabric, NeoForge |
1.2-r1, 1.1-r1 |
1.21.1, 1.21.11 | Fabric |
1.0-r2 Refabricated |
1.21.11 | Fabric |
1.0-r1 |
1.21.1, 1.21.11 | Fabric, Forge, Quilt |
26.1.x 构建版本支持 Minecraft 26.1、26.1.1 和 26.1.2。
安装
- 为你的 Minecraft 版本安装 Fabric 或 NeoForge。
- 从 Modrinth 下载匹配的 AccurateFPS+ 1.4-r2 jar 文件。
- 将 jar 文件放入 Minecraft 的
mods文件夹并启动游戏。
必需依赖: 在 Minecraft 1.21.1 和 1.21.11 上使用 Fabric 时,需要安装 Fabric API。对于 Fabric 26.x 或 NeoForge,无需其他必需的库。
打开设置
- Fabric: 安装 Cloth Config 或 YACL 以使用“打开配置”键绑。安装 Mod Menu 后,会添加一个设置入口。
- NeoForge: 从模组列表打开内置的设置界面。Cloth Config 和 YACL 是可选的替代方案。
依赖项与集成
| Minecraft | 加载器 | 必需 | 可选设置 | 兼容集成 |
|---|---|---|---|---|
| 1.21.1 | Fabric | Fabric API | Cloth Config, YACL, Mod Menu | Sodium, Sodium FPS Cap Fix |
| NeoForge | 无 | Cloth Config, YACL | Sodium | |
| 1.21.11 | Fabric | Fabric API | Cloth Config, YACL, Mod Menu | Sodium, Sodium FPS Cap Fix |
| NeoForge | 无 | Cloth Config, YACL | 见上方 Sodium 兼容性说明 | |
| 26.1.x | Fabric | 无 | Cloth Config, YACL, Mod Menu | Sodium, Sodium FPS Cap Fix |
| NeoForge | 无 | Cloth Config, YACL | Sodium | |
| 26.2 / 26.3 | Fabric | 无 | Cloth Config, YACL, Mod Menu | Sodium, Sodium FPS Cap Fix |
| NeoForge | 无 | Cloth Config, YACL | Sodium |
Fabric API 仅在 Minecraft 1.21.x 的 Fabric 上必需。Cloth Config、YACL、Mod Menu、Sodium 和 Sodium FPS Cap Fix 均为可选且未捆绑。未测试所有可选模组的组合。
已知问题 - NeoForge 1.21.11: Sodium 0.8.14 和 0.8.15-beta.1 在
ShaderChunkRenderer.begin(ClassCastException: ValidationGpuTexture cannot be cast to GlTexture)期间进行区块渲染时会崩溃。这是 Sodium/NeoForge 渲染器的故障,并非 AccurateFPS+ 崩溃。在没有 Sodium 的情况下,AccurateFPS+ 可在 NeoForge 1.21.11 上正常运行。
自定义
- HUD: 在游戏中切换显示,在 F3 打开时隐藏(新安装默认开启),可选择极简、竞技、详细或自定义样式,并设置锚点、自定义偏移量和尺寸(1%–200%,默认 100%)。
- 指标: 显示或隐藏指标,将其排列在两行 HUD 上,并设置 0–4 位小数、前缀、后缀、颜色、文字阴影和背景。
- 遥测数据: 选择实时、平均值或指数移动平均(EMA)计算方式;设置轮询间隔以及 1、3、5、10、30 或 60 秒的历史窗口。AVG、MAX、MIN、1% Low 和 0.1% Low 拥有独立的刷新间隔;FPS 与帧时间共享一个刷新间隔。
- 着色: 选择随游戏状态自动调整的阈值,或手动设置低、中、高 FPS 阈值。保存或加载时,手动阈值将保持在 1–1,000 FPS 范围内有序排列。显示器检测会将“高”设置为显示器的原生刷新率,“中”设为 75%,“低”设为 50%。
- 控制: 在 Controls → Key Binds → AccurateFPS+ 中设置 HUD 切换键和预设循环键。预设循环键默认未绑定。
设置保存后无需重启游戏即可生效。当 HUD 被禁用、屏幕界面打开或 F3 隐藏 HUD 时,采样会暂停;超过一秒的帧间隙将被忽略。
FPS 限制兼容性
AccurateFPS+ 将 Minecraft 的帧率上限扩展至 1–1,000 FPS(以 1 FPS 为步长),并支持无限制模式。所选限制值会单独保存。如果已安装已知的 FPS 限制或文本框模组(包括 Sodium FPS Cap Fix、FPS Cap Fix 或 FPS Textbox),AccurateFPS+ 会将原版滑块的控制权交给该模组。这避免了替换其控制界面,但不保证与所有 FPS 模组兼容。
开发者与整合包
请参阅 changelog 获取特定版本的兼容性、实现细节、测试及基准测试结果。源代码可在 MIT 许可下于本 GitHub 仓库 中找到。
您可以将 AccurateFPS+ 包含在私人或公共整合包中。请注明项目来源并链接至 Modrinth。
AccurateFPS+
See more than FPS! A lightweight, client-side Minecraft HUD for live FPS, frametime, averages, low-percentile readings, and an extended framerate limit.
Download on Modrinth · Report an issue
Latest: 1.4-r2 - more efficient history statistics and safer manual FPS-color thresholds.

Current HUD: all seven metrics with dynamic FPS coloring (v1.2-r1 and later).

Animated preview from v1.0-r1; the HUD layout and coloring have changed since.
What it does
- Shows seven metrics: FPS, frametime, AVG, MAX, and MIN over your history window, plus 1% Low and 0.1% Low.
- Helps reveal frame drops: Low metrics use valid rendered-frame samples over your selected history window; they are not averages of the slowest frames.
- Fits your HUD: Choose a preset, position, size, metric order, precision, text, colors, shadow, and background.
- Sets your FPS limit: Choose 1–1,000 FPS in one-FPS steps or Unlimited.
- Colors FPS at a glance: Choose automatic thresholds that adapt to gameplay or set manual thresholds.
Supported versions
| Release | Minecraft versions | Loaders |
|---|---|---|
1.4-r2 (Latest) |
1.21.1, 1.21.11, 26.1.x, 26.2, 26.3 | Fabric, NeoForge |
1.4-r1 |
1.21.1, 1.21.11, 26.1.x, 26.2, 26.3 | Fabric, NeoForge |
1.3-r1, 1.2-r2 |
1.21.1, 1.21.11 | Fabric, NeoForge |
1.2-r1, 1.1-r1 |
1.21.1, 1.21.11 | Fabric |
1.0-r2 Refabricated |
1.21.11 | Fabric |
1.0-r1 |
1.21.1, 1.21.11 | Fabric, Forge, Quilt |
The 26.1.x builds support Minecraft 26.1, 26.1.1, and 26.1.2.
Install
- Install Fabric or NeoForge for your Minecraft version.
- Download the matching AccurateFPS+ 1.4-r2 jar from Modrinth.
- Put the jar in your Minecraft
modsfolder and launch the game.
Required: Fabric API is required for Fabric on Minecraft 1.21.1 and 1.21.11. No additional required library is needed for Fabric 26.x or NeoForge.
Open the settings
- Fabric: Install Cloth Config or YACL for the Open Configuration keybind. Mod Menu adds a settings entry when installed.
- NeoForge: Open the built-in settings screen from the Mods list. Cloth Config and YACL are optional alternatives.
Dependencies and integrations
| Minecraft | Loader | Required | Optional settings | Compatible integrations |
|---|---|---|---|---|
| 1.21.1 | Fabric | Fabric API | Cloth Config, YACL, Mod Menu | Sodium, Sodium FPS Cap Fix |
| NeoForge | None | Cloth Config, YACL | Sodium | |
| 1.21.11 | Fabric | Fabric API | Cloth Config, YACL, Mod Menu | Sodium, Sodium FPS Cap Fix |
| NeoForge | None | Cloth Config, YACL | See Sodium compatibility note above | |
| 26.1.x | Fabric | None | Cloth Config, YACL, Mod Menu | Sodium, Sodium FPS Cap Fix |
| NeoForge | None | Cloth Config, YACL | Sodium | |
| 26.2 / 26.3 | Fabric | None | Cloth Config, YACL, Mod Menu | Sodium, Sodium FPS Cap Fix |
| NeoForge | None | Cloth Config, YACL | Sodium |
Fabric API is required only for Fabric on Minecraft 1.21.x. Cloth Config, YACL, Mod Menu, Sodium, and Sodium FPS Cap Fix are optional and are not bundled. Optional-mod combinations are not all tested.
Known issue - NeoForge 1.21.11: Sodium 0.8.14 and 0.8.15-beta.1 crash during chunk rendering in
ShaderChunkRenderer.begin(ClassCastException: ValidationGpuTexture cannot be cast to GlTexture). This is a Sodium/NeoForge renderer failure, not an AccurateFPS+ crash. AccurateFPS+ works on NeoForge 1.21.11 without Sodium.
Customize
- HUD: Toggle it in-game, hide it while F3 is open (on by default for new installs), choose Minimal, Competitive, Detailed, or Custom, and set its anchor, custom offsets, and size (1%–200%; 100% by default).
- Metrics: Show or hide metrics, arrange them across the two HUD lines, and set 0–4 decimal places, prefixes, suffixes, colors, text shadow, and background.
- Telemetry: Choose Real-Time, Averaged, or EMA calculations; set the polling interval and a 1, 3, 5, 10, 30, or 60-second history window. AVG, MAX, MIN, 1% Low, and 0.1% Low have independent refresh intervals; FPS and frametime share one.
- Coloring: Choose automatic thresholds that adapt to gameplay or set manual Low, Medium, and High FPS thresholds. Manual thresholds stay ordered within 1–1,000 FPS when saved or loaded. Monitor detection sets High to your display's native refresh rate, Medium to 75%, and Low to 50%.
- Controls: Set the HUD-toggle and preset-cycle keys in Controls → Key Binds → AccurateFPS+. The preset-cycle key is unbound by default.
Settings are saved without restarting the game. Sampling pauses while the HUD is disabled, a screen is open, or F3 hides the HUD; frame gaps of one second or more are ignored.
FPS limit compatibility
AccurateFPS+ extends Minecraft's framerate limit to 1–1,000 FPS, in one-FPS steps, plus Unlimited. The selected limit is saved separately. If a recognized FPS-cap or textbox mod is installed (including Sodium FPS Cap Fix, FPS Cap Fix, or FPS Textbox), AccurateFPS+ leaves the vanilla slider to that mod. This avoids replacing its controls, but does not guarantee compatibility with every FPS mod.
Developers and modpacks
See the changelog for version-specific compatibility, implementation, tests, and benchmark details. Source code is available in this GitHub repository under the MIT License.
You may include AccurateFPS+ in private or public modpacks. Please credit the project and link to Modrinth.
下载 AccurateFPS+
下载 AccurateFPS+
下载 AccurateFPS+
下载 AccurateFPS+
下载 AccurateFPS+
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 AccurateFPS+
下载 AccurateFPS+
下载 AccurateFPS+
下载 AccurateFPS+
下载 AccurateFPS+
- 改进了遥测效率:AVG、MAX 和 MIN 现在使用滚动历史聚合,而不是重新扫描保留的样本。指标行为保持不变;当轮询或刷新间隔非常短时,这减少了重复工作。
- 为包含边界的历史截止点处的滚动 AVG/MAX/MIN、重复的指标刷新间隔更改、持续 1 ms 的轮询、历史窗口更改、百分位收集禁用/启用,以及百分位收集开启或关闭时非百分位指标的等效性添加了确定性回归覆盖测试。
- 为 NeoForge 设置中的数字和十六进制颜色输入添加了共享验证,针对 1.21.x 和 26.x 界面中的空值、格式错误值和边界值进行了测试。
- 修复了手动颜色阈值归一化问题,确保加载或保存的值严格递增并在支持的 1–1000 FPS 范围内,包括处于上边界的配置。
- 添加了仅开发者使用的
benchmarkTelemetryGradle 任务。它在 1 ms 更新频率、500 个保留样本和连续单样本过期的条件下,比较生产环境的滚动 AVG/MAX/MIN 聚合器与之前的全扫描方法;同时测量在百分位收集开启和关闭情况下,使用平均为 1 ms 的确定性可变帧时间时的当前引擎性能。结果为本地中位数计时,不包含 CI 性能阈值。 - 将 NeoForge 26.x 原生设置的文本字段限制及数字/颜色输入过滤与 1.21.x 界面保持一致。
- 将 NeoForge 26.1.2 和 26.3 的目标版本分别更新至 NeoForge 26.1.2.126 和 26.3.0.103。
- 更新了目标兼容的 Fabric API、Fabric Loom、NeoForge、Mod Menu、Sodium 26.3、Gradle 和开发解析器依赖项。由于没有更新的受支持构建可用,且其 NeoForge 渲染器不兼容问题仍被记录,因此对 Minecraft 1.21.11 保留了 Sodium 0.8.15-beta.1。
- 为 Minecraft 26.1.x、26.2 和 26.3 添加了 Fabric 和 NeoForge 构建目标,同时保留针对 1.21.1 和 1.21.11 的独立目标。这生成了十个加载器/版本运行时 JAR 包。26.1.x JAR 包基于 Minecraft 26.1.2 构建并声明
[26.1,26.2);在匹配加载器版本的条件下,针对 26.1 和 26.1.1 的清洁构建与测试也均通过。 - 将 Fabric 26.x 配置为非重映射 Loom 和 Java 25(用于未混淆的 Minecraft);1.21.x 保留重映射 Loom 和 Java 21。从 26.x 的编译和运行时元数据中移除了 Fabric API。延迟了 26.x 键位映射注册至客户端选项初始化之后,将客户端 tick 和 HUD 回调移至客户端 Mixins,并更新了未混淆类的 class-tweaker 命名空间。
- 添加了针对屏幕访问、键盘输入、显示刷新率检测以及 HUD 渲染的版本特定适配器。由于 26.1 的渲染钩子与 26.2 和 26.3 不同,因此保留了独立的 HUD Mixin 配置。
- 将 FPS 限制滑块扩展至 1–1000 FPS(以 1 FPS 为增量),随后是映射到 Minecraft 无限制值的“Unlimited”停止选项。更新了 Sodium 的 FPS 格式化程序集成以适配目标方法名:1.21.11 上为
lambda$fpsLimit$2,26.x 上为lambda$fpsLimit$0。 - 使 Sodium FPS 范围常量注入变为可选(
require=0)。针对 26.3 的 Sodium 0.9.3-beta.1 现从 Minecraft 的OptionInstance派生其范围,而非使用旧的 260/10 常量;对于仍包含这些常量的版本(如 26.2 上的 Sodium 0.9.2),注入仍会进行调整。 - 修复了度量可见性保存回调,使得保存未更改的可见性值不再将选定的 HUD 预设切换为 Custom。在键位映射事件中注册了 NeoForge 1.21.11 的键类别,而非使用已弃用的急切共享注册。
- 将原生 NeoForge 设置界面移植至 26.x 的屏幕和渲染状态 API,包括所有设置页面、度量控件、验证、滚动、预设处理及 JSON 持久化。通过
IConfigScreenFactory在 NeoForge 26.x 模组列表中注册了该界面;Cloth Config 和 YACL 仍然是可选的替代界面。 - 添加了根任务以聚合和验证十个发布 JAR 包。CI 构建并上传完整的目標矩阵。
buildAllVersions和verifyReleaseJars已成功完成,包括项目测试。 - 在 1.21.x 上将 Fabric Loader 从 0.19.5 更新至 0.20.1,Fabric Loom 从 1.18.4 更新至 1.19.3;在 26.x 上将 Fabric Loom 从 1.19.2 更新至 1.19.3。在 1.21.1 上将 NeoForge 从 21.1.263 更新至 21.1.265,在 26.1.x 上从 26.1.2.122 更新至 26.1.2.124,在 26.3 上从 26.3.0.95 更新至 26.3.0.99。NeoForge 21.11.48 和 26.2.0.93 已是最新版本。检查了 Fabric API、Cloth Config、YACL、Mod Menu、ModDevGradle 和 JUnit 的固定版本;其现有版本对于支持的目标而言已是最新。
- 在新版稳定版本可用后,将 NeoForge 26.1.x 从 26.1.2.124 更新至 26.1.2.125,并将两个 Gradle 包装器从 9.8.1 更新至 9.8.2。
- 将针对不同目标的 Sodium 开发依赖项更新为:Fabric 和 NeoForge 1.21.11 对应 0.8.15-beta.1,Fabric 和 NeoForge 26.3 对应 0.9.3-beta.1。其他 Sodium 固定版本保持为:1.21.1 对应 0.8.13,26.1.x 和 26.2 对应 0.9.2。Cloth Config、YACL、Mod Menu 和 Sodium 仅为编译时集成,不包含在发布 JAR 包中。
- 运行时测试了 Fabric 1.21.11(搭配 Sodium 0.8.15-beta.1、Cloth Config 21.11.153、YACL 3.8.2 和 Mod Menu 17.0.1);成功进入世界且渲染正常,无客户端崩溃。运行时测试了 NeoForge 1.21.1(搭配 Sodium 0.8.13、Cloth Config 15.0.140 和 YACL 3.8.2);成功进入世界并正常退出。
- 运行时测试了 NeoForge 26.2(搭配 Sodium 0.9.2、Cloth Config 26.2.155 和 YACL 3.9.7);加载了同版本测试世界副本,加入世界,渲染区块并在退出时保存。Fabric 26.3(搭配 Sodium 0.9.3-beta.1)成功到达世界;NeoForge 26.3(搭配相同的 Sodium、Cloth Config 26.3.159 和 YACL 3.9.7)也加载了同版本测试世界副本并在世界中渲染,无崩溃。
- 重新测试了 NeoForge 26.1.x(在 26.1.2.125 上,搭配 Sodium 0.9.2、Cloth Config 26.1.154 和 YACL 3.9.7);加载了现有世界,无运行时故障。
- 在 1.21.11 开发客户端中测试了 Sodium 0.8.15-beta.1(搭配 NeoForge 21.11.48、Cloth Config 21.11.153 和 YACL 3.8.2)。客户端进入世界后,在 Sodium 的
ShaderChunkRenderer.begin处发生崩溃,异常为ClassCastException: ValidationGpuTexture cannot be cast to GlTexture。Sodium 0.8.14 在 NeoForge 21.11.45 和 21.11.48 上也显示了相同的渲染器故障;0.8.15-beta.1 的测试确认此问题在该环境中仍然存在。失败的堆栈跟踪位于 Sodium/NeoForge 区块渲染部分,而非 AccurateFPS+ 的 FPS 滑块集成部分。
- 将 NeoForge 构建目标更新为 Minecraft 1.21.1 的 21.1.263 和 Minecraft 1.21.11 的 21.11.48。
- 将 Fabric Loom 从 1.18.3 更新至 1.18.4,适用于两个 Fabric Minecraft 目标。
- 确认 NeoForge 1.21.11(0.8.14)的最新稳定版 Sodium 在加载区块渲染时与 NeoForge 21.11.48 发生崩溃;故障位于 Sodium 的渲染器中,而非 AccurateFPS+ 的 FPS 滑块集成部分。该问题在 1.2-r2 测试期间记录于 Sodium 0.8.14 / NeoForge 21.11.45,因此并非 1.3-r1 的新回归。打包运行时兼容性仍未验证。
- 验证了搭配 Sodium、Cloth Config 和 YACL 的最新 NeoForge 1.21.1 配置文件,以及仅搭配 Cloth Config 和 YACL 而不含 Sodium 的 NeoForge 1.21.11 配置文件;两者均成功加载并保存了世界。
- 通过在原生设置界面中使用不透明颜色绘制自定义文本来修复 NeoForge 1.21.11 中不可见的设置名称;按钮仅显示其选中值。
- 当未安装任何可选屏幕库时,通过原生回退机制路由 NeoForge 打开配置快捷键。
- 除非安装了两个屏幕库,否则隐藏“设置屏幕”选择器;Mod Menu、NeoForge 和快捷键均路由至同一保存偏好设置。
- 在迁移现有配置文件时保留已保存的屏幕偏好设置。
- 添加了持久化的 HUD 大小滑块(范围 1% 至 200%,默认 100%),对 HUD 线条、布局、锚点钳制及背景叠加层进行缩放。
- 使两个可选设置屏幕具有上下文相关性:隐藏自定义坐标、非活动指标详情以及未使用的叠加/着色控件;无论启用了哪些指标,引擎调优设置始终保持可见。
- 当 HUD 被禁用、屏幕处于打开状态或启用“按 F3 隐藏”时暂停遥测数据收集;恢复时重置帧时间与轮询基线。
- 丢弃持续时间等于或超过 1 秒的活动帧间隔,以防止挂起和长时间中断成为 FPS、帧时间、滚动统计或百分位数的样本。
- 使用最近秩选择在配置的 history window 内基于每渲染帧的 FPS 观测值计算 1% Low 和 0.1% Low;较小的历史记录在所选秩重合时仍可能产生相等的值。
- 在基于时间窗口的原始环形缓冲区中存储百分位帧历史,并复用 Quickselect 工作区;当刷新时机重合时,从一份复制的样本集中计算两种低值。
- 为非活动间隔、一秒间隔、不规则帧持续时间、小样本窗口以及不同的低百分位秩添加了确定性测试。
- 纯引擎合成压力配置(1,000 FPS,60 秒历史记录,1 毫秒统计与百分位刷新间隔,3 秒模拟时间):经过时间从 100.4 毫秒降至 11.5 毫秒(降低约 88.5%),内存分配从 72.4 MB 降至 333 KB(降低约 99.5%)。此为纯引擎合成测量结果,非游戏内基准测试;不能证明 gameplay 性能提升。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
模组
一个用于收集生物掉落物的多区块模组。
模组
显示你正在注视的方块的信息。(适用于 Minecraft 1.16+ 的 Hwyla/Waila 分支)
模组
查看物品与配方
模组
在游戏画面角落显示附近世界地形、玩家、生物和实体的地图。可创建路径点,帮助你找到标记过的位置。
模组
使用 JavaScript 编辑配方、添加自定义物品、编写世界事件!
模组
AE2:一款流行的自动化与存储模组
评论 0
登录后参与评分
还没有评论,来抢沙发吧