Combat Tag

A compact and functional plugin for Paper/Bukkit servers that automatically marks players in combat status after mutual attacks and restricts their actions for a specified time. The perfect solution for maintaining PvP encounter fairness.

Main Features and Settings

The modification activates a combat tag system when two players damage each other. During the set period (default 20 seconds), special restrictions apply to fight participants and informational messages are displayed.

Configuration Settings

Key parameters are easily adjustable via configuration file:

• Combat Duration: 20.0 seconds (configurable parameter)
• Kill on Quit: if enabled, players leaving the server during combat die and lose their items
• Messages: all text notifications use MiniMessage format and support PlaceholderAPI placeholders

The command system includes administrative function for reloading settings via /combat-tag reload (short /ct), available to users with combattag.admin permissions.

Information Placeholders

The plugin provides two key placeholders for integration with other systems:

• %ct_time_left% - displays remaining combat time in seconds
• %ct_in_combat% - shows player's current status (true/false)

Command Blocking System

One of the key features is restricting access to certain commands during combat:

enable-command-blocker: true
command-blocker:
  blocked-msg: "<red>You can't run this command while in combat!"
  bypass-colons: true
  match-entire-words: true
  blocked-cmds:
    - "/warp spawn"
    - "/home"
    - "/tpa"

The system supports various command processing modes, including ignoring parameters before colons and exact matching of full words.

Integration with TAB for Combat Scoreboards

The plugin pairs excellently with TAB modification, allowing creation of separate scoreboard interfaces for combat status. Example configuration:

scoreboard:
  scoreboards:
    combat:
      display-condition: "%ct_in_combat%=true"
      title: Combat scoreboard
      lines:
        - ' You are in combat!'
        - ' %ct_time_left% secs left'
    scoreboard:
      title: Normal scoreboard
      lines:
        - ' The default scoreboard of my server!'

The combination of visual notifications, command restrictions, and information hooks makes Combat Tag a universal tool for any PvP server.