ComboCounter

 

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