⚔️DynamicCombat | Advanced Anti-CombatLog Engine

#
# ================================================================================================
#                                   DYNAMIC COMBAT CONFIGURATION
#                                  Free Edition - Version 1.5
# ================================================================================================

# +----------------------------------------------------------------------------------------------+
# |                                       GLOBAL SETTINGS                                        |
# +----------------------------------------------------------------------------------------------+
# Total countdown time (in seconds) that a player remains tagged after attacking or being attacked.
combat-duration : 15

hooks:
  griefprevention :
    # Set to false if you want tagged players to be allowed inside claims during combat
    block-entry : true

# +----------------------------------------------------------------------------------------------+
# |                                       PVP TOGGLE ENGINE                                      |
# +----------------------------------------------------------------------------------------------+
pvp-toggle :
  # Allows players to turn PvP mode on or off via /pvp or /dc pvp
  enabled : true

  # Cooldown (in seconds) between toggling PvP status to prevent abuse
  cooldown-seconds : 10

# Dynamic Audio Cue Engine
# Reference standard Spigot Sound enums (e.g., "ENTITY_ENDER_DRAGON_GROWL", "BLOCK_NOTE_BLOCK_PLING")
audio :
  # Sound triggers instantly when a player initiates or takes damage in combat.
  combat-trigger:
    enabled : true
    sound : "ENTITY_ENDER_DRAGON_GROWL"
    volume : 0.7
    pitch : 1.5

  # Sound triggers when the timer naturally expires and the player becomes safe.
  combat-safe:
    enabled : true
    sound : "ENTITY_EXPERIENCE_ORB_PICKUP"
    volume : 0.8
    pitch : 1.0

# List of worlds where the combat tagging mechanism is completely ignored.
disabled-worlds :
 - "creative_world"

# +----------------------------------------------------------------------------------------------+
# |                                     VISUAL INTERACTION                                       |
# +----------------------------------------------------------------------------------------------+
# Real-time heads-up display rendered directly above the player's hotbar.
action-bar:
  enabled : true
  format : "&8&l[&c&l⚔&8&l] &fCombat &8» &c{time}s remaining &8| &4&lDON'T LOG OUT"

# +----------------------------------------------------------------------------------------------+
# |                                    ANTI-COMBAT LOGGING                                       |
# +----------------------------------------------------------------------------------------------+
# Direct rules enforced when a client forcefully terminates their connection while tagged.
combat-log:
  kill-on-logout : true

  # BEHAVIOR MATRIX FOR INVENTORY TREATMENT ON EXECUTION:
  # "DROP"   -> Drops everything directly onto the floor for the victor to claim.
  # "KEEP"   -> Restores items safely to the player upon their next login.
  # "DELETE" -> Delete all player items
  disconnect-item-mode : "DROP"

  # If set to true, anyone holding 'dynamiccombat.bypass.logger' will not be executed on quit.
  bypass-for-staff : false

  # Broadcast string sent across the entire network when a logger is eliminated.
  # Leave blank "" to disable. Supports multi-line formats using \n.
  broadcast-message : "&8&m----------------------------------------\n&c&lCOMBAT LOG &8» &e{player} &7disconnected in battle and was executed!\n&8&m----------------------------------------"

# +----------------------------------------------------------------------------------------------+
# |                                   COMMAND RESTRICTION MAP                                    |
# +----------------------------------------------------------------------------------------------+
command-restriction:
  enabled : true

  # PROCESSING MODES:
  # "ALL"       -> Halts EVERY single command executed while in combat (except /dynamiccombat, /dc, /combat, /pvp).
  # "BLACKLIST" -> Strictly intercepts only the custom commands mapped below.
  mode : "ALL"

  # System only evaluates this registry array if mode is explicitly set to "BLACKLIST".
  blacklist-commands :
   - "tp"
    - "tpa"
    - "home"
    - "spawn"
    - "warp"
    - "fly"
    - "pv"

# +----------------------------------------------------------------------------------------------+
# |                                  TACTICAL ITEM MECHANICS                                     |
# +----------------------------------------------------------------------------------------------+
enderpearl :
  # If true, enderpearl teleportation is permitted. If false, items are instantly locked out.
  allow-in-combat : true

# +----------------------------------------------------------------------------------------------+
# |                                     LOCALIZATION ENGINE                                      |
# +----------------------------------------------------------------------------------------------+
messages:
  no-permission : "&8[&c&l!&8] &cInadequate permissions."
  player-not-found : "&8[&c&l!&8] &cTarget player is currently offline."
  config-reloaded : "&8[&a&l+&8] &aDynamicCombat interface configurations refreshed!"
  status-in-combat : "&8[&c&l⚔&8] &7Active tag remaining: &e{time}s"
  status-safe : "&8[&a&l&8] &7Your active tag status is clear."
  staff-check-combat : "&8[&c&l⚔&8] &e{player} &7is tagged for &c{time}s&7."
  staff-check-safe : "&8[&a&l&8] &e{player} &7is clear."
  enderpearl-blocked : "&8[&c&l!&8] &cEnderpearl matrix locked while in combat!"
  command-blocked : "&8[&c&l!&8] &cCommand execution restricted during combat!"
  region-entry-blocked : "&cYou cannot enter this zone while in combat!"

  # PvP Toggle Messages
  pvp-enabled : "&8[&a&l+&8] &aPvP mode has been toggled ON!"
  pvp-disabled : "&8[&c&l-&8] &cPvP mode has been toggled OFF!"
  pvp-toggle-in-combat : "&8[&c&l!&8] &cYou cannot toggle PvP mode while in combat!"
  pvp-toggle-cooldown : "&8[&c&l!&8] &cPlease wait &e{time}s &cbefore toggling PvP mode again!"
  pvp-attacker-off : "&8[&c&l!&8] &cYou have PvP toggled off! Use &e/pvp on &cto engage in combat."
  pvp-defender-off : "&8[&c&l!&8] &e{player} &chas PvP toggled off!"