InputBooster
InputBooster 是一款客户端侧的 Fabric 模组,用于在 Minecraft 运行帧率较低或出现短暂卡顿的情况下改善输入处理。
当 Minecraft 负载较高时,快速点击或按键有时会被遗漏。InputBooster 会以更高的频率检查输入状态,并可暂时缓冲部分输入,以便在下一次有效的游戏刻中处理它们。
特性
- 更高频的输入轮询
- 短输入缓冲
- 短暂掉帧期间的输入恢复
- 重复命中保护
- CPS(每秒点击次数)限制器
- 疾跑与 W 键连点辅助
- 自动横移与移动辅助
- 可选的输入录制回放功能
- 按服务器配置文件
- 游戏内输入统计
- 安全模式
- 自定义快捷键
该模组仅作用于客户端,无需服务端安装任何组件。
要求
- Minecraft:
1.21.x / 26.1.x - Fabric Loader:
0.16.0+ - Fabric API
- Java 21+
安装
为你的 Minecraft 版本安装 Fabric Loader 和 Fabric API,然后将 InputBooster 的 .jar 文件放入 mods 文件夹。
如果发现 Bug 或兼容性问题,请在 GitHub 上提交报告,并附上你的 Minecraft 版本、Fabric Loader 版本、InputBooster 版本以及相关日志。
InputBooster 由 Ahaduzzaman Khan 开发并维护。
InputBooster
InputBooster is a client-side Fabric mod that improves input handling when Minecraft is running at low FPS or experiencing short stutters.
When Minecraft is under load, quick clicks or key presses can sometimes be missed. InputBooster checks inputs more frequently and can temporarily buffer some inputs so they can be handled on the next valid game tick.
Features
- Higher-frequency input polling
- Short input buffering
- Input recovery during short FPS drops
- Duplicate hit protection
- CPS limiter
- Sprint and W-tap assistance
- Auto-strafe and movement helpers
- Optional input replay recording and playback
- Per-server profiles
- In-game input statistics
- Safe mode
- Custom keybinds
The mod is client-side and does not require anything on the server.
Requirements
- Minecraft:
1.21.x / 26.1.x - Fabric Loader:
0.16.0+ - Fabric API
- Java 21+
Installation
Install Fabric Loader and Fabric API for your Minecraft version, then put the InputBooster .jar file into your mods folder.
If you find a bug or compatibility problem, please report it on GitHub with your Minecraft version, Fabric Loader version, InputBooster version, and any relevant logs.
InputBooster is developed and maintained by Ahaduzzaman Khan.
下载 inputbooster
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 inputbooster
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 inputbooster
下载 inputbooster
下载 inputbooster
下载 inputbooster
下载 inputbooster
下载 inputbooster
下载 inputbooster
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 inputbooster
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
InputBooster 3.1.6-alpha — Minecraft 1.21.1 / 1.21.4 / 1.21.11
Alpha 构建版本。 仅限客户端;请将其安装在与 Fabric API 相同的 mods/ 目录中。
支持的 Minecraft 版本
| Jar | Minecraft |
|---|---|
inputbooster-3.1.6-alpha-mc12111.jar |
1.21.11 |
inputbooster-3.1.6-alpha-mc1214.jar |
1.21.4 |
inputbooster-3.1.6-alpha-mc1211.jar |
1.21.1 |
每个 Jar 文件都声明了各自的精确 Minecraft 范围,需要 Java 21、Fabric loader 0.19+ 以及不低于其编译所基于版本的 Fabric API。
已验证的修复项
与现代化分支相同的输入管线修复,移植至 1.21.x 源码:
- 原生输入采样曾脱离游戏线程执行。 Poller 不再调用平台按键状态 API;游戏线程每渲染一帧和每刻钟发布一次不可变的快照,poller 读取该快照。采样失败仅报告一次,并降级为按刻钟率采样。
- 共享按键绑定。 一个绑定到两个操作的按键现在会从事件路径分发两者,匹配轮询路径(位掩码解析而非首次匹配)。
- POLL 模式状态跟踪。 Slots 在 POLL 模式下进行更新(调度被抑制),因此模式切换永远不会从陈旧的状态开始。
- 防御性拷贝 用于按键绑定数组,这样任何调用者都无法通过修改内部状态来重新绑定操作。
- 原子化的点击/滚轮窗口,防止两个线程在同一防抖窗口内同时接受点击。
特定于旧版的说明
- 使用 Java 21 工具链编译并测试;这些 Jar 文件声明了 Java 21 作为最低要求。早期的 3.1.5 Jar 文件声明了
>=25,并在 1.21.x 上被加载器拒绝。 - 此处使用的 1.21.x Sodium 版本未提供 Config API,因此这些 Jar 文件不声明 Sodium 入口点,始终显示 InputBooster 自己的选项按钮。
自定义键盘处理程序与按键映射
处理程序模式选择非确定性
当启用 alpha 自定义处理程序时,Poller 会跳过刻钟快照,且没有任何检查确认该处理程序是否实际能接收事件。在键盘/鼠标 mixins 未应用的客户端上,这会导致模组完全没有输入源,且静默无声。现在源选择是一个纯粹的决定过程(InputPollingThread.chooseSource,返回 RAW/SNAPSHOT/IDLE 结果):
- 原生采样器可用 -> 原始、按帧率采样的状态;
- 否则,自定义处理程序禁用 -> 刻钟快照;
- 否则,自定义处理程序启用 且 其钩子已传递事件 -> 处理程序拥有输入权;
- 否则(启用但未看到任何事件)-> 刻钟快照加上一行警告,而不是死寂的输入。
活动源每次更改时都会记录日志,源切换会重置引擎以防止任何按键被继承为“按住”状态,并且覆盖层的键盘行现在区分“自定义 (alpha, 实时)”与“自定义 (alpha, 尚未有事件)”。
尊重玩家的实际绑定,并命名回退项
Slot 解析在无法读取映射时仍会回退到原版默认值,但不再隐式地进行:KeyBindingSet 记录哪些 slots 发生了回退以及原因是缺少映射还是访问器失败,并且回退警告会列出受影响的 slot 名称一次。解析成功的映射始终保留玩家实际绑定的按键,包括自定义鼠标按键。
注册恰好发生一次
Fabric 不会检测重复的按键映射:注册同一个 KeyMapping 两次会在控制屏幕中添加第二行,此时玩家的重新绑定仅适用于其中一行。入口点现在在注册前声明单次注册权限,并且 createKeyMappings() 仍在模组构造期间运行,位于注册之前以及任何输入管线连接之前。
测试
完整套件(102 个测试)在每个目标平台上运行,包括 StabilityAuditTest(共享绑定、重置、别名、并发点击主张、并发状态更新、轮询率 60–1000 Hz、不可用的原生状态)和 MixinTargetSignatureTest,后者针对确切版本的已解析 Minecraft Jar 验证每个 mixin 钩子。
4.1.2 — Minecraft 26.2 build
Jar: inputbooster-4.1.2-mc262.jar · Fabric · 仅限客户端
修复
- 打开设置界面时崩溃。 Mod Menu 和原版选项按钮可能会因
java.lang.StackOverflowError(“无法为 'inputbooster' 加载配置界面”)而失败。该界面通过调用重新进入其自身初始化程序的方式来重建小部件列表,导致每次打开或滚动都会使堆栈增长直至溢出。现在改为直接重建列表。 - 未知的限制器模式可能导致设置界面无法打开。 手动写入或由旧版构建生成的
cps_mode值在加载配置和设置时现会进行验证,若无效则回退到文档记录的默认值,而不是在构建界面时抛出异常。 - 覆盖层遮挡了 F3 文本。 即使调试屏幕处于开启状态,面板仍以不透明背景绘制于角落,从而覆盖了原版的 F3 行。当 F3 开启时,面板现位于调试文本块下方且不绘制背景,因此双方互不遮挡。
- 模组报告了一个从未构建过的版本号。 覆盖层、
/inputbooster命令以及启动日志均显示4.1.2-alpha,尽管实际 Jar 文件为 4.1.2 版本。现在版本号直接从加载的 Jar 文件中获取。 - Sodium 或 Iris 强制引擎进入轮询模式。 两者曾被误判为拥有输入权限的模组,导致在正常的 Sodium 客户端中事件路径被关闭且不再使用。由于这两个模组均不涉及输入处理,现在仅真正的输入类模组(控制器模组、Zoomify)才会触发兼容性回退机制。
- 点击可能命中超出攻击范围的目标。 攻击路径此前允许对六格内的任何实体发起攻击,同时声称使用的是原版攻击距离。现已恢复为仅限原版近战攻击距离(三格)。
- 在土耳其语区域设置的系统中,预设名称可能被错误解析,导致预设无声地回退到平衡默认值。现在预设名称的比较不再依赖区域设置。
变更
- 输入模组检测改为向加载器请求模组 ID,而非在初始化期间加载其他模组的类,从而减少启动时的开销,并避免受到其他模组类初始化的影响。
备注
- Minecraft 26.2, Fabric Loader 0.19.5+, Fabric API 0.161.0+, Java 25。
- Sodium 和 Mod Menu 仍为可选组件。若安装了 Sodium,设置将出现在 InputBooster 自身的页面中(位于 Sodium 的视频设置内);若未安装,则可通过 Mod Menu 或原版选项界面打开设置。
- 此为客户端模组——服务器端无需安装。
性能改进
- 降低了 CPU、内存和磁盘负载:
- 服务器身份现在每个窗口仅派生一次。
- 按键快照和绑定重建仅在检测到更改时发生。
- 设置写入已合并到后台线程并原子化写入。
- 区块调度故意交由原版 Minecraft、Sodium 和 Lithium 处理。
- 轮询器在菜单中和暂停时将频率降低至 20 Hz,同时在游戏中保持全速轮询。
- 在设置中新增了 Performance Engine(性能引擎)部分,提供以下控制选项:
- 各个模块的开关。
- 检查间隔。
- 写入延迟。
- 未声称有 FPS 提升,因为在运行中的客户端未进行测量。
输入正确性 (4.0.1-beta)
- 修复了 COOLDOWN CPS 模式:最小点击间隔错误地被乘以两次纳秒,导致约 15 小时的延迟。现在它正确使用 35 ms 或窗口时长除以配置的上限值。
- 在箱子和其他物品栏内的点击不再在游戏世界中执行。
- 与方块的右键交互恢复正常,而不再总是使用手持物品。
- 切换到副手物品的按键不再意外消耗食物或放置方块。
- 单个失败的行动不再导致游戏刻循环崩溃。
- 安全模式可以禁用输入层。
- 由模组触发的跳跃动作现在精确执行一次。
- 暂停期间按住按键的游戏恢复后,不再产生新的按下事件。
- 实体攻击现在会验证目标是否存活且在可触及范围内。
- 回放功能不再虚高命中次数、CPS 或点击音效。
- 配置改进:
- 导入/导出目录处理正确。
- 正确的架构版本。
- 有界的事件日志。
- 固定的 CPS 窗口。
- 覆盖层缩放现在也能正确缩放文本。
键盘路由 (4.0.2-alpha)
- 修复了在聊天中输入空格导致玩家跳跃的问题。
- 屏幕状态现在使用游戏自身的屏幕打开方法来记录。
- 当打开屏幕时,排队输入的输入事件会被丢弃。
- 新增了一个可选的 Custom Keyboard ALPHA(自定义键盘 Alpha)处理器:
- 受警告屏幕保护。
- 激活时显示红色横幅。
- 默认通过配置文件中的
custom_keyboard_handler=false禁用。 - 不修改原版按键绑定。
- 不会取消其他模组的输入。
稳定性审计 (4.0.2-stable → 4.0.3-stable)
- 回放功能现在会在屏幕打开时等待,而不是丢失背后的事件。
- 当没有可用按键源时,轮询器会重新为其边缘检测器播种。
- 初始化和刻循环现在捕获
Throwable,防止链接错误逃逸到每一次刻中。 - 启动日志现在会标识应用了哪个屏幕钩子。
4.0.2-stable 撤回
版本 4.0.2-stable 被撤回,因为三个 Mixin 访问器暴露了非私有静态方法,Mixin 拒绝此类方法。这导致 Minecraft 客户端在加载过程中崩溃。
修复
- 将受影响的辅助方法移至
MixinAccess。 - 添加了构建测试,如果任何 mixin 声明了非私有静态方法,则测试失败。
修复一些已知错误并添加优化功能
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
评论 0
登录后参与评分
还没有评论,来抢沙发吧