ComboCounter

ComboCounter Mod

**Real-Time Combo and Crit Performance Tracker**

Support the mod!

Get a 24/7 Minecraft server for 25% off your first month!

Click here to get started

📋 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

{
  "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 |
| Fabric API | ✅ Yes | Modrinth |
| Cloth Config | ✅ Yes | Modrinth |

---

🎯 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 |

---

📜 License

ARR License

---

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