Crit Flow

⚔ CritFlow: Combo-Charged PvP Combat

CritFlow turns critical hits into momentum. Every crit you land on an opponent adds combo points, every hit you take drains them — so holding a combo means staying aggressive and precise. Points climb through 5 tiers of escalating buffs, from a tiny
Spark to a full
Supernova.

Instead of invisible RPG stats, your players see exactly what is on them: a compact action bar with buff tags and combo progress. No chat spam, no guessing.

Why Your Server Needs This Plugin

• Skill-rewarding combat. Combos reward players who aim for crits (fall attacks, sprint jumps) and punish passive tank-poking — a hit you don't take is a point you keep.
• Progression built in. 5 tiers — Spark, Flame, Firestorm, Inferno, Supernova — with thresholds from 10 to 160 points. Players chase the dragon-growl of the final tier without any admin intervention.
• Visible, never noisy. One-line action bar: buff tags (Vamp V · KB 75% · Res II · Abs +2♥ · Crit +10%) plus live combo progress. It appears with the first crit and silently fades when the combo cools down.
• Golden hearts that respect apples. CritFlow's absorption bonus stacks on top of vanilla golden and enchanted golden apple pools — and damage is tracked honestly: the tier bonus sits on top of whatever is left of the apple, refills every second, and never resurrects eaten apple hearts. Full vanilla compatibility for PvP food meta.
• Performance-first. One global heartbeat (every 20 ticks) for all players — not a timer per player. Buff application is idempotent (survives milk, /reload, conflicting plugins), data is cleaned on quit and death, and one failing player can never freeze the tracker for everyone else.
• Localized. Every player sees the action bar and command feedback in their own language (EN / RU by client locale). Tier names are bilingual too — define both in config.yml.

How It Works

• Land critical hits on players: +2 combo points each.
• Get hit by a player: −1 point (never below 0).
• Cross a tier threshold and the buffs apply instantly — with a level-up sound (ENTITY_ENDER_DRAGON_GROWL on the final tier).
• Stop critting for 20 seconds and the combo cools down completely.

Tier ladder

• Spark — 10 points — Vampirism I
• Flame — 30 points — Vampirism II · KB 50%
• Firestorm — 60 points — Vampirism III · KB 50% · Resistance I
• Inferno — 100 points — Vampirism IV · KB 75% · Resistance I · Absorption +1♥
• Supernova — 160 points — Vampirism V · KB 75% · Resistance II · Absorption +2♥ · Crit damage ×1.10

Every number is configurable (points per crit, drain on damage, combo timeout, max points, crit multiplier, all tier stats and both names for each tier).

⌨️ Commands

• /critflow give <player> <1-5|tier-id> — set a player's combo to a tier threshold
• /critflow reset <player> — full reset: points and all buffs

Permission:
critflow.admin (defaults to operators). Tab completion is built in (subcommands → player names → tiers).

⚙️ Technical Advantages for Administrators

• Performance: single Bukkit task over all online players, per-player error isolation, ConcurrentHashMap registry wiped on quit/death — no memory leaks, no lag under load.
• Safety: knockback resistance is applied as an idempotent attribute modifier, resistance/absorption as self-healing potion effects. A /reload or plugin conflict can't leave half-buffs behind — traces are purged on disable.
• Full configuration: combo economy (points, drain, timeout, cap), crit damage multiplier, all five tiers' stats with independent RU/EN display names. Validated and clamped at load — a broken config can't crash the server or produce negative heals.
• Localization: EN/RU chosen per client locale, covering the action bar, buff tags and every command message; console stays quiet — no log spam during gameplay.
• Compatibility: Paper 26.3 (Java 25), pure Paper API, no NMS, no external dependencies.

Installation

• Drop CritFlow-1.0.0.jar into your server's /plugins folder.
• Restart the server (plugin.yml has api-version: 26.3).
• Optionally edit plugins/CritFlow/config.yml (all tier values and both names per tier) — fully validated at load.

Perfect For

• PvP, practice and arena servers that want visible mechanical skill expression.
• Survival/SMP projects looking for a light combat-progression layer that doesn't touch economy.
• Any server tired of invisible stat plugins — here every buff is shown on the player's own action bar.

Install CritFlow and make every crit feel earned!