# ╔══════════════════════════════════════════════════════════════════╗
# ║                  MCPvPBanAnimation · config.yml                  ║
# ╚══════════════════════════════════════════════════════════════════╝
#
#  A player is banned → the ban goes through instantly → a replica of them is
#  smashed by a giant falling mace, and bones fly everywhere.
#  Only bans play it (ban, tempban, IP ban). A normal /kick never does.
#
#  Text uses MiniMessage. Legacy &c / &#RRGGBB codes also work.
#  Placeholders: {username} {reason} {staff} {duration}
#  Times are in ticks (20 ticks = 1 second).
#
#  /mcpvpban test    preview the animation on yourself
#  /mcpvpban reload  apply changes to this file and messages.yml

# Do not change. Used to upgrade this file automatically.
config-version: 4

# Log why each kick/command was or wasn't treated as a ban.
debug: false

# ── Animation ───────────────────────────────────────────────────────────
animation:
  # The mace appears this long after the ban...
  mace-spawn-delay: 4
  # ...and falls for this long. Defaults: impact at about 1.2 s, all gone after about 4 s.
  mace-fall-ticks: 20
  # How high above the replica the mace starts, in blocks.
  mace-height: 12.0
  # Enchantment shimmer on the mace.
  enchanted-mace: true
  # How far the replica looks up at the mace, in degrees (0 = straight ahead).
  look-up: 75
  # Shake the screen of nearby players on impact.
  camera-shake: true
  # auto = real player model on 1.21.9+ (Mannequin), armor stand on older versions.
  # Or force: mannequin / armorstand
  replica: auto
  # Floating text above the replica.
  label: "<red>● <dark_red><bold>{username} BANNED</bold> <red>●"

# ── Ban plugins ─────────────────────────────────────────────────────────
# Works with every ban plugin. Their ban commands (/ban, /tempban, /ipban, /banip, /tempipban...)
# are watched automatically, also namespaced ones like /anyplugin:ban.
# These plugins are hooked directly for exact staff / reason / duration:
# LiteBans, AdvancedBan, LibertyBans. You normally don't need to touch this.
#   API      the plugin's own events (most accurate)
#   COMMAND  watch its ban commands + the kick that follows
#   KICK     only count kicks the server itself reports as bans
#   OFF      never animate this plugin's bans
hooks:
  vanilla: COMMAND
  essentials: COMMAND
  litebans: API
  advancedban: API
  libertybans: API
  lightbans: COMMAND
  # Every other ban plugin (BanManager, MaxBans, ...).
  other: COMMAND

detection:
  # Don't animate silent bans (/ban Steve -s).
  skip-silent-bans: true
  # Only needed if your ban plugin uses an unusual command name, e.g. [ "punish", "gban" ].
  # The target player must be the first argument.
  extra-commands: []
  # Last resort for unsupported ban plugins: count a kick as a ban if its message says
  # "you have been banned". Off by default, a normal kick message could say that too.
  match-kick-message: false