Blank DG-LAB

将您的 DG-LAB Coyote 3.0 设备连接到 Minecraft，体验游戏驱动的实时触觉反馈。

Blank DG‑LAB 是一个适用于 Minecraft 26.1 的客户端 Fabric 模组，它通过 DG‑LAB Coyote 3.0 设备将游戏内事件转化为物理触觉脉冲。感受每一次打击、每一次坠落、每一次千钧一发——全部通过官方的 SOCKET V2 协议实现，无需任何外部后端。

这是一个触觉 / 生物反馈外设模组。 不包含任何性暗示、NSFW 内容或年龄限制素材。所有反馈完全基于游戏内的伤害及玩家行为。

✨ 功能特性

🔗 连接

二维码配对 – 内置 WebSocket 服务器生成二维码，使用 DG‑LAB App 扫描即可立即连接
无需外部后端 – 模组内部自行运行 WebSocket 服务器，无需 Node.js 或独立后端
自动端口检测 – 自动寻找可用端口，并提供随机化按钮方便快速变更
重连支持 – 若 App 断开连接，模组将自动尝试重连
IP 输入净化 – 处理手动 IP 输入时的中文标点及全角数字

⚡ 伤害与状态检测

战斗伤害 – 每种伤害类型可独立配置倍率、最小/最大强度及脉冲时长
10 种伤害类型 – 分别设置：普通、弹射物、火焰、摔落、持续伤害、魔法、爆炸、溺水、环境、死亡
低生命值触发 – 生命值未满时持续脉冲（每损失 10% 生命值可配置强度）
低饥饿值触发 – 饥饿值未满时持续脉冲（每损失 10% 饥饿值可配置强度）
吸收生命 – 金苹果提供的吸收效果计入有效生命值
创造/旁观模式免疫 – 在创造或旁观模式下不触发触觉反馈
暂停检测 – 游戏暂停（ESC）时不进行生命/饥饿值检测

📊 强度系统

三重限制系统 – 有效限制 = min(App 限制, 模组配置限制)
A/B 通道独立限制 – 分别追踪每个通道的限制并给出通知
浮点精度累加 – 所有伤害贡献使用浮点数运算，仅在最终输出时取整
自动钳位 – 强度永远不会超过有效限制

🖥️ HUD 显示

4 种视觉风格 – 条形、波形、脉冲、数字
可拖拽位置 – 游戏内 HUD 编辑器，支持拖拽定位
可调节缩放 – 0.5 倍至 2.0 倍缩放
平滑过渡 – 动态插值动画：受伤时快速上升，恢复时逐渐回落
连接状态 – 文字提示显示 “✓ 已连接” 或 “✗ 未连接”
暂停时动画冻结 – 游戏暂停时，波形与脉冲动画会暂停
半透明背景 – 浅色半透明背景，在任何场景下都保证可读性

⚙️ 配置界面（YACL）

无需 ModMenu – 按 B 键打开主菜单，也可直接使用 YACL 配置界面
分场景独立设置 – 每种伤害类型独立配置倍率、最小/最大强度及脉冲时长
预设系统 – 保存、加载、导入、导出强度预设（着色器包风格列表，带滚动条）
内置预设 – 轻、中、重、极限 – 开箱即用
确认对话框 – 导入超过当前限制的预设时会给出警告

📋 需求

软件	版本
Minecraft	26.1 / 26.1.1 / 26.1.2
Fabric Loader	≥ 0.18.0
Fabric API	*
YetAnotherConfigLib (YACL)	≥ 3.9.0+26.1-fabric（必须）
Java	≥ 25

硬件：

DG‑LAB Coyote 3.0 设备
安装有官方 DG‑LAB 3.0 App 的手机

🚀 快速上手

安装模组 – 将 blankdglab-<版本号>.jar 放入您的 mods 文件夹
打开模组 – 在游戏中按 B 键打开主菜单
连接设备 – 点击 “二维码连接”，然后用手机上的 DG‑LAB App 扫描二维码
设置 App 限制 – 在 DG‑LAB App 中进入 SOCKET 控制界面，分别点击 A、B 通道限制旁边的 + 按钮，直到达到您期望的最大值
开始游戏！ – HUD 会显示连接状态，游戏内事件将触发触觉脉冲

⚙️ 配置说明

所有设置均可通过 B 键 → 主菜单 → 设置访问，或直接通过 YACL 界面调整。
配置文件保存于 config/blankdglab.json。

连接设置

设置项	说明	默认值
服务器端口	内置 WebSocket 服务器端口	`8877`
手动 IP	覆盖自动检测的 IP（留空则自动检测）	（空）
最大强度	脉冲最大强度（游戏侧上限）	`40`
最小强度	脉冲最小强度	`0`
同步 A/B 通道	将合并后的强度同时发送至两个通道	`true`

伤害反馈（按类型）

每种伤害类型均有独立设置：

设置项	说明
启用	是否对该伤害类型启用触觉反馈
A / B 通道强度	A、B 通道各自的脉冲强度
脉冲时长	脉冲持续时间（毫秒）

支持的伤害类型： 普通、弹射物、火焰、摔落、持续伤害、魔法、爆炸、溺水、环境、死亡、攻击、方块破坏

状态反馈

设置项	说明	默认值
低生命值反馈	生命值未满时是否脉冲	`true`
每损失 10% 生命值的强度	每损失 10% 生命值对应的强度	`5`
低生命值脉冲间隔	两次脉冲之间的毫秒数	`2000`
低饥饿值反馈	饥饿值未满时是否脉冲	`false`
每损失 10% 饥饿值的强度	每损失 10% 饥饿值对应的强度	`3`
低饥饿值脉冲间隔	两次脉冲之间的毫秒数	`3000`

HUD 设置

设置项	说明	默认值
显示 HUD	是否显示 HUD	`true`
HUD 风格	条形 / 波形 / 脉冲 / 数字	`条形`
HUD 布局	垂直 / 水平	`垂直`
HUD 位置	在 HUD 编辑器中拖拽定位	左侧，距顶部 30%
HUD 缩放	0.5 倍 – 2.0 倍	`1.0`

📡 工作原理

Minecraft → 内置 WebSocket 服务器 → DG‑LAB App（手机） → 蓝牙 → Coyote 设备模组内置了一个实现 DG‑LAB SOCKET V2 协议的 WebSocket 服务器。当您扫描二维码时，DG‑LAB App 会直接连接到该模组——无需外部后端或 Node.js 服务器。模组会发送结构化的强度和脉冲指令，App 再通过蓝牙将这些指令转发给设备。

❓ 常见问题

问：这个模组在服务器上使用会被允许吗？
答：是的。它仅工作在客户端，不与服务器逻辑交互，也无需在服务器端安装任何内容。

问：使用这个模组会导致封号吗？
答：不会。它不提供任何不公平的优势，也不修改服务器数据包。

问：我需要单独运行一个后端服务吗？
答：不需要。模组自带嵌入式 WebSocket 服务器，只需扫描二维码即可连接。

问：为什么 App 中 A/B 通道的限制是 0？
答：SOCKET V2 协议没有提供设置 App 侧限制的命令。连接成功后，请进入 App 的 SOCKET 控制界面，手动点击 A、B 通道限制旁的 + 按钮，将其设置为您的期望最大值。

问：我能将它用于其他触觉设备吗？
答：目前仅支持通过官方 SOCKET V2 协议的 DG‑LAB Coyote 3.0。

问：我发现了一个 bug / 我有一个建议，在哪里反馈？
答：请在 GitHub 的 issue 跟踪器中提交问题。

📜 许可证

本模组采用 GNU 宽通用公共许可证 v3.0（LGPL-3.0）。详情请见 LICENSE 文件。（DG‑LAB 后端为独立项目，使用其自有许可证。）

🤝 致谢

DG‑LAB 提供了开源的 SOCKET V2 通信协议
Fabric 团队提供了优秀的模组开发工具链
YetAnotherConfigLib 提供了简洁的配置界面框架

尽情享受全新的沉浸体验 – 请负责任地使用！

最后更新：2026 年 5 月 | 支持 Minecraft 26.1.x