⚔️ Lobby4PvP — Interactive Lobby PvP System

A modern and lightweight PvP system designed for hubs and lobbies.
Lobby4PvP lets players enable PvP simply by holding a sword — no commands, no menus, just pure interaction.

When the sword is held, players automatically enter PvP mode and receive configurable armor, sounds, and effects.
Once released, PvP disables safely after a short delay, returning the player to lobby mode.
Everything is handled cleanly, with no duplication issues, plugin conflicts, or item loss.

---

✨ Main Features

• Interactive activation: Enable PvP instantly by holding your sword.
• VIP profiles: Custom weapons and armor for VIP players.
• Anti-duplication: Fully protected against exploits and ghost items.
• Visual feedback: ActionBar, BossBar, and chat notifications perfectly synced.
• Persistent stats: Kills, deaths, hits, and KDR stored safely in stats.yml.
• Config reload: /lobby4pvp reload refreshes all settings live — safely.
• Conflict override: Works seamlessly with WorldGuard, Essentials, PvPManager, and CombatLogX.
• PlaceholderAPI support: Full integration for scoreboards and tablists.
• bStats metrics: Anonymous statistics (ID 27655).

---

🔌 PlaceholderAPI Integration

Lobby4PvP includes full support for PlaceholderAPI, allowing you to display player PvP data anywhere — in scoreboards, holograms, menus, or tablists.
All placeholders are automatically registered when the plugin detects PlaceholderAPI at startup.

Available Placeholders

Placeholder	Description
%lobby4pvp_status%	Shows whether the player currently has PvP mode enabled or disabled.
%lobby4pvp_cooldown%	Displays the remaining cooldown time before PvP can be re-enabled.
%lobby4pvp_kills%	Shows the player’s total kills in the lobby.
%lobby4pvp_deaths%	Shows the player’s total deaths in the lobby.
%lobby4pvp_hits%	Displays how many successful hits the player has landed.
%lobby4pvp_kdr%	Displays the player’s kill/death ratio (KDR).
%lobby4pvp_vip%	Returns true or false depending on VIP status.
%lobby4pvp_version%	Displays the current Lobby4PvP plugin version.

Example usage

If your scoreboard or hologram plugin supports PlaceholderAPI (such as TAB, AjLeaderboards, DecentHolograms, etc.), you can directly use these placeholders.

---

⚙️ Commands & Permissions

Command	Description	Permission
/lobby4pvp	Display plugin info	lobby4pvp.info
/lobby4pvp reload	Reload the configuration	lobby4pvp.reload
(VIP gear)	Access VIP sword and armor	lobby4pvp.vip

---

💻 Compatibility & Config

config.yml

# ╔══════════════════════════════════════════════════════════════════════╗
# ║                         Lobby4PvP — v1.6.7                          ║
# ║  Enable PvP in your lobby by holding a sword. Safe, robust, fast.   ║
# ╚══════════════════════════════════════════════════════════════════════╝
#
#  QUICK HELP:
#  • Reload everything live: /lobby4pvp reload
#  • Colors use '&' (e.g. &a, &7, &c)
#  • Hotbar slots are 0..8 (0 = far left, 8 = far right)
#  • Java 21; Paper/Spigot 1.20.6–1.21+
#
#  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.

# ┌──────────────────────────────────────────────────────────────────────┐
# │ 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: true                     # 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

# ┌──────────────────────────────────────────────────────────────────────┐
# │ Kill Celebration                                                    │
# └──────────────────────────────────────────────────────────────────────┘
kill-firework:
  enabled: true
  power: 2                          # 1..4 (higher = higher flight)

# ┌──────────────────────────────────────────────────────────────────────┐
# │ Messages (supports '&' colors)                                      │
# │ {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."

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

• Minecraft: 1.20.6 → 1.21+
• Java: 21
• Supported Loaders: Paper, Spigot, Purpur, Folia, Bukkit (partial)

---

❤️ Designed for performance

Lobby4PvP was built to deliver a clean, lag-free lobby PvP experience.
It runs efficiently on modern Paper servers, automatically detects PvP conflicts, and adapts smoothly to configuration changes.

Simple to install, safe to use, and ready for your next network. ⚔️