Combat Tag

• /combat-tag reload (alias: /ct) - reloads the config

Command requires the permission combattag.admin.

Placeholders:

• %ct_time_left% - time left in combat (in seconds)
• %ct_in_combat% - whether the player is in combat (true/false)

# Enable the plugin's features?
enabled: true

combat-duration: 20.0

# Enabled: a player's combat status ends the moment the opponent who tagged them leaves or dies.
#          If several players tagged them, it ends once the last of those opponents is gone.
# Disabled: they stay in combat until the timer runs out, whatever happens to their opponents
end-combat-when-opponent-gone: true

# Enabled: if player leaves while in combat, they die and drop their items
kill-on-quit: true

# Only used when 'kill-on-quit' is true.
# Enabled: only kill them when the disconnect was their own doing. Players kicked by an admin/plugin etc. keep their stuff.
kill-on-quit-only-if-at-fault: true

# Only used when 'kill-on-quit' is true.
# Enabled: replace vanilla death message with the 'combat-logged-out' message (messages.yml) when player logs out in combat.
custom-kill-message-on-leave: true

# Enable the command blocker?
enable-command-blocker: true
command-blocker:
  # Enabled: if command has a colon in (e.g. /plugin:spawn), it will ignore the text before the colon, and only check it as '/spawn'
  bypass-colons: true

  # Enabled: each whole word must match (e.g., `/warp spawn` will block `/warp spawn` but not `/warp1` or `/warp spawn1`)
  match-entire-words: true

  blocked-cmds:
    - "/warp spawn"
    - "/home"
    - "/tpa"

Messages:

# All messages use MiniMessage: https://docs.advntr.dev/minimessage/format.html
# Messages support PlaceholderAPI placeholders when it is installed.
# This plugin's own placeholders are written in square brackets, e.g. [opponent].
# Set a message to an empty string to disable it.
combat-tagged: "<#cb0000>You are now in combat with [opponent]"
in-combat-action-bar: "<#cb0000>You are in combat! <grey>(<#ffd0a8>%ct_time_left%<grey>)"
combat-expired: "<green>You are no longer in combat"
combat-logged-out: "[player] logged out in combat whilst fighting [opponent]!"
command-blocked: "<red>You can't run this command while in combat!"
config-reloaded: "<green>Configuration reloaded."

TAB offers a pretty nifty feature where you can display scoreboards determined by conditions. You can use this in conjunction with the in_combat placeholder offered by this plugin to create a scoreboard that is displayed when the player is in combat.

Example usage (in TAB's config.yml):

scoreboard:
  scoreboards:
    # Combat scoreboard (TAB checks top to bottom)
    combat:
      display-condition: "%ct_in_combat%=true" # <- the condition
      title: Combat scoreboard
      lines:
        - ' You are in combat!'
        - ' %ct_time_left% secs left'
    # Default scoreboard
    scoreboard:
      title: Normal scoreboard
      lines:
        - ' The default scoreboard of my server!'