Blank DG-LAB
- By
把 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
Connect your DG-LAB Coyote 3.0 device to Minecraft for real-time, game-driven haptic feedback.
Blank DG‑LAB is a client‑side mod for Minecraft that transforms in‑game events into physical haptic pulses via the DG‑LAB Coyote 3.0 device. Feel every hit, every fall, every close call – and now, feel every turn, climb, and engine roar with deep Create & Aeronautics integration.
This is a haptic / biofeedback peripheral mod. It contains no sexual themes, NSFW elements, or age‑restricted material. All feedback is purely based on in‑game damage, player actions, and vehicle physics.
✨ Features
🔗 Connection
| Feature | Description |
|---|---|
| QR Code Pairing | Embedded WebSocket server generates a QR code; scan it with the DG‑LAB App to connect instantly |
| No External Backend | The mod runs its own WebSocket server internally – no Node.js or separate backend needed |
| Auto Port Detection | Automatically finds available ports, with a randomize button for quick changes |
| Reconnection Support | Automatically attempts to reconnect if the app disconnects |
| IP Input Sanitization | Handles Chinese punctuation and full‑width numbers in manual IP entry |
✈️ Vehicle Integration (Create + Aeronautics)
The centerpiece of the Summer 2026 Special Edition – turn your DG‑LAB into a full‑body flight interface.
| Mod | Feature | Description |
|---|---|---|
| Create: Aeronautics | Speed‑to‑Haptic | Vehicle speed maps directly to vibration intensity – the faster you fly, the stronger the feedback |
| Steering Feel | Turns add extra pulses based on angular velocity – every bank and roll becomes tangible | |
| Altitude Feedback | Vertical speed (climb/descent) controls intensity; hovering stays silent | |
| Collision Shock | Instant high‑intensity pulse on impact – simulates a crash | |
| Balloon Damage | Fading pulse when an airship envelope is breached – mimics lift loss | |
| Four Presets | Light / Medium / Strong / Extreme – one‑click switch for different tolerance levels | |
| Custom Curve | Freely configure "every X m/s = Y intensity" for fine‑tuned personal preference | |
| Create | Engine Vibration | Real‑time vibration based on engine RPM |
| Fault Warning | Alert pulse on engine overheating or damage | |
| Mechanical Operation | Continuous micro‑vibrations while rotating parts (shafts, gears) run |
💡 Integration features auto‑hide when their respective mods are not installed – the base mod remains fully functional.
⚡ Damage & Status Detection
| Category | Description |
|---|---|
| Combat Damage | Independent multiplier, min/max strength, and pulse duration for each damage type |
| Damage Types | Generic, Projectile, Fire, Fall, DoT, Magic, Explosion, Drown, Environmental, Death, Attack, Block Break |
| Low Health Trigger | Continuous pulses below max health (independent strength per 10% lost) |
| Low Hunger Trigger | Continuous pulses below max hunger (independent strength per 10% lost) |
| Absorption Hearts | Golden apple absorption counts as effective health |
| Creative/Spectator Immunity | All haptic feedback automatically disabled in creative or spectator mode |
| Pause Detection | Health/hunger checks paused when the game is paused (ESC) |
📊 Strength System
| Feature | Description |
|---|---|
| Dual Limit System | Effective strength = min(APP limit, in‑game config limit) |
| A/B Independent Channels | Each channel tracks and notifies its own limit |
| Float Precision Stacking | All damage contributions use float arithmetic, rounded only at final output |
| Auto Clamping | Output strength never exceeds the effective limit |
🖥️ HUD Display
| Feature | Description |
|---|---|
| 4 Visual Styles | BAR, WAVE, PULSE, NUMBER |
| Draggable Position | In‑game HUD editor with drag‑and‑drop positioning |
| Adjustable Scale | 0.5× to 2.0× zoom |
| Smooth Animation | Linear interpolation: fast rise on damage, gradual fall on recovery |
| Connection Status | Shows "✓ Connected" or "✗ Disconnected" |
| Pause‑Aware | Wave and pulse animations freeze when the game is paused |
| Semi‑transparent Background | Light overlay for readability on any scene |
⚙️ Configuration (YACL)
| Feature | Description |
|---|---|
| Quick Access | Press B to open the main menu, or access YACL directly |
| Fine Tuning | Independent multiplier, min, max, and duration for each damage type |
| Preset System | Save, load, import, and export strength presets (scrollable list) |
| Built‑in Presets | Light, Medium, Heavy, Extreme – ready out of the box |
| Safe Import | Confirmation dialog when importing presets that exceed current limits |
🌍 Current Version Support
| Protocol | Minecraft | Loader | Status |
|---|---|---|---|
| V4 | 26.x | Fabric / NeoForge | ✅ Released |
| V2 | 1.21.11 | Fabric | ✅ Released · V4 upgrade expected mid‑September |
| V2 | 1.21.1 | NeoForge | ✅ Released · V4 upgrade expected mid‑September |
| V2 | 1.20.1 | Fabric / Forge | ⏳ Not yet released · expected mid‑September |
📋 Requirements
Required Software
| Item | Requirement |
|---|---|
| Minecraft | 26.x / 1.21.11 / 1.21.1 / 1.20.1 |
| Mod Loader | Fabric ≥ 0.18.0 / NeoForge / Forge |
| API | Fabric API / NeoForge / Forge (no separate API required) |
| 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) |
The Fabric API version must match your Minecraft version; just choose the latest YACL version for your loader.
Optional Dependencies
| Mod | Purpose |
|---|---|
| Create | Enables engine vibration and mechanical feedback |
| Create: Aeronautics | Enables speed, steering, altitude, and collision feedback |
| CC:Sable | Improves Aeronautics vehicle detection accuracy (recommended) |
Hardware
- DG‑LAB Coyote 3.0 device
- A mobile phone with the official DG‑LAB 4.0+ App
🚀 Quick Start
| Step | Action |
|---|---|
| 1 | Drop blankdglab-<version>.jar into your mods folder (and install loader dependencies) |
| 2 | (Optional) Install Create and/or Aeronautics for full vehicle feedback |
| 3 | Press B in‑game to open the main menu |
| 4 | Click "QR Code Connect", then scan the QR code with the DG‑LAB App |
| 5 | In the App's SOCKET Control page, tap the + button on the A/B channel limits to set your desired maximum |
| 6 | Select your preferred waveform in the App, then tap the Start button |
| 7 | Start playing – the HUD showing "✓ Connected" means everything is ready |
⚠️ Important (latest version): To respect your waveform choice, the mod only sends digital strength values – it does not send waveforms. The signal is sent only after you select the waveform you want and tap the Start button in the App; the device will then output the haptic feedback.
⚙️ Configuration
All settings are accessible via B → main menu → settings, or directly through YACL.
Configuration is saved to config/blankdglab.json.
Connection Settings
| Setting | Description | Default |
|---|---|---|
| Server Port | Embedded WebSocket server port | 8877 |
| Manual IP | Override auto‑detected IP (leave empty for auto) | - |
| Max Strength | Game‑side strength cap | 40 |
| Min Strength | Minimum pulse strength | 0 |
| Sync A/B Channels | Send combined strength to both channels | true |
Damage Feedback
Each damage type has independent settings for the following three items:
| Setting | Description |
|---|---|
| Enable | Toggle haptic feedback for this damage type |
| Strength A / B | Pulse strength for channel A and B |
| Pulse Duration | Pulse duration in milliseconds |
Supported types: Generic, Projectile, Fire, Fall, DoT, Magic, Explosion, Drown, Environmental, Death, Attack, Block Break
Status Feedback
| Setting | Description | Default |
|---|---|---|
| Low Health Feedback | Pulse when below max health | true |
| Low Health Strength / 10% | Strength per 10% health lost | 5 |
| Low Health Pulse Interval | Milliseconds between pulses | 2000 |
| Low Hunger Feedback | Pulse when below max hunger | false |
| Low Hunger Strength / 10% | Strength per 10% hunger lost | 3 |
| Low Hunger Pulse Interval | Milliseconds between pulses | 3000 |
Aeronautics Feedback
Requires the Create: Aeronautics mod
| Setting | Description | Default |
|---|---|---|
| Speed Feedback | Vehicle speed maps to vibration intensity | true |
| Steering Feedback | Extra pulses based on angular velocity | true |
| Altitude Feedback | Vertical speed controls intensity | true |
| Collision Feedback | Instant strong pulse on impact | true |
| Engine Vibration | RPM maps to continuous vibration | true |
| Fault Warning | Alert pulse on engine damage | true |
| Balloon Damage | Fading pulse on balloon breach | true |
HUD Settings
| Setting | Description | Default |
|---|---|---|
| Show HUD | Toggle HUD visibility | true |
| HUD Style | BAR / WAVE / PULSE / NUMBER | BAR |
| HUD Layout | VERTICAL / HORIZONTAL | VERTICAL |
| HUD Position | Drag‑and‑drop in HUD editor | Left, 30% from top |
| HUD Scale | 0.5× – 2.0× | 1.0 |
Enjoy your haptic Minecraft journey! 🎮
📡 How it Works
Minecraft → Embedded WebSocket Server → DG‑LAB App (phone) → Bluetooth → Coyote DeviceThe mod embeds a WebSocket server that implements the DG‑LAB SOCKET V4 protocol. When you scan the QR code, the DG‑LAB App connects directly to the mod – no external backend or Node.js server needed. The mod sends structured strength and pulse commands which the App relays to the device via Bluetooth; the waveform itself is chosen by you in the App – the mod never writes waveforms to the App, so the sensation always matches your preference.
For Create/Aeronautics integration, the mod reads vehicle physics data (speed, angular velocity, altitude, RPM) in real time and maps them to haptic intensity using your configured curves.
🔮 Future Plans
✅ Completed
- Multi‑version support – 26.x (Fabric / NeoForge), 1.21.11, 1.21.1, and 1.20.1 (Fabric / Forge) are all supported.
- Socket protocol rewrite (V2 → V4) – All versions have been rewritten on the V4 protocol and released.
- t:4 intensity control fix – All versions use SetTempIntensity absolute strength control, fixing strength stacking over‑limit and missing real output issues.
📋 Planned
- Continued maintenance – Maintaining released branches, fixing known issues, and improving performance.
- Version tracking – Following official Minecraft updates and adding compatibility with future versions.
- Ecosystem integrations – Exploring additional mod integrations based on community feedback.
- Server‑specific gameplay – Dedicated multiplayer mechanics, such as damage transfer between channels (channel A's damage shifted to B and vice versa), to enrich the co‑op experience.
❓ FAQ
Q: Is this mod allowed on servers? A: Yes. It is client‑side only and does not interact with server logic. No server installation required.
Q: Will it get me banned? A: No. It provides no unfair advantage and does not modify server packets.
Q: Do I need to run a separate backend? A: No. The mod has its own embedded WebSocket server – just scan the QR code and connect.
Q: Why are the A/B channel limits 0 in the APP? A: The SOCKET protocol provides no command to set APP‑side limits. After connecting, go to the APP's SOCKET Control screen and manually tap the + button on both A and B channel limits to set them to your desired maximum.
Q: The APP shows strength but there is no actual output – why? A: In the latest version, to respect your waveform choice, the mod only sends digital strength values and does not send waveforms. Please select the waveform you want and tap the Start button in the APP – only then will the signal be sent and the device output haptic feedback.
Q: Can I use it with other haptic devices? A: Currently only the DG‑LAB Coyote 3.0 is supported via the official SOCKET protocol.
Q: Do I need Create or Aeronautics for the mod to work? A: No. Both are optional. Without them, the mod still provides full damage‑based haptic feedback. Flight features are an extra bonus.
Q: Found a bug / have a suggestion – where do I report it? A: Please open an issue in the GitHub Issues tracker. I follow up on every report.
💬 Support & Feedback
| Entry | Description | Link |
|---|---|---|
| 📦 Repository | Source code & Releases | Blank-DG-LAB Repository |
| 🐛 Issue Tracker | Report bugs, request features, share ideas | Issues |
| 📖 Wiki | Guides, FAQ & detailed documentation | Wiki |
⭐ Like this mod? Feel free to hit Star on GitHub to show your support – meow! 🐱
📜 License
This mod is licensed under the GNU Lesser General Public License v3.0 (LGPL-3.0). See the LICENSE file for details.
🤝 Acknowledgements
- DG‑LAB for providing the open‑source SOCKET communication protocol
- The Fabric team for the excellent modding toolchain
- The NeoForge / Forge teams for their dedication to the community‑driven loader ecosystem
- YetAnotherConfigLib for the clean configuration GUI framework
- The Create and Aeronautics teams for their incredible mods that made this integration possible
Enjoy your new level of immersion – responsibly!
Last updated: September 2026 | Supports Minecraft 26.x / 1.21.11 / 1.21.1 / 1.20.1 | Summer 2026 Edition
The Blank DG-LAB Team
