** ComboCounter Mod

📋 Overview

**ComboCounter** is a lightweight Minecraft Fabric mod that displays your combat performance in real-time. Track your critical hit streaks and combo knockback chains with a clean, customizable HUD overlay.

---

🎯 Summary

| Property | Value |
|----------|-------|
| **Mod Name** | ComboCounter |
| **Mod ID** | `combocounter` |
| **Version** | 1.0.0 |
| **Minecraft** | 1.21.4 |
| **Mod Loader** | Fabric |
| **Side** | Client-side only |
| **Dependencies** | Fabric API, Cloth Config |

---

✨ Features

Core Features
| Feature | Description |
|---------|-------------|
| **☠ Crit Streak Counter** | Tracks consecutive critical hits on enemies |
| **⚔ Combo Streak Counter** | Tracks consecutive hits that knockback enemies |
| **Auto Reset** | Counters reset after 2 seconds of no hits |
| **Real-time Display** | Updates instantly during combat |

Customization
| Feature | Description |
|---------|-------------|
| **12 Position Presets** | Place HUD anywhere on screen |
| **Fine-tune Positioning** | X/Y offset sliders for pixel-perfect placement |
| **Custom Colors** | Change colors for crit, combo, and label text |
| **Text Shadow** | Toggle shadow for better visibility |
| **Toggle Visibility** | Show/hide each counter independently |

Keybindings
| Key | Action |
|-----|--------|
| **H** | Toggle HUD on/off |
| **J** | Open config screen |
| **K** | Cycle through position presets |

---

📍 Position Presets

| Preset | Location |
|--------|----------|
| `TOP_LEFT` | Top left corner |
| `TOP_CENTER` | Top center |
| `TOP_RIGHT` | Top right corner |
| `MIDDLE_LEFT` | Middle left side |
| `CENTER` | Screen center |
| `MIDDLE_RIGHT` | Middle right side |
| `BOTTOM_LEFT` | Bottom left corner |
| `BOTTOM_CENTER` | Bottom center |
| `BOTTOM_RIGHT` | Bottom right corner |
| `ABOVE_HOTBAR` | Just above hotbar |
| `BELOW_HOTBAR` | Below hotbar |
| `CUSTOM` | Manual X/Y coordinates |

---

🎮 How It Works

Critical Hits (☠)
- Detected when you land a **critical hit** on any entity
- Critical hits occur when falling and attacking
- Streak increases with each consecutive crit
- Resets after **2 seconds** of no crits

Combo Hits (⚔)
- Detected when your attack causes **knockback**
- Works on any living entity (mobs, players)
- Streak increases with each successful combo hit
- Resets after **2 seconds** of no hits

---

🛠️ Configuration

Config File Location
```
.minecraft/config/combocounter.json
```

Config Options

```json
{
"enabled": true,
"xOffset": 0,
"yOffset": 0,
"showShadow": true,
"showCritStreak": true,
"showComboStreak": true,
"critColor": "0xFFFF6600",
"comboColor": "0xFF00FFFF",
"labelColor": "0xFFFFFFFF",
"textScale": 1.0,
"positionPreset": "TOP_LEFT",
"padding": 10
}
```

| Option | Type | Default | Description |
|--------|------|---------|-------------|
| `enabled` | boolean | `true` | Master toggle for HUD |
| `xOffset` | int | `0` | Horizontal offset (-200 to 200) |
| `yOffset` | int | `0` | Vertical offset (-200 to 200) |
| `showShadow` | boolean | `true` | Text shadow visibility |
| `showCritStreak` | boolean | `true` | Show crit counter |
| `showComboStreak` | boolean | `true` | Show combo counter |
| `critColor` | hex color | `0xFFFF6600` | Orange color for crits |
| `comboColor` | hex color | `0xFF00FFFF` | Cyan color for combos |
| `labelColor` | hex color | `0xFFFFFFFF` | White color for labels |
| `positionPreset` | string | `TOP_LEFT` | Position preset name |
| `padding` | int | `10` | Edge padding (0-100) |

---

📦 Dependencies

| Dependency | Required | Link |
|------------|----------|------|
| **Fabric Loader** | ✅ Yes | [fabricmc.net](https://fabricmc.net/) |
| **Fabric API** | ✅ Yes | [Modrinth](https://modrinth.com/mod/fabric-api) |
| **Cloth Config** | ✅ Yes | [Modrinth](https://modrinth.com/mod/cloth-config) |

---

🎯 Use Cases

PvP Combat
- Track your crit consistency in duels
- Monitor combo chains against opponents
- Improve your PvP skills with visual feedback

PvE Combat
- See how many crits you land on mobs
- Track combo efficiency during raids
- Challenge yourself to beat your streak records

Practice & Training
- Perfect your critical hit timing
- Learn optimal attack spacing for combos
- Visual feedback for combat improvement

Content Creation
- Display combat stats for viewers
- Show off impressive streak numbers
- Add professional HUD elements to videos

---

📸 HUD Display Example

```
☠ Crit Streak: 7
⚔ Combo Streak: 12
```

**Colors (Default):**
- ☠ Crit Streak: — White label, **Orange** number
- ⚔ Combo Streak: — White label, **Cyan** number

---

🔧 Installation

1. Install **Fabric Loader** for Minecraft 1.21.4
2. Download and install **Fabric API**
3. Download and install **Cloth Config**
4. Place `combocounter-1.0.0.jar` in `.minecraft/mods/`
5. Launch Minecraft

---

⌨️ Controls

| Action | Default Key | Customizable |
|--------|-------------|--------------|
| Toggle HUD | `H` | ✅ Yes (in Controls) |
| Open Config | `J` | ✅ Yes (in Controls) |
| Cycle Position | `K` | ✅ Yes (in Controls) |

---

📊 Technical Details

| Aspect | Detail |
|--------|--------|
| **Detection Method** | Mixin injection into attack packets |
| **Render Method** | Fabric HUD Render Callback |
| **Config Format** | JSON with GSON |
| **Performance Impact** | Minimal (< 1% CPU) |
| **Memory Usage** | ~2 MB |
| **Network Traffic** | None (client-side only) |

---

✅ Compatibility

| Mod Type | Compatible |
|----------|------------|
| Other HUD mods | ✅ Yes |
| Optimization mods (Sodium, Lithium) | ✅ Yes |
| Combat mods | ✅ Yes |
| Minimaps | ✅ Yes |
| Shader packs | ✅ Yes |

---

📝 Changelog

Version 1.0.0
- Initial release
- Crit streak counter with ☠ symbol
- Combo streak counter with ⚔ symbol
- 12 position presets
- Full color customization
- Keybinding support
- Cloth Config integration
- 2-second auto-reset timer

---

🐛 Known Issues

| Issue | Status |
|-------|--------|
| None reported | ✅ Stable |

---

Enjoy tracking your combat skills! ⚔️☠️**

Need a server to run Minecraft Server?
Get 24/7 high-performance hosting from reliable hosting for your community!
Click here to get started with KCB Hosting