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

• QR Code Pairing – Embedded WebSocket server generates a QR code; scan 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

✈️ Create & Aeronautics Integration (NEW — Summer 2026)

This is the centerpiece of the Summer 2026 Special Edition. Turn your DG‑LAB device into a full‑body flight interface.

Create: Aeronautics Integration:

• 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 vibration intensity; hovering keeps it silent
• Collision Shock – Instant high‑intensity pulse on impact – simulates crash sensation
• Balloon Damage – Fading pulse when a balloon/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 Mod Integration:

• Engine Vibration – Real‑time feedback based on engine RPM – feel the machine's power
• Fault Warning – Alert pulse on engine overheating or damage – catch issues before they fail
• Mechanical Operation – Continuous micro‑vibrations while rotating parts (shafts, gears) are running

⚡ Damage & Status Detection

• Combat Damage – Configurable multiplier, min/max strength, and pulse duration per damage type
• 10 Damage Types – Separate settings for Generic, Projectile, Fire, Fall, DoT, Magic, Explosion, Drown, Environmental, and Death
• Low Health Trigger – Continuous pulses when below max health (configurable strength per 10% lost)
• Low Hunger Trigger – Continuous pulses when below max hunger (configurable strength per 10% lost)
• Absorption Hearts – Golden apple absorption is counted as effective health
• Creative/Spectator Immunity – No haptics in creative or spectator modes
• Pause Detection – No health/hunger checks when the game is paused (ESC)

📊 Strength System

• Triple Limit System – Effective limit = min(APP limit, in‑game config limit)
• A/B Channel Independent Limits – Separate tracking and notifications for each channel
• Float Precision Stacking – All damage contributions use float arithmetic, rounded only at final output
• Auto Clamping – Strength never exceeds the effective limit

🖥️ HUD Display

• 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× scaling
• Smooth Transitions – Dynamic lerp animation: fast rise on damage, gradual fall on recovery
• Connection Status – Text indicators showing "✓ Connected" or "✗ Disconnected"
• Pause‑Aware Animation – Wave and pulse animations freeze when the game is paused
• Semi‑transparent Background – Light overlay for readability on any scene

⚙️ Configuration (YACL)

• No ModMenu Required – Press B to open the main menu, or access YACL config directly
• Per‑Scenario Settings – Independent multiplier, min, max, and duration for each damage type
• Preset System – Save, load, import, and export strength presets (shader‑pack style list with scrollbar)
• Built‑in Presets – Light, Medium, Heavy, Extreme – ready to use out of the box
• Confirmation Dialogs – Warns when importing presets that exceed current limits

📋 Requirements

• Fabric API version must match your Minecraft version.
• YetAnotherConfigLib (YACL) – just choose the latest version that corresponds.
• Note: 1.21.x requires Java 21, while 26.x requires Java 25.

Optional Dependencies (for integration features)

💡 Integration features auto‑hide when their respective mods are not installed – the base mod remains fully functional.

Hardware:

• DG‑LAB Coyote 3.0 device
• A mobile phone with the official DG‑LAB 3.0 App

🚀 Quick Start

1. Install the mod – Drop blankdglab-<version>.jar into your mods folder
2. Install optional integrations – (Optional) Add Create and/or Aeronautics for flight feedback
3. Open the mod – Press B in‑game to open the main menu
4. Connect your device – Click "QR Code Connect", then scan the QR code with the DG‑LAB App on your phone
5. Set APP limits – In the DG‑LAB App, go to SOCKET Control and tap the + button on both A and B channel limits until they reach your desired maximum
6. Play! – The HUD will show connection status, and in‑game events will trigger haptic pulses

⚙️ Configuration

All settings are accessible via B key → main menu → settings, or directly through YACL.
Configuration is saved to config/blankdglab.json.

Connection Settings

Damage Feedback (per type)

Each damage type has independent settings:

Supported damage types: Generic, Projectile, Fire, Fall, DoT, Magic, Explosion, Drown, Environmental, Death, Attack, Block Break

Status Feedback

Aeronautics Feedback (requires Create: Aeronautics)

HUD Settings

📡 How it Works

Minecraft → Embedded WebSocket Server → DG‑LAB App (phone) → Bluetooth → Coyote Device

The mod embeds a WebSocket server that implements the DG‑LAB SOCKET V2 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, and the App relays them to the device via Bluetooth.

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: NeoForge for Minecraft 1.21.1 – delivered in this release.
• Continued Maintenance — We will keep maintaining the 26.x branch with bug fixes and improvements.
• Newer Versions — Support for the latest Minecraft releases will be added over time.
• Legacy Backport — Gradual backporting to Minecraft 1.20 and above is planned, but progress will be slow.
• More Integrations — Exploring additional mod integrations based on community feedback.

❓ 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 is required.

Q: Will it get me banned?
A: No. It does not give any 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 V2 protocol does not provide a 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: Can I use it with other haptic devices?
A: Currently only the DG‑LAB Coyote 3.0 is supported via the official SOCKET V2 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. The flight features are an added bonus.

Q: I found a bug / have a suggestion – where can I report?
A: Please open an issue on the GitHub issue tracker.

📜 License

This mod is licensed under the GNU Lesser General Public License v3.0 (LGPL-3.0). See LICENSE file for details.

🤝 Acknowledgements

• DG‑LAB for providing the open‑source SOCKET V2 communication protocol
• The Fabric team for the excellent modding toolchain
• The NeoForge team 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: June 2026 | Supports Minecraft 1.21.1、1.21.11~26.2 | Summer 2026 Edition