MX Haptics 为你的 Logitech MX Master 4 鼠标在 Minecraft 中带来了真实的触觉反馈。每当你受到伤害、用盾牌格挡攻击、氧气耗尽或与游戏世界互动时,鼠标都会以可配置的图案和强度进行震动。无需模组,无需反应,鼠标会直接通过触觉告知你正在发生什么。
功能
6 种游戏内事件,每种事件均可独立开启/关闭,并支持自定义图案(0–15)、强度(0–100)和冷却时间:
- 受到伤害(默认开启,强反馈)
- 盾牌格挡(近战与投射物,包括箭矢),已开启
- 气泡破裂(默认开启,溺水时的轻微警告)
- 方块被破坏(默认关闭)
- 方块被放置(默认关闭)
- 快捷栏槽位切换(默认关闭,极轻微的提示音)
可通过游戏内设置(需安装 Cloth Config API 和 Mod Menu)或编辑 mxhaptics.json 文件进行配置。
绑定按键「测试触觉震动」可随时一键测试。
使用 /mxhaptics_test [pattern] [intensity] 客户端命令进行手动测试。
自动重连采用指数退避算法;如果未运行 Logi Options+,游戏将正常运行,模组会在后台尝试重新连接。
完全异步处理,桥接 WebSocket 绝不干扰游戏主线程。
跨平台支持:同一个 jar 包可在 Windows 和 macOS 上使用。
适用于任何服务器,包括原版服务器。所有逻辑均在客户端侧运行。
鼠标静止时的延迟震动
如果你长时间保持鼠标完全静止(例如在水下等待气泡恢复氧气时),某些震动可能会延迟到达,有时延迟一两秒。这并非模组导致的问题:当 MX Master 4 未被移动时,它会进入低功耗状态,无线连接接收触觉指令时会产生延迟。同样地,当你操作鼠标时(如浏览快捷栏),震动感觉是即时的。Logi Options+ 目前尚未提供更改此行为的设置,但轻微移动鼠标或使用 Logi Bolt 接收器代替蓝牙连接可能会有所帮助。
需求:
- Logitech MX Master 4 鼠标
- 已安装并运行 Logi Options+
- Logi Options+ 的 HapticWeb 插件,可从 Logi Marketplace 安装(默认端点:wss://local.jmw.nz:41443/ws)
如何测试震动
按键绑定(一键):选项 → 控制 → 按键绑定 → MX Haptics → 「测试触觉震动」,分配一个按键,随时按下即可感受测试震动。
通过聊天栏:输入 /mxhaptics_test 1 75(或 /mxhaptics_test <pattern> <intensity>)。
通过配置界面:打开 Mod Menu → MX Haptics → 开启「Test vibration」小部件并点击「Save Changes」。
如果你想报告错误,可以通过以下方式提交:
GitHub
如果你想支持我的工作及该项目,欢迎通过以下方式捐赠:
Paypal
许可证
MIT - 免费使用、修改和再分发。
MX Haptics brings real haptic feedback to Minecraft on your Logitech MX Master 4 mouse. Every time you take damage, block an attack with your shield, run out of air, or interact with the world, the mouse vibrates with a configurable pattern and intensity. No mods, no reflexes, the mouse tells your hand what's happening.
Features
6 in-game events, each with independent on/off, pattern (0–15), intensity (0–100) and cooldown:
- Damage taken, enabled by default, strong feedback
- Shield block (melee and projectiles, including arrows), enabled
- Air bubble popped, enabled, subtle warning as you drown
- Block broken, disabled by default
- Block placed, disabled by default
- Hotbar slot change, disabled by default, very light tick
Configurable in-game (with Cloth Config + Mod Menu) or via mxhaptics.json.
Keybind "Test haptic vibration" for a one-press test any time.
/mxhaptics_test [pattern] [intensity] client command for manual testing.
Auto-reconnect with exponential backoff, if Logi Options+ isn't running the game plays normally and the mod tries again in the background.
Fully asynchronous, the bridge WebSocket never touches the game thread.
Cross-platform: same jar works on Windows and macOS.
Works on any server, including vanilla. Everything is client-side.
Delayed vibrations when the mouse is idle
If you keep the mouse completely still (for example while waiting underwater for air bubbles), some vibrations may arrive late, sometimes by a second or two. This is not caused by the mod: when the MX Master 4 isn't being moved it enters a low power state, and the wireless connection receives the haptic command with a delay. Events that happen while you're using the mouse, like scrolling through the hotbar, feel instant for the same reason. Logi Options+ doesn't currently offer a setting to change this, but moving the mouse slightly or using the Logi Bolt receiver instead of Bluetooth can help.
Requirements:
A Logitech MX Master 4 mouse
Logi Options+ installed and running
The HapticWeb plugin for Logi Options+, installable from the Logi Marketplace (default endpoint: wss://local.jmw.nz:41443/ws)
How to test the vibration
Keybind (one-click): Options → Controls → Key Binds → MX Haptics → "Test haptic vibration", assign a key, press it any time to feel a test vibration.
From chat: /mxhaptics_test 1 75 (or /mxhaptics_test <pattern> <intensity>).
From the config screen: open Mod Menu → MX Haptics → toggle a "Test vibration" widget ON and click "Save Changes".
If you want to report a bug you can do it from:
GitHub
And if you want to support my work and the project feel free to drop a donation on:
Paypal
License
MIT - free to use, modify and redistribute.
评论 0
登录后参与评分
还没有评论,来抢沙发吧