CurseForge129 天前
Github129 天前Blank DG-LAB
将您的 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 或其他独立服务 |
| 自动端口检测 | 自动查找可用端口，并提供随机化按钮快速更换 |
| 重连支持 | App 断开后自动尝试重连，无需手动操作 |
| IP 输入净化 | 自动识别并处理中文标点与全角数字等手动输入问题 |
✈️ 载具集成（Create + Aeronautics）
2026 夏季特别版核心功能，将 DG-LAB 变为全身飞行接口。
| 模组 | 功能 | 说明 |
|---|---|---|
| Create: Aeronautics | 速度映射触觉 | 载具速度直接映射振动强度，飞得越快反馈越强 |
| 转向感 | 转向时根据角速度添加额外脉冲，倾斜与翻滚均可感知 | |
| 高度反馈 | 垂直速度（爬升/下降）控制强度，悬停时自动静默 | |
| 碰撞冲击 | 撞击时瞬间高强度脉冲，模拟坠毁感 | |
| 气球损伤 | 气囊破裂时渐隐脉冲，模拟升力损失 | |
| 四种预设 | 轻/中/强/极限一键切换，适配不同耐受度 | |
| 自定义映射 | 自由配置"每 X m/s = Y 强度"，精细调校 | |
| Create | 引擎振动 | 基于引擎 RPM 的实时振动反馈 |
| 故障警告 | 引擎过热或损坏时的警报脉冲 | |
| 机械运作 | 轴、齿轮等旋转部件运转时的持续微振动 |
💡 未安装对应模组时，集成功能自动隐藏，基础功能完全不受影响。
⚡ 伤害与状态检测
| 类别 | 说明 |
|---|---|
| 战斗伤害 | 每种伤害类型独立配置倍率、最小/最大强度与脉冲时长 |
| 伤害类型 | 通用、弹射物、火焰、坠落、持续伤害、魔法、爆炸、溺水、环境、死亡、攻击、破坏方块 |
| 低生命值触发 | 生命值低于最大值时持续脉冲，每损失 10% 可独立配置强度 |
| 低饥饿值触发 | 饥饿值低于最大值时持续脉冲，每损失 10% 可独立配置强度 |
| 吸收心 | 金苹果提供的吸收心计入有效生命值 |
| 创造/旁观者免疫 | 创造或旁观模式下自动禁用所有触觉反馈 |
| 暂停检测 | 游戏暂停（ESC）时暂停生命/饥饿检测 |
📊 强度系统
| 功能 | 说明 |
|---|---|
| 双重限制 | 有效强度 = min(APP 端限制, 游戏内配置限制) |
| A/B 通道独立 | 每个通道独立跟踪与通知限制值 |
| 浮点精度累加 | 所有伤害贡献使用浮点运算，仅最终输出时取整 |
| 自动钳制 | 输出强度永远不会超过有效限制 |
🖥️ HUD 显示
| 功能 | 说明 |
|---|---|
| 4 种样式 | BAR、WAVE、PULSE、NUMBER 自由切换 |
| 拖放定位 | 游戏内 HUD 编辑器直接拖拽调整位置 |
| 缩放调节 | 0.5× ~ 2.0× 缩放，适配不同屏幕 |
| 平滑动画 | 受伤时快速上升，恢复时渐变下降（线性插值） |
| 连接状态 | 实时显示"✓ 已连接"或"✗ 已断开" |
| 暂停感知 | 游戏暂停时波形与脉冲动画自动冻结 |
| 半透明背景 | 轻量设计，任何场景下均可读 |
⚙️ 配置系统（YACL）
| 功能 | 说明 |
|---|---|
| 快捷入口 | 按 B 键打开主菜单，也可直接通过 YACL 访问 |
| 精细调校 | 每种伤害类型独立设置倍率、最小值、最大值与时长 |
| 预设系统 | 保存、加载、导入、导出强度预设（滚动列表） |
| 内置预设 | 轻、中、重、极限四种预设开箱即用 |
| 安全导入 | 导入超过当前限制的预设时弹出确认警告 |
🌍 当前版本支持情况
| 协议 | Minecraft | 加载器 | 状态 |
|---|---|---|---|
| V4 | 26.x | Fabric / NeoForge | ✅ 已发布 |
| V2 | 1.21.11 | Fabric | ✅ 已发布 · 预计 9 月中旬升级 V4 |
| V2 | 1.21.1 | NeoForge | ✅ 已发布 · 预计 9 月中旬升级 V4 |
| V2 | 1.20.1 | Fabric / Forge | ⏳ 未发布 · 预计 9 月中旬 |
📋 环境要求
必备软件
| 项目 | 要求 |
|---|---|
| Minecraft | 26.x / 1.21.11 / 1.21.1 / 1.20.1 |
| 模组加载器 | Fabric ≥ 0.18.0 / NeoForge / Forge |
| API | Fabric API / NeoForge / Forge（无需额外 API） |
| 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 / 1.20.1） |
Fabric API 版本需与 Minecraft 版本匹配；YACL 选择对应的最新版本即可。
可选依赖
| 模组 | 用途 |
|---|---|
| Create | 启用引擎振动与机械反馈 |
| Create: Aeronautics | 启用速度、转向、高度与碰撞反馈 |
| CC:Sable | 提升 Aeronautics 载具检测精度（推荐） |
硬件要求
- DG-LAB Coyote 3.0 设备
- 装有官方 DG-LAB 4.0+ App 的手机
🚀 快速开始
| 步骤 | 操作 |
|---|---|
| 1 | 将 blankdglab-<version>.jar 放入 mods 文件夹（并安装对应加载器所需依赖） |
| 2 | （可选）一并安装 Create 和/或 Aeronautics 以获得完整载具反馈 |
| 3 | 游戏内按 B 键打开主菜单 |
| 4 | 点击"二维码连接"，用 DG-LAB App 扫描二维码 |
| 5 | App 内进入 Socket 控制页，点击 A/B 通道限制的 + 按钮设定上限 |
| 6 | 在 App 中选择您喜欢的波形，然后点击「开始」按钮 |
| 7 | 开始游戏，HUD 显示"✓ 已连接"即配置成功 |
⚠️ 重要提示（最新版本）： 为尊重您的波形选择，模组仅发送数字强度，不发送波形。信号需要您在 App 上选择想要的波形并点击「开始」按钮后才会发送，设备才会实际输出触觉反馈。
⚙️ 配置说明
所有设置可通过 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 |
Aeronautics 反馈
需安装 Create: Aeronautics 模组
| 设置 | 说明 | 默认 |
|---|---|---|
| 速度反馈 | 载具速度映射振动强度 | true |
| 转向反馈 | 角速度触发额外脉冲 | true |
| 高度反馈 | 垂直速度控制强度 | true |
| 碰撞反馈 | 撞击时瞬间强脉冲 | true |
| 引擎振动 | RPM 映射持续振动 | true |
| 故障警告 | 引擎损坏时警报脉冲 | true |
| 气球损伤 | 气囊破裂渐隐脉冲 | true |
HUD 设置
| 设置 | 说明 | 默认 |
|---|---|---|
| 显示 HUD | 切换 HUD 可见性 | true |
| HUD 样式 | BAR / WAVE / PULSE / NUMBER | BAR |
| HUD 布局 | VERTICAL / HORIZONTAL | VERTICAL |
| HUD 位置 | 在 HUD 编辑器中拖放 | 左侧，距顶部 30% |
| HUD 缩放 | 0.5× ~ 2.0× | 1.0 |
享受您的触觉 Minecraft 旅程！ 🎮
📡 工作原理
Minecraft → 内嵌 WebSocket 服务器 → DG-LAB App（手机）→ 蓝牙 → Coyote 设备
模组内嵌一个实现 DG-LAB SOCKET V4 协议的 WebSocket 服务器。当您扫描二维码时，DG-LAB App 直接连接到模组——无需外部后端或 Node.js 服务器。模组发送结构化的强度与脉冲命令，App 通过蓝牙将它们中继到设备；波形由您在 App 中自行选择，模组不会向 App 写入波形，以确保体感始终符合您的偏好。
对于 Create/Aeronautics 集成，模组实时读取载具物理数据（速度、角速度、高度、RPM），并使用您配置的曲线将它们映射到触觉强度。
🔮 未来计划
✅ 已完成
- 多版本支持 —— 26.x（Fabric / NeoForge）、1.21.11、1.21.1、1.20.1（Fabric / Forge）均已支持。
- Socket 协议重写（V2 → V4） —— 全部版本已基于 V4 协议完成重写并发布。
- t:4 强度控制修复 —— 全版本使用 SetTempIntensity 绝对强度控制，修复强度叠加超限与无真实输出的问题。
📋 计划中
- 持续维护 —— 继续维护已发布分支，修复已知问题并持续优化性能。
- 版本跟进 —— 跟随 Minecraft 官方更新，逐步兼容后续新版本。
- 生态集成 —— 根据社区反馈，积极探索与其他模组的联动玩法，拓展模组生态。
- 服务器特殊玩法 —— 针对多人服务器设计专属互动机制，例如伤害转移（A 所受伤害转移至 B，反之亦然）以及其他类似规则，丰富联机体验。
❓ 常见问题
问：这个模组在服务器上允许使用吗？ 答：允许。它仅限客户端，不与服务器逻辑交互。无需服务器安装。
问：会被封号吗？ 答：不会。它不提供任何不公平优势，也不修改服务器数据包。
问：需要运行独立后端吗？ 答：不需要。模组有自己的内嵌 WebSocket 服务器。只需扫描二维码并连接。
问：为什么 APP 中 A/B 通道限制是 0？
答：SOCKET 协议未提供设置 APP 端限制的命令。连接后，请进入 APP 的 SOCKET 控制页，手动点击 A 与 B 通道限制的 + 按钮，将其设置为您期望的最大值。
问：为什么 APP 显示强度但没有实际输出？ 答：最新版本为尊重您的波形选择，模组仅发送数字强度、不发送波形。请在 APP 中选择您想要的波形并点击「开始」按钮，此后信号才会发送、设备才会输出触觉反馈。
问：可以与其他触觉设备一起使用吗？ 答：目前仅支持通过官方 SOCKET 协议连接的 DG-LAB Coyote 3.0。
问：需要 Create 或 Aeronautics 才能使用吗？ 答：不需要。两者都是可选的。没有它们，模组仍提供完整的基于伤害的触觉反馈。飞行功能是额外加分项。
问：发现 bug / 有建议——在哪里反馈？ 答：请访问 GitHub Issues 提交问题或建议，我会及时跟进。
💬 支持与反馈
| 入口 | 说明 | 链接 |
|---|---|---|
| 📦 仓库 | 模组源码与 Releases 发布 | Blank-DG-LAB 仓库 |
| 🐛 问题反馈 | 提交 Bug 报告、功能建议与改进意见 | Issues |
| 📖 Wiki | 使用指南、FAQ 与详细文档 | Wiki |
| CurseForge | 下载连接 | CurseForge |
⭐ 喜欢这个模组吗？麻烦在 GitHub 上点一个 Star 收藏支持，谢谢喵～🐱
📜 许可证
本模组基于 GNU 宽通用公共许可证 v3.0 (LGPL-3.0) 授权。详情见 LICENSE 文件。
🤝 致谢
- DG-LAB 提供开源的 SOCKET 通信协议
- Fabric 团队提供优秀的模组开发工具链
- NeoForge / Forge 团队对社区驱动加载器生态的奉献
- YetAnotherConfigLib 提供简洁的配置 GUI 框架
- Create 与 Aeronautics 团队创造了令人惊叹的模组，使此次集成成为可能
负责任地享受全新的沉浸体验！
最后更新：2026 年 9 月 | 支持 Minecraft 26.x / 1.21.11 / 1.21.1 / 1.20.1 | 2026 夏季版
Forge
Fabric
NeoForge