⚔️ WoLobbyPvp – Complete Lobby Combat System

WoLobbyPvp is a lightweight and powerful tool for server owners that turns boring lobby wait times into exciting fun. The plugin allows players to dynamically enter PvP mode using a single item, without the risk of losing inventory or damaging the lobby.

🚀 How does it work? (Plugin Mechanics)

The plugin was designed with intuitiveness in mind. It requires no commands from the player:

1. Automatic Start: Upon joining the server, the player receives a sword in the slot specified in the configuration.

2. Smart Activation: Combat doesn't start immediately. Once the sword is selected, a configurable Warmup begins, displayed as an elegant Title in the center of the screen.

3. Combat Armor: With a single click (LMB), the player summons an armor set. The plugin intelligently saves the player's current outfit (e.g., skins or decorative armor) and restores it immediately after the fight ends.

4. Lobby Safety: PvP only works between players who have the mode active. People without the sword in hand are completely safe and cannot be attacked.

5. No Durability Loss: All items used within the plugin are indestructible (Infinite Durability).

⚙️ Configuration Guide (config.yml)

You can customize every element of the plugin to fit your needs:

# ==========================================
#          woLobbyPvp - Configuration
# ==========================================



# Waiting time (in seconds) from the moment the sword is held to full PvP activation.
# The code uses this value in the onSlotChange method to start the countdown.
warmup-seconds: 3



# The item the player will automatically receive upon joining the server.
# They must hold it in their hand to activate combat mode.
activator-item:
  # Hotbar slot (1-9) where the player will receive the sword.
  slot: 1
  # Item material (use names from Spigot documentation, e.g., DIAMOND_SWORD).
  material: WOODEN_SWORD
  # Display name (supports & colors). Checked in the isPvPItem method.
  name: "&c&lChallenge Sword"
  # Item lore - adds atmosphere and informs the player about the rules.
  lore:
    - "&7Status: &eLobby PvP"
    - ""
    - "&fHold this sword to fight!"
    - "&fClick &6LMB&f to equip armor."
    - ""
    - "&7Note: Putting the sword away disables PvP mode."



# The armor set that appears on the player after clicking the Left Mouse Button (LMB).
# These items are created dynamically by the createItem function in the code.
armor:
  helmet:
    material: IRON_HELMET
    name: "&cHelmet"
  chestplate:
    material: IRON_CHESTPLATE
    name: "&cChestplate"
  leggings:
    material: IRON_LEGGINGS
    name: "&cLeggings"
  boots:
    material: IRON_BOOTS
    name: "&cBoots"



# All text and messages displayed to the player while using the plugin.
messages:
  # Displayed as a Title and in chat when the countdown ends.
  pvp-enabled: "&a&lFIGHT! &7PvP mode has been activated."
  # Information shown after putting the sword away or leaving the server.
  pvp-disabled: "&c&lEND! &7PvP mode has been disabled."
  # Main Title text during the countdown.
  warmup-title: "&eGet ready..."
  # Title Subtitle - %seconds% is automatically replaced by the remaining time in the code.
  warmup-subtitle: "&7Combat starts in: &c%seconds%s"
  # Message after clicking LMB when the armor is equipped.
  armor-equipped: "&a&oYour armor has been equipped!"

🛠️ Technical Info and Permissions

The plugin is optimized and does not strain the server CPU.

Permissions:

• wolobbypvp.admin – Access to the /wolobbypvp reload command (reloads configuration without restarting the server).

Technical Details:

• Versions: Supports versions 1.18.2 and up (thanks to the implemented VersionManager).

• Security: Uses advanced UUID mapping to store saved armor, preventing errors even if a player abruptly leaves the server.

• Restrictions: The plugin automatically blocks dropping PvP items (DropItem) and manually removing armor from armor slots.

❓ FAQ - Frequently Asked Questions

• Do players lose their items upon death? No. The plugin blocks item drops and automatically respawns the player with their original inventory restored.

• Can I change the sword slot? Yes, in the activator-item.slot section of the config, you can set any slot from 1 to 9.

• Does the plugin conflict with other lobby plugins? The plugin works independently. If another plugin grants effects on join, WoLobbyPvp will simply add its items to the designated slots.

🆘 Support and Help

Having trouble with configuration? Found a bug?

• Discord: wojteko

• Bugs: Please report via private message on SpigotMC. Do not use the review section for bug reports!

Project Author: wojteko