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

MIT License — Free to use, modify, and distribute.

---

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