更好的TPS

更好的TPS

一个面向 Minecraft 1.21.1 (Fabric) 的 TPS 可视化与卡顿管理 Mod。 A TPS visualization and lag management mod for Minecraft 1.21.1 (Fabric).

性能

Better TPS Minecraft Loader

一个面向 Minecraft 1.21.1 (Fabric) 的 TPS 可视化与卡顿管理 Mod。

💡 如果你经常被卡顿困扰，想知道"到底是谁在拖慢我的游戏"，这个 Mod 就是为你准备的。

✨ 功能一览

1️⃣ TPS 可视化 HUD（v1.0.0）

实时显示游戏运行的 TPS（每秒 ticks 数）和 MSPT（每 tick 耗时），让你随时掌握游戏性能状态。

七种显示模式

模式 说明 适用场景
HIDDEN 完全隐藏 不需要看数据时
MINI 仅显示 TPS 数字（带颜色） 极简，不遮挡画面
COMPACT 紧凑显示 TPS + MSPT 小空间，关键信息
STANDARD 标准显示 TPS / MSPT / 1分钟均值 日常使用推荐
GRAPH_ONLY 仅显示实时波形图 只看趋势
FULL 完整数据 + 实时折线图 详细监控
BIG_DATA 全量数据（含实体数、区块数等） 深度分析

TPS 颜色指示

颜色 TPS 范围 状态
🟢 绿色 TPS ≥ 18 流畅运行
🟡 黄色 TPS ≥ 14 轻微卡顿
🟠 橙色 TPS ≥ 10 明显卡顿
🔴 红色 TPS < 10 严重卡顿

屏幕位置

支持 5 种屏幕位置：左上、右上、左下、右下、顶部居中。

2️⃣ 卡顿检测提醒（v1.1.0）

自动监控游戏 TPS，当检测到持续卡顿（TPS 低于自定义阈值）时，在聊天栏发送提醒消息。

  • ✅ 可自定义卡顿阈值（默认 10.0 TPS）
  • ✅ 可自定义持续检测时间（默认 5 秒）
  • ✅ 内置冷却机制，避免刷屏（默认 30 秒冷却）
  • ✅ 支持开关（默认开启）
  • ✅ 屏幕底部红色警告条闪烁提示

3️⃣ 卡顿区块管理（v1.1.0）

一键扫描并找出导致卡顿的"元凶区块"，并提供三种处理方式。

区块扫描

按 F7 打开管理界面，Mod 会自动扫描你周围的区块，按"卡顿评分"排序：

卡顿评分 = 实体数量 + 方块实体数量 × 2

📊 扫描范围可配置（默认半径 8 个区块）

三种处理方式

操作 说明 适用场景
冻结 让区块内所有实体停止 AI、停止重力 临时保住实体，排查问题
卸载 移除所有实体和方块实体（不可恢复） 快速清理卡顿源
彻底还原 Kill 所有实体并清空方块实体 完全重置该区块

⚠️ 所有操作都需要二次确认，防止误操作！

🎮 使用方法

默认按键绑定

按键 功能
F4 循环切换 HUD 显示模式
F5 循环切换 HUD 屏幕位置
F6 开关卡顿提醒功能
F7 打开卡顿区块管理界面

💡 这些按键可以在游戏的「控制设置」中修改。

卡顿区块管理界面操作

  • 鼠标点击：选择区块
  • ↑ / ↓ 方向键：上下导航
  • F / U / R：快速执行冻结 / 卸载 / 还原操作
  • ESC：关闭界面
  • +/-：调整卡顿阈值
  • T：开关卡顿提醒

⚙️ 配置说明

配置文件位于 .minecraft/config/bettertps.json，支持以下选项：

配置项 类型 默认值 说明
lagThreshold double 10.0 卡顿提醒的 TPS 阈值
lagAlertEnabled boolean true 是否启用卡顿提醒
lagAlertCooldown int 30 卡顿提醒冷却时间（秒）
lagSustainSeconds int 5 持续低于阈值多少秒后提醒
chunkScanRadius int 8 区块扫描半径（区块数）
hudMode String COMPACT HUD 显示模式
hudPosition String TOP_RIGHT HUD 屏幕位置

📦 安装要求

  • Minecraft: 1.21.1
  • Mod 加载器: Fabric Loader ≥ 0.16.9
  • 依赖: Fabric API ≥ 0.102.0
  • Java: 21+

📥 安装步骤

  1. 安装 Fabric Loader 和 Fabric API
  2. 下载 bettertps-1.1.0.jar
  3. 将 jar 文件放入 .minecraft/mods/ 目录
  4. 启动游戏，享受丝滑体验！

🔧 构建（开发者）

# 使用 Python 构建脚本（推荐）
& "D:\python3.13.7\python.exe" "D:\项目\beter TPS\build_new.py"
或使用 Gradle（需要正确配置环境）


./gradlew build

构建产物位于 build/libs/bettertps-1.1.0.jar。

📝 更新日志

v1.1.0 (2026-06-28)

  • ✨ 新增「卡顿检测提醒」功能
  • ✨ 新增「卡顿区块管理」GUI 界面
  • ✨ 支持冻结 / 卸载 / 彻底还原卡顿区块
  • 🐛 修复 BIG_DATA 模式下实体计数显示问题
  • ⚡ 优化 TPS 监控性能

v1.0.0 (2026-06-26)

  • 🎉 首次发布
  • ✨ TPS / MSPT 实时可视化 HUD
  • ✨ 7 种显示模式，5 种屏幕位置
  • ✨ TPS 颜色指示系统

❓ 常见问题

Q: 这个 Mod 能在多人服务器上使用吗？ A: 可以！HUD 显示和卡顿提醒功能在多人服务器上完全可用。但「区块管理」功能（冻结/卸载/还原）需要服务器权限，仅限单人/局域网主机使用。

Q: 卡顿提醒会误报吗？ A: Mod 采用「持续检测」机制，只有 TPS 持续低于阈值一定的时间才会提醒，避免瞬时波动导致误报。

Q: 冻结操作会破坏我的存档吗？ A: 不会。冻结只是让实体停止 AI 和重力，实体仍然存在，你可以随时通过「彻底还原」恢复（实际上是重新生成实体）。

Q: 卸载操作可以撤销吗？ A: 不可以。卸载操作会移除区块内的所有实体和方块实体，且不可恢复。请谨慎使用！

👨‍💻 作者

  • 作者: 计算机1101
  • 许可证: MIT License
  • 源码: 暂不公开

🙏 致谢

  • Fabric 团队提供的优秀 Mod 开发框架
  • Minecraft 社区的支持与反馈

如果这个 Mod 帮到了你，不妨去 curseforge/Modrinth 上给我一个好评 ⭐