最高帧率提升器

Max FPS booster (Fabric 26.3)

Max FPS booster 是一款超高性能优化模组及可自定义的 FPS HUD，专为 Minecraft: Java Edition 26.3（“Wilderness Bound”）打造，原生构建于 Fabric 生态系统之上。

由 modclaim 从零开始设计，与 Sodium 完全协同运作，Max FPS booster 消除了实体渲染、方块实体提取、粒子预算、动画纹理上传以及单人/局域网主机服务器 tick 延迟等各方面的性能瓶颈。

---

⚡ 主要特性

📊 动态颜色 FPS 叠加 HUD

• 实时显示：在屏幕上流畅渲染的实时帧率计数器。
• 动态颜色切换：
  • 🟢 绿色（#55FF55）：>= 60 FPS（流畅性能）
  • 🟡 黄色（#FFFF55）：30 - 59 FPS（中等帧率）
  • 🔴 红色（#FF5555）：< 30 FPS（低帧率警告）
• 可自定义屏幕角落：左上角（默认）、右上角、左下角或右下角。
• 性能诊断：可选的 Min/Max FPS 追踪以及实时帧时间（毫秒，例如 6.8 ms）。
• 简洁的 F3 集成：打开完整的原版 F3 调试叠加层时自动隐藏。

🚀 高级渲染优化

• 实体距离剔除与缩放：在进行昂贵的模型评估和矩阵计算之前，剔除玩家视野之外或超出配置距离倍数的远处实体。
• 方块实体剔除：跳过对位于配置视距之外的沉重方块实体（箱子、潜影盒、信标、旗帜）的渲染。
• 粒子节流与剔除：防止超出范围的粒子（火把、营火、传送门、天气水花）污染内存或运行 tick 更新。
• 动画纹理节流：调控动画纹理更新节奏，在保持动画自然观感的同时，显著降低 GPU 上传压力。

🌐 局域网主机与单人服务器优化

• 智能生物 tick：在托管局域网世界或进行单人游戏时，将远处无目标的非活跃生物节流，跳过冗余的 AI 目标选择器 tick，大幅释放 CPU 余量并降低 MSPT。
• 自动保存卡顿峰值削减：通过平滑区块刷新例程，防止定期世界保存期间出现微卡顿和突然的冻结帧。

⚙️ ModMenu 游戏内设置

• 通过 ModMenu（可选依赖）访问内置的原生配置界面。
• 即时热重载：每次切换和滑块调整立即生效——无需重启客户端。
• 干净地持久化保存至 .minecraft/config/max-fps-booster.json。

---

🧩 兼容性矩阵

模组	兼容性状态	备注
Sodium	🟢 完全兼容	协同运作；Max FPS booster 优化实体、粒子和方块实体，而 Sodium 管理区块渲染。
Iris Shaders	🟢 完全兼容	与所有光影包完全兼容。
ModMenu	🟢 完全兼容	原生配置界面集成（可选）。
Lithium / ASC	🟢 完全兼容	无冲突的服务器 tick 改进。

---

📥 安装

1. 为 Minecraft 26.3 安装 Fabric Loader（版本 0.19.5 或更高）。
2. 下载 Fabric API（0.160.7+26.3 或更高）并将其放入 .minecraft/mods 文件夹。
3. 下载 max-fps-booster-1.0.0.jar 并将其放入 .minecraft/mods 文件夹。
4. （可选） 安装 ModMenu 以访问游戏内设置界面。
5. 启动 Minecraft，享受极致帧率！

---

🛠️ 从源码构建

前置要求

• JDK 25 或更高（Minecraft 26.3 需要 Java 25）
• 用于初始依赖解析的互联网连接

编译

./gradlew build

编译后的模组 JAR 将生成于：

build/libs/max-fps-booster-1.0.0.jar

---

🔗 项目链接

• Modrinth：https://modrinth.com/project/max-fps-booster
• 作者/所有者：modclaim

---

📄 许可证

本项目采用 MIT 许可证 授权。