Blank DG-LAB

Blank DG-LAB

把 DG-LAB 郊狼连入 Minecraft，每一次受伤、坠落和死亡都会化为真实触觉反馈。Connect your DG-LAB Coyote to Minecraft and feel every hit, fall, and death as real haptic pulses — a serious immersion tool, nothing else.

技术

Blank DG-LAB

Loader

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

Blank DG‑LAB 是一款 Minecraft 客户端模组，通过 DG‑LAB Coyote 3.0 设备将游戏内事件转化为物理触觉脉冲。感受每一次受击、每一次坠落、每一次死里逃生——现在，借助深度集成的机械动力与航空学（Create & Aeronautics），感受每一次转向、爬升和引擎轰鸣。

这是一款触觉/生物反馈外设模组。 它不包含任何性相关主题、NSFW 元素或年龄限制内容。所有反馈均纯粹基于游戏内伤害、玩家行为和载具物理。

✨ 功能特性

🔗 连接

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

✈️ 机械动力与航空学集成（新功能——2026 夏季版）

这是 2026 夏季特别版的核心功能。 将你的 DG‑LAB 设备转变为全身飞行交互界面。

机械动力：航空学集成：

  • 速度映射触觉 – 载具速度直接映射到振动强度——飞得越快，反馈越强
  • 转向感知 – 转弯时根据角速度增加额外脉冲——每一次倾斜和翻滚都变得可感知
  • 高度反馈 – 垂直速度（爬升/下降）控制振动强度；悬停时保持静默
  • 碰撞冲击 – 撞击瞬间产生高强度脉冲——模拟碰撞冲击感
  • 气球损毁 – 气球/飞艇气囊破裂时产生衰减脉冲——模拟升力丧失
  • 四种预设 – 轻柔 / 中等 / 强烈 / 极致——一键切换以适应不同耐受度
  • 自定义曲线 – 自由配置“每 X 米/秒 = Y 强度”，精细调整个性化偏好

机械动力模组集成：

  • 引擎振动 – 根据引擎转速（RPM）提供实时反馈——感受机器的力量
  • 故障警告 – 引擎过热或损坏时发出预警脉冲——在故障发生前及时发现
  • 机械运转 – 旋转部件（传动轴、齿轮）运行时持续产生微振动

⚡ 伤害与状态检测

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

📊 强度系统

  • 三重限制系统 – 有效限制 = 最小值（APP 限制，游戏内配置限制）
  • A/B 通道独立限制 – 分别跟踪和通知每个通道
  • 浮点精度叠加 – 所有伤害贡献使用浮点运算，仅在最终输出时进行取整
  • 自动钳制 – 强度永远不会超过有效限制

🖥️ HUD 显示

  • 4 种视觉样式 – 条形（BAR）、波形（WAVE）、脉冲（PULSE）、数字（NUMBER）
  • 可拖拽位置 – 游戏内 HUD 编辑器，支持拖放定位
  • 可调整大小 – 支持 0.5× 至 2.0× 缩放
  • 平滑过渡 – 动态插值动画：受伤时快速上升，恢复时逐渐回落
  • 连接状态 – 显示“✓ 已连接”或“✗ 未连接”的文字指示器
  • 暂停感知动画 – 游戏暂停时，波形和脉冲动画将冻结
  • 半透明背景 – 轻微覆盖层，确保在任何场景下都清晰可读

⚙️ 配置（YACL）

  • 无需 ModMenu – 按 B 键打开主菜单，或直接访问 YACL 配置界面
  • 分场景设置 – 每种伤害类型拥有独立的倍率、最小值、最大值和持续时间
  • 预设系统 – 支持保存、加载、导入和导出强度预设（带滚动条的着色器包风格列表）
  • 内置预设 – 轻柔、中等、强烈、极致——开箱即用
  • 确认对话框 – 当导入的预设超过当前限制时发出警告

📋 环境要求

软件 版本
Minecraft 26.1 / 26.1.1 / 26.1.2 / 26.2 / 1.21.11 /1.21.1
模组加载器 Fabric ≥ 0.18.0 或 NeoForge
API Fabric API / NeoForge（无需单独的 API）
YetAnotherConfigLib (YACL) ≥ 3.9.0+26.1-fabric (适用于 26.x) / ≥ 3.9.0+1.21.1-neoforge (适用于 1.21.1) – 选择最新版本
Java ≥ 25 (适用于 26.x) / ≥ 21 (适用于 1.21.x)
  • Fabric API 版本必须与你的 Minecraft 版本匹配。
  • YetAnotherConfigLib (YACL) – 只需选择对应的最新版本即可。
  • 注意： 1.21.x 需要 Java 21，而 26.x 需要 Java 25。

可选依赖（用于集成功能）

模组 类型 用途
机械动力（Create） 可选 启用引擎振动及机械反馈
机械动力：航空学（Create: Aeronautics） 可选 启用速度、转向、高度及碰撞反馈
CC:Sable 可选 提升航空学载具检测精度（推荐）

💡 当未安装相应模组时，集成功能将自动隐藏——基础模组功能保持完整可用。

硬件要求：

  • DG‑LAB Coyote 3.0 设备
  • 一部安装了官方 DG‑LAB 3.0 App 的手机

🚀 快速开始

  1. 安装模组 – 将 blankdglab-<版本号>.jar 放入你的 mods 文件夹
  2. 安装可选集成 – （可选）添加机械动力和/或航空学模组以获取飞行反馈
  3. 打开模组 – 在游戏中按 B 键打开主菜单
  4. 连接设备 – 点击“二维码连接”，然后使用手机上的 DG‑LAB App 扫描二维码
  5. 设置 APP 限制 – 在 DG‑LAB App 中，前往 SOCKET 控制界面，点击 A 和 B 通道限制旁的 + 按钮，直到达到你期望的最大值
  6. 开始游玩！ – 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

航空学反馈（需要机械动力：航空学）

设置项 描述 默认值
速度反馈 基于载具速度的振动强度 true
转向反馈 转弯时根据角速度产生额外脉冲 true
高度反馈 垂直速度映射到振动强度 true
碰撞反馈 碰撞瞬间产生强烈脉冲 true
引擎振动 基于转速（RPM）的连续振动 true
故障警告 引擎损坏时发出警报脉冲 true
气球损毁 气囊破裂时产生衰减脉冲 true

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 通过蓝牙将其转发至设备。

对于机械动力/航空学集成，模组实时读取载具物理数据（速度、角速度、高度、转速），并使用你配置的曲线将其映射为触觉强度。

🔮 未来计划

  • ✅ 已完成： 支持 Minecraft 1.21.1 的 NeoForge——已在此版本中发布。
  • 持续维护 — 我们将持续维护 26.x 分支，提供错误修复和改进。
  • 更新版本 — 将随时间推移添加对最新 Minecraft 版本的支持。
  • 旧版移植 — 计划逐步移植至 Minecraft 1.20 及以上版本，但进度会较慢。
  • 更多集成 — 根据社区反馈探索更多模组集成。

❓ 常见问题

问：这个模组在服务器上允许使用吗？
答：允许。它仅限客户端使用，不涉及服务器逻辑。无需在服务器端安装任何内容。

问：使用它会导致我被封禁吗？
答：不会。它不会提供任何不公平优势，也不会修改服务器数据包。

问：我需要运行独立的后端吗？
答：不需要。模组自带内置 WebSocket 服务器。只需扫描二维码即可连接。

问：为什么 APP 中的 A/B 通道限制是 0？
答：SOCKET V2 协议不提供设置 APP 端限制的命令。连接后，请前往 APP 的 SOCKET 控制界面，手动点击 A 和 B 通道限制旁的 + 按钮，将其设置为你期望的最大值。

问：我可以将其与其他触觉设备一起使用吗？
答：目前仅支持通过官方 SOCKET V2 协议连接 DG‑LAB Coyote 3.0 设备。

问：模组正常工作是否需要机械动力或航空学？
答：不需要。两者均为可选。没有它们，模组仍可提供完整的基于伤害的触觉反馈。飞行功能是额外的加成。

问：我发现了错误 / 有建议——在哪里可以报告？
答：请在 GitHub 问题追踪器中提交 Issue。

📜 许可证

此模组根据 GNU 宽通用公共许可证 v3.0（LGPL-3.0） 授权。详情请参阅 LICENSE 文件。

🤝 致谢

  • 感谢 DG‑LAB 提供开源的 SOCKET V2 通信协议
  • 感谢 Fabric 团队提供的优秀模组开发工具链
  • 感谢 NeoForge 团队对社区驱动加载器生态系统的贡献
  • 感谢 YetAnotherConfigLib 提供的简洁配置 GUI 框架
  • 感谢机械动力和航空学团队制作的出色模组，使这一集成成为可能

尽情享受全新的沉浸水平——请合理使用！

最后更新：2026 年 6 月 | 支持 Minecraft 1.21.1、1.21.11~26.2 | 2026 夏季版