Max FPS booster for fabric

最高 FPS 加速器（Fabric 26.3）

最高 FPS 加速器是一款超高性能优化模组，并提供可自定义的 FPS HUD，适用于Minecraft：Java 版 26.3（“Wilderness Bound”），基于Fabric生态原生构建。

由 modclaim从零设计，可与钠完全协同工作。最高 FPS 加速器能消除实体渲染、方块实体提取、粒子数量、动态纹理上传以及单人游戏/LAN 主机服务器刻更新延迟方面的性能瓶颈。

⚡ 主要功能

📊 动态变色 FPS 覆盖层 HUD

• 实时显示：在屏幕上流畅显示实时帧率。
• 动态变色：
• 🟢 绿色（#55FF55）：≥ 60 FPS（运行流畅）
• 🟡 黄色（#FFFF55）：30–59 FPS（帧率一般）
• 🔴 红色（#FF5555）：< 30 FPS（低帧率警告）
• 自定义屏幕角落：左上角（默认）、右上角、左下角或右下角。
• 性能诊断：可选的最低/最高 FPS 追踪和实时帧时间（毫秒）（例如 6.8 ms）。
• 与 F3 无缝集成：打开原版完整 F3 调试界面时会自动隐藏。

🚀 高级渲染优化

• 实体距离剔除与缩放：在进行耗费性能的模型评估和矩阵计算之前，剔除玩家视野之外或超出所设距离倍率的远处实体。
• 方块实体剔除：跳过渲染超出设定视距的高负载方块实体（箱子、潜影盒、信标、旗帜）。
• 粒子限流与剔除：阻止超出范围的粒子（火把、营火、传送门、天气飞溅粒子）占用内存或进行刻更新。
• 动态纹理限流：控制动态纹理的更新频率，大幅降低 GPU 上传负担，同时保持动画自然流畅。

🌐 LAN 主机与单人游戏服务器优化

• 智能生物刻更新：在托管 LAN 世界或游玩单人游戏时，会降低远处、没有目标的非活跃生物的更新频率，跳过重复的 AI 目标选择器刻更新，大幅释放 CPU 余量并降低 MSPT。
• 自动保存卡顿缓解：通过平滑区块写入流程，减少定期保存世界时的微卡顿和突然冻结。

⚙️ ModMenu 游戏内设置

• 内置原生配置界面，可通过ModMenu访问（可选前置）。
• 即时热重载：所有开关和滑块调整后立即生效——无需重启客户端。
• 设置会保存至 .minecraft/config/max-fps-booster.json。

🧩 兼容性列表

| 模组 | 兼容状态 | 备注 |
| :— | :—: | :— |
| 钠 | 🟢 完全兼容 | 协同运行；最高 FPS 加速器优化实体、粒子和方块实体，钠则负责区块渲染。 |
| Iris Shaders | 🟢 完全兼容 | 与所有光影包完全兼容。 |
| ModMenu | 🟢 完全兼容 | 原生配置界面集成（可选）。 |
| Lithium / ASC | 🟢 完全兼容 | 服务器刻更新优化互不冲突。 |

📥 安装

1. 安装 Fabric 加载器（版本 0.19.5 或更高版本），用于 Minecraft 26.3。
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 License 授权。