# \u2694 CombatMe<\/p>\n
> **Prevent teleport abuse during PvP with combat tagging, action bar countdown, and full config control.**<\/p>\n
—<\/p>\n
## \ud83d\udcd6 What is CombatMe?<\/p>\n
CombatMe is a lightweight Paper plugin that **tags both players** the moment one hits the other. While tagged, every teleport command is blocked \u2014 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.<\/p>\n
Once the timer runs out with no further combat, the tag is lifted and players are free to teleport again.<\/p>\n
—<\/p>\n
## \u2728 Features<\/p>\n
– \u2694 **Instant combat tagging** on both attacker and victim
\n– \ud83d\udeab **Teleport command blocker** \u2014 `\/home`, `\/warp`, `\/tpa`, `\/rtp`, `\/spawn`, `\/tp`, and more
\n– \ud83c\udfa8 **Action bar countdown** \u2014 color shifts as time runs out
\n – \ud83d\udd34 **Red** \u2014 lots of time left
\n – \ud83d\udfe1 **Yellow** \u2014 halfway through
\n – \ud83d\udfe2 **Lime** \u2014 almost done
\n – \u26aa **White** \u2014 flash when combat ends
\n– \ud83d\udcac **Private chat alerts** \u2014 attacker and victim each get their own message on tag
\n– \ud83d\udd14 **Action bar alert** \u2014 flashes a warning when a blocked command is attempted
\n– \ud83d\udd0a **Sound alerts** \u2014 configurable sounds on tag and on blocked commands
\n– \u267b\ufe0f **Timer reset** \u2014 hitting again resets the countdown to full duration
\n– \ud83d\udee1 **Bypass permission** \u2014 for staff who should never be tagged
\n– \ud83c\udfaf **Ender pearl friendly** \u2014 ender pearls do **not** trigger combat tagging
\n– \ud83d\udd27 **Live reload** \u2014 `\/combatme reload` applies config changes instantly<\/p>\n
—<\/p>\n
## \ud83c\udfac How It Works<\/p>\n
“`
\nPlayer A hits Player B
\n \u251c\u2500 Both are combat-tagged for 10 seconds (configurable)
\n \u251c\u2500 Action bar: :::::::::::: (red)
\n \u251c\u2500 Player A chat: “You hit Steve! You are now in PVP mode for 10 seconds.”
\n \u2514\u2500 Player B chat: “You’re on PVP mode, cannot use any TP command until 10 seconds.”<\/p>\n
Player B tries \/home while tagged
\n \u251c\u2500 Command is cancelled
\n \u2514\u2500 Action bar: “You are in PVP! Cannot teleport for 7 seconds!”<\/p>\n
10 seconds pass without combat
\n \u251c\u2500 Action bar: :::::::::::: (white flash, then clears)
\n \u2514\u2500 Chat: “You are no longer combat-tagged.”
\n“`<\/p>\n
—<\/p>\n
## \u2699\ufe0f Configuration<\/p>\n
Every message, sound, and blocked command can be customized in `config.yml`.<\/p>\n
“`yaml
\n# How long (in seconds) a player stays combat-tagged
\ncombat-duration: 10<\/p>\n
messages:
\n # Sent to the attacker \u2014 supports {victim} and {time}
\n attacker-tagged: “&cYou hit &f{victim}&c! You are now in PVP mode for &f{time}&c seconds.”<\/p>\n
# Sent to the victim \u2014 supports {time}
\n victim-tagged: “&cYou’re on PVP mode, cannot use any TP command until &f{time}&c seconds.”<\/p>\n
# Chat message when the tag expires
\n combat-end-chat: “&a[CombatMe] &7You are no longer combat-tagged.”<\/p>\n
# Action bar message when a blocked command is attempted \u2014 supports {time}
\n blocked-actionbar: “&cYou are in PVP! Cannot teleport for &f{time}&c seconds!”<\/p>\n
# Action bar flash when combat tag expires
\n expire-actionbar: “&fCombat ended!”<\/p>\n
sounds:
\n on-tag: “ENTITY_VILLAGER_HURT” # leave “” to disable
\n on-block: “ENTITY_VILLAGER_HURT”
\n volume: 1.0
\n pitch: 1.2<\/p>\n
# Commands to block while combat-tagged (no slash needed)
\nblocked-commands:
\n – home
\n – warp
\n – tpa
\n – tpaccept
\n – rtp
\n – spawn
\n – tp
\n – teleport
\n – back
\n # add any custom commands here
\n“`<\/p>\n
### Placeholders<\/p>\n
| Placeholder | Available in | Description |
\n|—|—|—|
\n| `{time}` | `attacker-tagged`, `victim-tagged`, `blocked-actionbar` | Remaining seconds |
\n| `{victim}` | `attacker-tagged` | Name of the player who was hit |<\/p>\n
—<\/p>\n
## \ud83d\udd11 Permissions<\/p>\n
| Permission | Default | Description |
\n|—|—|—|
\n| `combatme.admin` | OP | Use `\/combatme reload` |
\n| `combatme.bypass` | `false` | Never gets combat-tagged |<\/p>\n
—<\/p>\n
## \ud83d\udcac Commands<\/p>\n
| Command | Permission | Description |
\n|—|—|—|
\n| `\/combatme reload` | `combatme.admin` | Reload config.yml without restarting the server |<\/p>\n
—<\/p>\n
## \ud83d\udce6 Requirements<\/p>\n
| | |
\n|—|—|
\n| **Server software** | Paper 1.21.1+ |
\n| **Java version** | Java 21+ |<\/p>\n
> \u26a0\ufe0f This plugin will **not** work on Spigot or CraftBukkit. Paper is required.<\/p>\n
—<\/p>\n
## \u2753 FAQ<\/p>\n
**Does this work with EssentialsX?**
\nYes. EssentialsX commands like `\/home`, `\/warp`, `\/tpa`, and `\/back` are all blockable via `blocked-commands` in config.<\/p>\n
**Does this work with CMI \/ other home plugins?**
\nYes, as long as you add the command to `blocked-commands` in config.<\/p>\n
**Do ender pearls count as combat?**
\nNo. Ender pearl throws do not trigger combat tagging by design.<\/p>\n
**Can I change how long the tag lasts?**
\nYes. Change `combat-duration` in `config.yml` and run `\/combatme reload`.<\/p>\n
—<\/p>\n
## \ud83d\udc1b Bugs & Support<\/p>\n
Found a bug or have a suggestion?<\/p>\n
\ud83d\udce7 **Email:** [herzfnf@gmail.com](mailto:herzfnf@gmail.com)<\/p>\n
Please include:
\n– Your server version (e.g. Paper 1.21.1 build 123)
\n– Your Java version (`java -version`)
\n– A description of the issue or the full error from your console<\/p>\n
—<\/p>\n
*Made with \u2764 by **Herza***<\/p>\n","protected":false},"excerpt":{"rendered":"
an pvp fair system when someone starting a fight the one who start it doesn’t run with TP command \ud83d\ude08<\/p>\n","protected":false},"featured_media":44352,"template":"","meta":{"_minecraft_slug":"combatme","_minecraft_project_id":"O6KpTOJZ","_minecraft_author":"herza.ori_","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":69,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"combatme.zip","_minecraft_size_bytes":12029,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T20:29:50.928851Z","_minecraft_date_created":"2026-03-04T23:55:42.989335Z","_minecraft_date_modified":"2026-03-03T13:01:54.293533Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/combatme","_minecraft_icon_attachment_id":44352,"_minecraft_imported_at":"2026-06-02T02:27:30+00:00","_minecraft_import_hash":"4979186ba1817d2f5cdd9de9ed3fa29a","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[89,127,867,92],"mod_loader":[132],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-44351","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-game-mechanics","mod_category-paper","mod_category-social","mod_category-utility","mod_loader-paper","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n