# Combat Metrics (Client-Side PvP Telemetry)

Most Minecraft PvP improvement happens by feel. You lose a duel, blame lag, queue again, and carry absolutely zero data from one fight to the next. The few tools that do exist are server-side plugins that just count kills and deaths. They don't tell you *why* you lost.

**Combat Metrics** changes that. It is a completely client-side Fabric mod designed to watch your combat mechanics the way a coach watches game film: silently during the fight, analytically after it. It modifies zero gameplay, sends no packets to the server, and works identically on public multiplayer networks, LAN duels, and singleplayer practice worlds.

---

## What It Measures

Combat Metrics classifies your fight based on the kit you are holding (Sword, Axe/Shield, or Crystal) and tracks specific, high-fidelity mechanical metrics.

### General Combat Metrics

* **Swing Accuracy:** The exact ratio of confirmed entity hits to total weapon swings. Whiffs count against you; mining blocks never does.
* **Damage Taken:** Total hearts lost during the session.
* **Best Combo:** The longest run of consecutive hits landed without taking damage back.
* **First Hits:** Tracks individual "engagements" (when an opponent gets within 3 blocks and leaves past 5 blocks) and tallies who landed the first blow of that exchange.

### Melee (Sword & Axe) Metrics

* **Attack Discipline:** The percentage of swings thrown with your attack cooldown fully charged. The ultimate diagnostic tool to cure spam-clicking.
* **Crit Rate:** The percentage of your landed hits that were jump/falling critical hits.
* **Average Hit Range:** Measures the eye-to-impact distance of your hits, helping you gauge your spacing.

### Crystal & Anchor Metrics

* **Setup Speed (The Two-Tap):** The delay (in milliseconds) between placing your obsidian/anchor and placing the crystal/glowstone on top of it.
* **Totem Re-equip Time:** Starts counting the frame your totem pops and stops when a new one is successfully in your offhand.
* **Defense Response:** Measures the delay between an opponent's action (like placing a crystal near you) and your defensive counter (raising a shield, placing a block, or popping their crystal).

---

## The Interface

### 1. The Defeat Wrap

When you die in combat, the vanilla death screen is replaced with an elegant analytical wrap. It displays your overall performance grade (**S, A, B, C, or F**), highlights your weakest metrics in red, and provides a single, targeted **Training Drill** to focus on in your next match (e.g., *"Respect the 1.9 cooldown: stop swinging before your crosshair indicator is full"*).

### 2. In-Game Graph Browser

Press the graph keybind to open your fight history. Each fight is visually mapped out:

* **Health-over-time curves** showing exactly where you took damage.
* **First-hit timelines** indicating who controlled the pace of the engagements.
* **Setup-speed charts** showing if your crystal placement slowed down as the fight dragged on.

---

## Is this allowed on competitive servers?

**Yes.** Combat Metrics is entirely visual and diagnostic.

* It does **not** automate shield blocks, totem swaps, or placements.
* It does **not** send any packets to the server.
* It does **not** bypass vanilla client restrictions.
* It simply observes raw client-side inputs and events (like health changes and entity spawns) to calculate metrics post-fight. It is as safe to use on Hypixel, PvP Legacy, or MCCI as a standard FPS overlay.

---

## Keybinds (Configurable)

* **Open History/Graph Browser:** `O`
* **Toggle Live Stats HUD:** `I`
* **Manually Start/End Session:** `U` (Useful for open-ended practice arenas)

---

### Requirements

* **Fabric Loader**
* **Fabric API**
* Compatible with Minecraft **1.20.x - 1.21.x**