⚔ CombatMe

Prevent teleport abuse during PvP with combat tagging, action bar countdown, and full config control.

---

📖 What is CombatMe?

CombatMe is a lightweight Paper plugin that tags both players the moment one hits the other. While tagged, every teleport command is blocked — no more running /home mid-fight, no /rtp to escape, no /tpa cheese. A clean action bar countdown keeps players informed without cluttering the screen with titles or chat spam.

Once the timer runs out with no further combat, the tag is lifted and players are free to teleport again.

---

✨ Features

• ⚔ Instant combat tagging on both attacker and victim
• 🚫 Teleport command blocker — /home, /warp, /tpa, /rtp, /spawn, /tp, and more
• 🎨 Action bar countdown — color shifts as time runs out
  • 🔴 Red — lots of time left
  • 🟡 Yellow — halfway through
  • 🟢 Lime — almost done
  • ⚪ White — flash when combat ends
• 💬 Private chat alerts — attacker and victim each get their own message on tag
• 🔔 Action bar alert — flashes a warning when a blocked command is attempted
• 🔊 Sound alerts — configurable sounds on tag and on blocked commands
• ♻️ Timer reset — hitting again resets the countdown to full duration
• 🛡 Bypass permission — for staff who should never be tagged
• 🎯 Ender pearl friendly — ender pearls do not trigger combat tagging
• 🔧 Live reload — /combatme reload applies config changes instantly

---

🎬 How It Works

Player A hits Player B
  ├─ Both are combat-tagged for 10 seconds (configurable)
  ├─ Action bar: :::::::::::: (red)
  ├─ Player A chat: "You hit Steve! You are now in PVP mode for 10 seconds."
  └─ Player B chat: "You're on PVP mode, cannot use any TP command until 10 seconds."

Player B tries /home while tagged
  ├─ Command is cancelled
  └─ Action bar: "You are in PVP! Cannot teleport for 7 seconds!"

10 seconds pass without combat
  ├─ Action bar: :::::::::::: (white flash, then clears)
  └─ Chat: "You are no longer combat-tagged."

---

⚙️ Configuration

Every message, sound, and blocked command can be customized in config.yml.

# How long (in seconds) a player stays combat-tagged
combat-duration: 10

messages:
  # Sent to the attacker — supports {victim} and {time}
  attacker-tagged: "&cYou hit &f{victim}&c! You are now in PVP mode for &f{time}&c seconds."

  # Sent to the victim — supports {time}
  victim-tagged: "&cYou're on PVP mode, cannot use any TP command until &f{time}&c seconds."

  # Chat message when the tag expires
  combat-end-chat: "&a[CombatMe] &7You are no longer combat-tagged."

  # Action bar message when a blocked command is attempted — supports {time}
  blocked-actionbar: "&cYou are in PVP! Cannot teleport for &f{time}&c seconds!"

  # Action bar flash when combat tag expires
  expire-actionbar: "&fCombat ended!"

sounds:
  on-tag:   "ENTITY_VILLAGER_HURT"  # leave "" to disable
  on-block: "ENTITY_VILLAGER_HURT"
  volume: 1.0
  pitch:  1.2

# Commands to block while combat-tagged (no slash needed)
blocked-commands:
  - home
  - warp
  - tpa
  - tpaccept
  - rtp
  - spawn
  - tp
  - teleport
  - back
  # add any custom commands here

Placeholders

Placeholder	Available in	Description
{time}	attacker-tagged, victim-tagged, blocked-actionbar	Remaining seconds
{victim}	attacker-tagged	Name of the player who was hit

---

🔑 Permissions

Permission	Default	Description
combatme.admin	OP	Use /combatme reload
combatme.bypass	false	Never gets combat-tagged

---

💬 Commands

Command	Permission	Description
/combatme reload	combatme.admin	Reload config.yml without restarting the server

---

📦 Requirements

Server software	Paper 1.21.1+
Java version	Java 21+

⚠️ This plugin will not work on Spigot or CraftBukkit. Paper is required.

---

❓ FAQ

Does this work with EssentialsX? Yes. EssentialsX commands like /home, /warp, /tpa, and /back are all blockable via blocked-commands in config.

Does this work with CMI / other home plugins? Yes, as long as you add the command to blocked-commands in config.

Do ender pearls count as combat? No. Ender pearl throws do not trigger combat tagging by design.

Can I change how long the tag lasts? Yes. Change combat-duration in config.yml and run /combatme reload.

---

🐛 Bugs & Support

Found a bug or have a suggestion?

📧 Email: herzfnf@gmail.com

Please include:

• Your server version (e.g. Paper 1.21.1 build 123)
• Your Java version (java -version)
• A description of the issue or the full error from your console

---

Made with ❤ by Herza