Lobby4PvP [1.18-26.1+] ⚔️ Interactive lobby PvP system ✅

# ╔══════════════════════════════════════════════════════════════════════╗
# ║                        Lobby4PvP — v1.8.6                            ║
# ║  Enable PvP in your lobby by holding a sword. Safe, robust, fast.    ║
# ╚══════════════════════════════════════════════════════════════════════╝
#
#  QUICK HELP:
#  • Reload everything live: /lobby4pvp reload
#  • Text supports both legacy '&' colors and MiniMessage
#  • Hotbar slots are 0..8 (0 = far left, 8 = far right)
#  • Java 17+ plugin build; latest Paper 26.1.x servers require Java 25 at runtime
#  • Invalid sounds, particles, materials, enchantments or out-of-range values warn in console and use safe runtime fallbacks
#  • Empty lore lines like "" are valid and kept as intentional spacing
#
#  REFERENCES:
#  • Materials    → https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html
#  • Sounds       → https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Sound.html
#  • Particles    → https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Particle.html
#  • Enchantments → https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/enchantments/Enchantment.html
#
#  NOTE ABOUT STATS:
#  • Player stats (kills, deaths, hits) are stored persistently in 'stats.yml'.
#  • No configuration is required; the file is created and maintained automatically.
#

# ┌──────────────────────────────────────────────────────────────────────┐
# │ Core & Safety                                                       │
# └──────────────────────────────────────────────────────────────────────┘
debug: false                        # Extra console logs (useful for diagnosing conflicts)
check-for-updates: true             # Notify in console if a new version is available
keep-inventory-on-death: true       # Prevent drops/exp on death in the lobby (safe duels)

# ┌──────────────────────────────────────────────────────────────────────┐
# │ PvP Policy (scope & override)                                       │
# └──────────────────────────────────────────────────────────────────────┘
pvp:
  override-others: true             # If true, Lobby4PvP can un-cancel other plugins' PvP blocks
                                    # when BOTH players are in Lobby4PvP mode.
  worlds: ["*"]                     # Where this plugin applies. ["*"] = all worlds.
                                    # Example: ["lobby", "hub1"]
  blocked-message: "&cPvP is blocked here."
                                    # Shown to the attacker when damage is denied by policy.
                                    # Supports legacy '&' colors and MiniMessage.

# ┌──────────────────────────────────────────────────────────────────────┐
# │ Timers (seconds)                                                    │
# └──────────────────────────────────────────────────────────────────────┘
timers:
  activate-seconds: 5               # Hold the sword for X seconds to enter PvP mode
  deactivate-seconds: 10            # After releasing the sword, PvP disables after X seconds
  cooldown-seconds: 0               # Wait time before enabling again (0 = off)

# ┌──────────────────────────────────────────────────────────────────────┐
# │ Display (all channels are consistent)                               │
# └──────────────────────────────────────────────────────────────────────┘
display:
  actionbar: true                   # Show progress/status in the action bar
  bossbar: false                    # Show progress/status in a BossBar
  chat: true                        # Also print clean, non-spam chat messages
  bossbar-color: GREEN              # GREEN, BLUE, RED, PURPLE, PINK, WHITE, YELLOW
  bossbar-style: SOLID              # SOLID, SEGMENTED_6, SEGMENTED_10, SEGMENTED_12, SEGMENTED_20

# ┌──────────────────────────────────────────────────────────────────────┐
# │ Default Sword (non-VIP profile)                                     │
# └──────────────────────────────────────────────────────────────────────┘
sword:
  give-on-join: true                # Give players the lobby sword on join
  slot: 2                           # Desired hotbar slot (0..8)
  material: IRON_SWORD              # Any valid Bukkit material
  display-name: "&aLobby Sword"
  lore:
    - ""
    - "&8-----------------------"
    - "&oHold to enable PvP"
    - "&oFun & safe duels in the lobby!"
    - "&8-----------------------"
  lock: true                        # Prevent moving/dropping plugin items (anti-dup)
  enchantments:
    - SHARPNESS:4
    - UNBREAKING:4

# ┌──────────────────────────────────────────────────────────────────────┐
# │ Default Armor (auto-equipped while PvP is ACTIVE)                   │
# └──────────────────────────────────────────────────────────────────────┘
armor:
  helmet:
    material: IRON_HELMET
    display-name: "&aLobby Helmet"
    lore: []
    enchantments: ["PROTECTION_ENVIRONMENTAL:3"]
  chestplate:
    material: IRON_CHESTPLATE
    display-name: "&aLobby Chestplate"
    lore: []
    enchantments: ["PROTECTION_ENVIRONMENTAL:3"]
  leggings:
    material: IRON_LEGGINGS
    display-name: "&aLobby Leggings"
    lore: []
    enchantments: ["PROTECTION_ENVIRONMENTAL:3"]
  boots:
    material: IRON_BOOTS
    display-name: "&aLobby Boots"
    lore: []
    enchantments: ["PROTECTION_FALL:4"]

# ┌──────────────────────────────────────────────────────────────────────┐
# │ VIP Profile (permission: lobby4pvp.vip)                             │
# └──────────────────────────────────────────────────────────────────────┘
vip:
  enabled: true
  permission: lobby4pvp.vip

  sword:
    enabled: true                   # If false, VIPs use the default sword profile
    slot: 2                         # Desired slot for VIP sword (can differ from non-VIP)
    material: DIAMOND_SWORD
    display-name: "&bVIP Lobby Sword"
    lore:
      - ""
      - "&8-----------------------"
      - "&oExclusive VIP sword"
      - "&oHold to enable PvP"
      - "&8-----------------------"
    enchantments:
      - SHARPNESS:5
      - UNBREAKING:3

  armor:
    helmet:
      material: DIAMOND_HELMET
      display-name: "&bVIP Helmet"
      lore: []
      enchantments: ["PROTECTION_ENVIRONMENTAL:4", "UNBREAKING:3"]
    chestplate:
      material: DIAMOND_CHESTPLATE
      display-name: "&bVIP Chestplate"
      lore: []
      enchantments: ["PROTECTION_ENVIRONMENTAL:4"]
    leggings:
      material: DIAMOND_LEGGINGS
      display-name: "&bVIP Leggings"
      lore: []
      enchantments: ["PROTECTION_ENVIRONMENTAL:4"]
    boots:
      material: DIAMOND_BOOTS
      display-name: "&bVIP Boots"
      lore: []
      enchantments: ["PROTECTION_FALL:4", "DEPTH_STRIDER:3"]

# ┌──────────────────────────────────────────────────────────────────────┐
# │ Item Flags                                                          │
# └──────────────────────────────────────────────────────────────────────┘
items:
  unbreakable: true                 # Make all plugin items unbreakable

# ┌──────────────────────────────────────────────────────────────────────┐
# │ Effects                                                             │
# └──────────────────────────────────────────────────────────────────────┘
fx:
  sound: ENTITY_PLAYER_LEVELUP      # Played when enabling PvP
  particle: CRIT_MAGIC              # Spawned around the player when enabling PvP
  disable-sound: ENTITY_ITEM_PICKUP # Played when disabling PvP
  disable-particle: CRIT            # Spawned around the player when disabling PvP

# ┌──────────────────────────────────────────────────────────────────────┐
# │ Kill Celebration                                                    │
# └──────────────────────────────────────────────────────────────────────┘
kill-firework:
  enabled: true
  power: 1                          # 1..4 (higher = higher flight)
# Safe-state recovery applied when PvP is manually disabled
safe-state:
  auto-heal:
    enabled: true
    health: 20.0                    # Clamped to the player's max health
  auto-feed:
    enabled: true
    food-level: 20                  # 0..20
    saturation: 0.0                 # 0.0..20.0

# ┌──────────────────────────────────────────────────────────────────────┐
# │ Messages (supports '&' colors and MiniMessage)                      │
# │ {seconds} is dynamically replaced                                   │
# └──────────────────────────────────────────────────────────────────────┘
messages:
  prefix: "&aLobby4PvP &8» "
  enable: "&a&lPvP mode enabled.&r &7Prepare for battle."
  disable: "&7PvP mode disabled. You are now safe."
  hold: "&7Hold your sword for &f{seconds}s &7to enable &aPvP mode&7."
  already-active: "&7PvP mode is already active."
  deactivate-progress: "&7PvP mode will disable in &f{seconds}s&7."
  deactivate-cancelled: "&7Deactivation cancelled."
  cooldown: "&7Wait &f{seconds}s &7before enabling &aPvP mode&7 again."
  world-pvp-disabled: "&cWorld PvP is globally disabled here. Lobby4PvP cannot enable combat in this world."

# ┌──────────────────────────────────────────────────────────────────────┐
# │ PlaceholderAPI formatting                                           │
# │ Optional visual wrappers for numeric stats (use {value})            │
# │ Supports legacy '&' colors and MiniMessage                          │
# └──────────────────────────────────────────────────────────────────────┘
placeholders:
  status:
    enabled: "&aenabled"
    disabled: "&cdisabled"
  vip:
    true: "&btrue"
    false: "&7false"
  stats:
    kills: "&6⚔ {value}"
    deaths: "&c✖ {value}"
    hits: "&e☄ {value}"
    kdr: "&aKDR: {value}"