pvp-analyzer

PvP Analyzer

Record your fights. See where you're losing. Get better.

PvP Analyzer is a lightweight client-side Fabric mod that tracks your combat performance in real time and gives you actionable feedback after every fight. No server-side component needed — it just watches what you do and tells you what to fix.

---

How It Works

Press F6 to start recording before a fight. Fight. Press F6 again to stop. You get a full breakdown in chat plus a live HUD overlay with color-coded stats.

That's it. No config files, no setup, no menus.

---

What It Tracks

Accuracy & Timing

• Hit/miss ratio — what percentage of your swings actually connect
• Cooldown timing — are you clicking too early and losing damage?
• CPS — are you swinging faster than the cooldown allows?

Aim Quality

• Overflick detection — tracks when your crosshair passes through the target, meaning you flicked past them
• Shield hit percentage — how often you're wasting hits on a blocking player

Spacing & Reach

• Reach distribution — categorizes every hit as close (<2.0), mid (2.0-2.8), long (2.9-3.0), or edge (3.0+)
• Shows if you're fighting too close, too far, or right in the sweet spot

Defense

• Jump reset tracking — detects when you jump within 3 ticks of taking knockback
• Jump reset percentage — compared to total KB events received

---

Post-Fight Tips

After each session, the mod analyzes your stats and generates personalized tips:

❌ *Accuracy is low (38%). Focus on tracking before clicking.
⚠ *Moderate overflicks (12%). Practice smoother tracking.
⚠ *23% of hits were too early. Wait for full cooldown — you're losing damage.
✅ *Excellent jump resets (78%)! You're minimizing KB well.

Tips adjust based on your actual numbers — they're not generic advice.

---

Live HUD

A compact overlay in the top-left corner shows your stats updating in real time during the fight. Color coded: green = you're doing well, yellow = room to improve, red = needs work.

Toggle the HUD with F7.

---

Keybinds

Key	Action
F6	Start / stop recording
F7	Show / hide HUD overlay

---

Installation

1. Install Fabric Loader for 1.21.8
2. Install Fabric API
3. Drop pvp-analyzer-1.0.0.jar into your mods folder
4. Launch the game

---

FAQ

Does this modify gameplay in any way?*
No. It only observes and records. No packets are modified, no inputs are changed, nothing is automated. It's a pure analytics tool.

Will this get me banned?
It's a client-side observer mod — it doesn't interact with the server beyond normal gameplay. It's equivalent to recording your screen and reviewing the footage, but with automatic stat tracking.

Does it work on servers?
Yes, any server. It tracks your client-side actions and events. No server permission needed.

Does it affect FPS?
Negligible. The tracking logic runs a few comparisons per tick. The HUD is a small text overlay. You won't notice it.

---

Requires: Fabric Loader 0.16.14+ · Fabric API · Minecraft 1.21+
Environment: Client only
License: MIT
Github repo: https://github.com/FriendlyNeighbourhoodSpider/pvp-analyzer