Pixel Combat

⚔ 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 Red glass boundary visualization — 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.

```yaml

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