⚔ PixelCombat

The combat plugin your competitive server deserves.
Lightweight. Zero dependencies. Built for Paper 1.21.1.

---

🔥 Why PixelCombat?

Most combat plugins ship bloated with libraries you don't need, configs you'll never touch, and performance you'll always feel.
PixelCombat does the opposite — every feature is hand-optimized, every config key does something real, and the whole plugin runs on what Paper already provides.

No Caffeine. No Gson. No SnakeYAML. No LiteCommands. Just clean, fast combat logic.

---

✨ Features

⚔ Combat Tagging

• Tags both players the moment a hit lands — no delay, no missed hits
• Combat timer resets on every hit, just like Donut SMP
• Customizable duration per server (default 15s)
• Glow effect so both fighters are visible through terrain

📊 Real-Time Action Bar

• Live countdown shown directly on the player's screen
• Shows Ender Pearl cooldown inline: Combat: 14s, Ender Pearl: 8s
• Fully customizable format with color codes and hex colors (&#RRGGBB)
• Optional progress bar, opponent name, and health display

🛡 New-Player PvP Protection

• Brand-new players get automatic PvP immunity on their first join
• A boss bar counts down their remaining protection time
• Boss bar color, style, and title are fully configurable
• Protected players cannot be attacked — attackers see a clear warning
• Attacking while protected removes protection immediately (configurable)
• Admin commands to remove protection from one player or everyone

🏰 Spawn Safe Zone

• Define a rectangular safe zone with a wand or commands
• Combat players cannot enter — they get pushed back automatically
• Knockback is corrected so players are never phased through the wall
• Red glass boundary visualization — players see the wall before they hit it
• No WorldGuard required

💀 Combat Logger System

• Players who disconnect during combat are punished instantly
• Kill on rejoin — they die the moment they reconnect
• Inventory drop at logout location (armor + offhand configurable)
• Server-wide broadcast so everyone knows who ran

🚫 Command Blocking

• Block any command during combat (spawn, home, tp, warp, etc.)
• Full list is configurable — add or remove any command
• Bypass permission for trusted players or staff

🏆 Killstreak System

• Tracks consecutive kills per player
• Broadcasts at configurable milestones (3, 5, 10, 15, 20...)
• Resets on death

🎮 Combat Mechanics

Feature	Description
Ender Pearl Cooldown	Extra cooldown while in combat (configurable ticks)
Elytra Disable	Prevents gliding during combat
Flight Disable	Removes /fly during combat (Creative/Spectator exempt)
Glow Effect	Both fighters glow white — visible through walls

🔊 Sound System

• Custom sounds for: tag, untag, combat log
• Every sound individually configurable (name, volume, pitch)
• Uses standard Bukkit Sound enum — no resource packs needed

📈 bStats Analytics

• Tracks tagged players, spawn protection status, and combat duration
• Anonymous — no personal data collected

---

📋 Commands

Command	Description	Permission
/pc status [player]	Check combat status	pixelcombat.status
/pc toggle	Toggle chat notifications	pixelcombat.toggle
/pc info	Plugin info & stats	Everyone
/pc tag <p1> [p2]	Force-tag player(s)	pixelcombat.tag
/pc untag <player>	Remove from combat	pixelcombat.untag
/pc protection remove <player>	Remove PvP protection	pixelcombat.protection
/pc protection removeall	Clear all protections	pixelcombat.protection
/pc protection status [player]	Check protection status	pixelcombat.protection
/pc region wand	Get region selection wand	pixelcombat.region
/pc region pos1/pos2	Set safe zone corners	pixelcombat.region
/pc region clear	Delete the safe zone	pixelcombat.region
/pc reload	Reload config & messages	pixelcombat.reload

Aliases: /pc, /combat, /ctag

---

⚙ Configuration

Every single feature can be toggled independently.
Messages support & color codes and &#RRGGBB hex colors throughout.

# Combat timer, logger punishment, leave warning mode (once / interval)
# Action bar format with {time}, {pearl}, {bar}, {opponent}, {health}
# Boss bar color, style, title for new-player protection
# Spawn safe zone with boundary visualization
# Ender pearl cooldown, elytra, flight, glow effect
# Killstreak milestones, custom sounds, blocked commands