Lobby4PvP

# ⚔️ 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 <details> <summary>config.yml</summary> <br> <pre><code> # ╔══════════════════════════════════════════════════════════════════════╗ # ║ 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 bloc

# ╔══════════════════════════════════════════════════════════════════════╗
# ║ 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 bloc