Blank DG-LAB

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

Software	Version
Minecraft	26.1 / 26.1.1 / 26.1.2 / 26.2 / 1.21.11 /1.21.1
Mod Loader	Fabric ≥ 0.18.0 or NeoForge
API	Fabric API / NeoForge (no separate API required)
YetAnotherConfigLib (YACL)	≥ 3.9.0+26.1-fabric (for 26.x) / ≥ 3.9.0+1.21.1-neoforge (for 1.21.1) – choose the latest one
Java	≥ 25 (for 26.x) / ≥ 21 (for 1.21.x)

• 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)

Mod	Type	Purpose
Create	Optional	Enables engine vibration & mechanical feedback
Create: Aeronautics	Optional	Enables speed, steering, altitude & collision feedback
CC:Sable	Optional	Improves Aeronautics vehicle detection accuracy (recommended)

💡 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

Setting	Description	Default
Server Port	Embedded WebSocket server port	8877
Manual IP	Override auto‑detected IP (leave empty for auto)	(empty)
Max Strength	Maximum pulse strength (game‑side cap)	40
Min Strength	Minimum pulse strength	0
Sync A/B Channels	Send combined strength to both channels	true

Damage Feedback (per type)

Each damage type has independent settings:

Setting	Description
Enable	Toggle haptic feedback for this damage type
Strength A / B	Pulse strength for channel A and B
Pulse Duration	Duration of the pulse in milliseconds

Supported damage 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 Create: Aeronautics)

Setting	Description	Default
Speed Feedback	Vibration intensity based on vehicle speed	true
Steering Feedback	Extra pulses during turns based on angular velocity	true
Altitude Feedback	Vertical speed maps to vibration intensity	true
Collision Feedback	Instant strong pulse on impact	true
Engine Vibration	RPM‑based 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

---

📡 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