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 - ⚔ **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`. ```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 &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:** (mailto: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***