⚔ 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