ComboCounter
ModMIT

ComboCounter

A mod that counts ur combo and crit and displays on screen and also resets if u can't keep that chain...

420
Downloads
1
Followers
4 months ago
Updated
📦
1
Versions

📖About ComboCounter

ComboCounter Mod

Real-Time Combo and Crit Performance Tracker

BisectHosting Banner

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! ⚔️☠️**