CombatMe

⚔ 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

- ⚔ Live reload on both attacker and victim - 🚫 Live reload — `/home`, `/warp`, `/tpa`, `/rtp`, `/spawn`, `/tp`, and more - 🎨 Live reload — color shifts as time runs out - 🔴 Live reload — lots of time left - 🟡 Live reload — halfway through - 🟢 Live reload — almost done - ⚪ Live reload — flash when combat ends - 💬 Live reload — attacker and victim each get their own message on tag - 🔔 Live reload — flashes a warning when a blocked command is attempted - 🔊 Live reload — configurable sounds on tag and on blocked commands - ♻️ Live reload — hitting again resets the countdown to full duration - 🛡 Live reload — for staff who should never be tagged - 🎯 Live reload — ender pearls do Live reload 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`.

```yaml

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

| | | |---|---| | Java version | 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: Email:

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*