Blank DG-LAB

# Blank DG-LAB v1.0.0

A client-side Fabric mod that translates in-game events into real-time haptic feedback via the DG-LAB Coyote device, using the official SOCKET V2 protocol.

> **This is a haptic / biofeedback peripheral mod, not a toy or adult content.**  
> It contains no sexual themes, NSFW elements, or age‑restricted material. All feedback is purely based on in‑game damage and player actions.

## ✨ Features

### Connection & Setup
- **QR Code Pairing** – Embedded WebSocket server generates a QR code for one‑tap pairing with the DG‑LAB app
- **Auto Port Detection** – Automatically finds an available port, with a button to randomize if needed
- **Smart Reconnection** – Automatically attempts to reconnect if the app disconnects
- **Lenient IP Input** – Handles Chinese punctuation and full‑width numbers in manual IP entry
- **Troubleshooting Hints** – In‑game guidance appears when a connection attempt fails

### Gameplay-Driven Haptics
- **Combat Feedback** – Configurable multiplier, minimum, and maximum strength per damage event
- **Low Health Pulse** – Continuous pulse when below max health (configurable strength per 10% lost)
- **Low Hunger Pulse** – Continuous pulse when below max hunger (configurable strength per 10% lost)
- **Absorption Aware** – Golden apple absorption hearts count as effective health
- **Smart Idle Detection** – No feedback is triggered in Creative/Spectator mode or when the game is paused (ESC)

### Strength System
- **Triple-Limit Safety** – Effective strength = min(APP limit, in‑game config limit)
- **Independent A/B Channels** – 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
- **Fully Draggable** – In‑game HUD editor with drag‑and‑drop positioning
- **Adjustable Scale** – Scale from 0.5× to 2.0×
- **Smooth Animations** – Dynamic lerp transitions: fast rise on damage, gradual fall on recovery
- **Status Text** – Clear "Connected" or "Disconnected" indicators
- **Limit Display** – Shows config limits when disconnected, actual APP limits when connected
- **Semi‑transparent Background** – Subtle dark overlay keeps the HUD readable in any scene

### Configuration (YACL)
- **Standalone Configuration** – Press `B` to open the in-game configuration screen, powered by YACL
- **Per‑Scenario Tuning** – Independent multiplier, min, and max values for each damage type
- **Preset System** – Save, load, import, and export strength presets (shader‑pack style list with scrollbar)
- **Import Safety** – Confirmation dialog warns when importing a preset that exceeds current limits

### Protocol
- **DG-LAB SOCKET V2** – Full compliance with the official protocol
- **Correct ID Management** – Proper clientId/targetId handling ensures reliable command delivery
- **Strength Commands** – Type 1/2/3 for increase/decrease/set, auto‑converted to APP format
- **Pulse Waveforms** – Custom waveform data transmission supported
- **Disconnect Notification** – Sends `statusCode=500` when the game disconnects

## 📋 Requirements

| Software | Version |
|----------|---------|
| Minecraft | 26.1 / 26.1.1 / 26.1.2 |
| Fabric Loader | ≥ 0.18.4 |
| Fabric API | ≥ 0.145.1+26.1 |
| YetAnotherConfigLib (YACL) | ≥ 3.9.3+26.1-fabric |
| Java | ≥ 25 |

*YACL is a mandatory dependency. Mod Menu is not required.*

**Hardware:**  
- DG‑LAB Coyote 3.0 device  
- A mobile phone with the official DG‑LAB App  
- The DG‑LAB SOCKET V2 backend, running on the same computer or local network

## 🤝 Credits

- **DG-LAB SOCKET V2 Protocol** by Dungeon Lab  
- Built with **Fabric Loom**, **ZXing**, and **Java-WebSocket**

---

**Enjoy your new level of immersion – responsibly!**