精准FPS+

AccurateFPS+

一个轻量级的客户端 FPS HUD 模组，带有扩展的帧率滑块和深度自定义功能。让你一眼就能清晰、详细地查看性能表现，完全按照你想要的方式呈现！

终于成功修复了代码，并直接从上传的 JAR 文件中恢复了所有内容！

唯一更新的版本是 Fabric 1.21.11（下载量最多的版本），因为在没有原有多版本构建系统的情况下进行更新会非常痛苦。

遗憾的是，当原始项目文件丢失时，许多未发布的补充内容和正在开发中的功能也随之丢失了。

欢迎反馈、建议和建设性批评

---

亮点

• 扩展的 FPS 滑块 - 将原版的最大帧率滑块替换为精确的 1–1000 范围（步长为 1，而非原版的步长 10）。你选择的值会保存并在会话之间保留。
• 实时 FPS、AVG、MAX 和 MIN - 四项独立的指标，每项都有自己的更新间隔、小数精度、标签、显示位置和可配置的历史窗口。
• 完全可自定义的 HUD - 选择任意屏幕角落或设置精确的 X/Y 坐标。启用文本阴影，并添加带有可调颜色和透明度的半透明背景叠加层。
• 每项指标独立颜色 - 为每项指标单独设置自定义十六进制颜色，或为每项指标启用自动着色：绿色（≥60）、黄色（≥30）、红色（<30）。
• 灵活的 FPS 计算 - 在实时（即时）、平均（平滑）或 EMA（指数移动平均）之间切换，以实现响应迅速且稳定的追踪。AVG/MAX/MIN/百分位低值均遵循可配置的历史窗口（1秒 / 3秒 / 5秒 / 10秒 / 30秒 / 60秒）。
• 内置预设 - 极简（仅 FPS）、竞技（FPS + AVG）、详细（全部四项）或自定义。
• CSV 导出 - 运行 /accuratefps+ exportcsv 以整洁、易读的表格格式导出你的 FPS 历史记录（含帧时间）。

“全部指标/详细”预设 + FPS 的自动着色

---

支持的版本

发行版	Minecraft	Fabric	Quilt	Forge
1.0-r2 Refabricated	1.21.11	✅	❌	❌
1.0-r1 Legacy	1.21.1, 1.21.11	✅	✅	✅

---

安装

1. 下载与你的加载器和MC 版本相匹配的 JAR
2. 将其放入你的 mods/ 文件夹
3. 启动 Minecraft
4. 打开 Mod Menu → AccurateFPS+ 进行配置（Fabric 上需要 Cloth Config），或直接编辑 config/accuratefpsplus.json

---

配置

所有设置均可通过游戏内配置界面进行调整，并立即生效——无需重启。

HUD 设置

• 开关 HUD
• 锚定角落或自定义 X/Y 位置
• 文本阴影以提高可读性
• 背景叠加层，可配置颜色和透明度

每项指标设置（FPS、AVG、MAX、MIN）+ 低值指标行

• 独立显示/隐藏每项指标
• 设置显示位置顺序（主行有四个位置；低值指标行在主 HUD 下方垂直堆叠两个位置）
• 设置小数精度（0–4 位小数）
• 添加自定义前缀和后缀文本
• 为每项指标设置更新间隔
• 为每项指标设置自定义颜色（十六进制）
• 1% Low - 99% 的时间里超过的 FPS 值（竞技稳定性指标）
• 0.1% Low - 99.9% 的时间里超过的 FPS 值（最差情况分析）；显示在单独一行，以防止主 HUD 溢出

引擎设置

• 计算模式：
  • 实时 - 即时的每帧 FPS（默认）
  • 平均 - 轮询窗口内的均值（稳定）
  • EMA - 指数移动平均，实现平滑且响应迅速的输出
• 历史窗口 - AVG/MAX/MIN/百分位计算的时间范围（1秒–60秒）
• 采样间隔 - 轮询帧时间的频率（在保真度与开销之间取得平衡）
• 每项指标刷新间隔 - 独立配置 FPS/AVG/MAX/MIN/1% Low/0.1% Low 的更新节奏

预设

• 极简 - 仅当前 FPS
• 竞技 - FPS + 平均值
• 详细 - 全部四项指标
• 自定义 - 你自己的布局

---

性能

• 零分配热路径 - 用于帧计时的原始环形缓冲区，每帧无自动装箱或 GC 压力
• 缓存的 HUD 文本 - 当遥测值未变化时跳过字符串拼接；快速的小数格式化，无需 String.format() 开销
• 缓存的叠加层颜色 - 无每帧浮点运算，仅在设置更改时重新计算
• 缓存的屏幕尺寸 - 仅在显示实际调整大小时查询窗口尺寸
• 限流的历史记录清理 - CSV 导出数据每约 10 秒清理一次，而非每个轮询周期
• 异步 CSV 导出 - 历史快照在渲染线程上进行，磁盘 I/O 在线程外运行以避免卡顿
• 可配置的轮询间隔 - 根据你的硬件情况平衡精度与开销
• 极低的性能开销 - 每帧仅一次 nanoTime() 调用 + 环形缓冲区写入；所有其他工作以约 10 Hz 运行
• 自动配置迁移 - 旧配置无缝升级到最新架构，因此更新绝不会破坏你的设置

提示： 低于 100 毫秒的轮询间隔可提供更快的更新，但在低端硬件上可能会略微影响性能。

---

故障排除

• HUD 不可见？ 确保已在配置中启用，且没有打开任何 GUI 界面。
• 配置无法保存？ 检查 config/ 文件夹的写入权限。

---

依赖与兼容性

模组	加载器	要求
Fabric API	Fabric	📦 必需
Cloth Config	Fabric	📦 必需
Mod Menu	Fabric	✅ 兼容
Sodium	Fabric	✅ 兼容

❌ 已知不兼容项

目前没有。如果你遇到与其他模组的冲突，请报告，以便我将其标记为不兼容或使其兼容！

---

链接

• Modrinth
• 联系方式：Discord（用户名：matteo.sb）

---

MIT 许可证 - 源代码即将发布在 GitHub 上。

欢迎将此模组包含在任何整合包中（私人或公开）。 请注明出处并链接回此 Modrinth 页面。

---

由 gingermat 用爱打造

注意： 我知道这对于一个模组来说是个被用滥的概念，但我只是想测试自己并提升编码能力。我还有更多富有创意的项目，希望很快能完成，让你们都能享受其中！希望你觉得这个模组有用！