# ENG
\n# \u2694\ufe0f WoLobbyPvp \u2013 Complete Lobby Combat System<\/p>\n
WoLobbyPvp\u00a0is 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.<\/p>\n
## \ud83d\ude80 How does it work? (Plugin Mechanics)<\/p>\n
The plugin was designed with intuitiveness in mind. It requires no commands from the player:<\/p>\n
Automatic Start:\u00a0Upon joining the server, the player receives a sword in the slot specified in the configuration.<\/p>\n
Smart Activation:\u00a0Combat doesn’t start immediately. Once the sword is selected, a configurable\u00a0Warmup\u00a0begins, displayed as an elegant\u00a0Title\u00a0in the center of the screen.<\/p>\n
Combat Armor:\u00a0With 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.<\/p>\n
Lobby Safety:\u00a0PvP only works between players who have the mode active. People without the sword in hand are completely safe and cannot be attacked.<\/p>\n
No Durability Loss:\u00a0All items used within the plugin are indestructible (Infinite Durability).<\/p>\n
## \u2699\ufe0f Configuration Guide (config.yml)<\/p>\n
You can customize every element of the plugin to fit your needs:<\/p>\n
YAML
\n“`
\n# ==========================================
\n# \u00a0 \u00a0 \u00a0 \u00a0 \u00a0woLobbyPvp – Configuration
\n# ==========================================<\/p>\n
# Waiting time (in seconds) from the moment the sword is held to full PvP activation.
\n# The code uses this value in the onSlotChange method to start the countdown.
\nwarmup-seconds: 3<\/p>\n
# The item the player will automatically receive upon joining the server.
\n# They must hold it in their hand to activate combat mode.
\nactivator-item:
\n\u00a0 # Hotbar slot (1-9) where the player will receive the sword.
\n\u00a0 slot: 1
\n\u00a0 # Item material (use names from Spigot documentation, e.g., DIAMOND_SWORD).
\n\u00a0 material: WOODEN_SWORD
\n\u00a0 # Display name (supports & colors). Checked in the isPvPItem method.
\n\u00a0 name: “&c&lChallenge Sword”
\n\u00a0 # Item lore – adds atmosphere and informs the player about the rules.
\n\u00a0 lore:
\n\u00a0 \u00a0 – “&7Status: &eLobby PvP”
\n\u00a0 \u00a0 – “”
\n\u00a0 \u00a0 – “&fHold this sword to fight!”
\n\u00a0 \u00a0 – “&fClick &6LMB&f to equip armor.”
\n\u00a0 \u00a0 – “”
\n\u00a0 \u00a0 – “&7Note: Putting the sword away disables PvP mode.”<\/p>\n
# The armor set that appears on the player after clicking the Left Mouse Button (LMB).
\n# These items are created dynamically by the createItem function in the code.
\narmor:
\n\u00a0 helmet:
\n\u00a0 \u00a0 material: IRON_HELMET
\n\u00a0 \u00a0 name: “&cHelmet”
\n\u00a0 chestplate:
\n\u00a0 \u00a0 material: IRON_CHESTPLATE
\n\u00a0 \u00a0 name: “&cChestplate”
\n\u00a0 leggings:
\n\u00a0 \u00a0 material: IRON_LEGGINGS
\n\u00a0 \u00a0 name: “&cLeggings”
\n\u00a0 boots:
\n\u00a0 \u00a0 material: IRON_BOOTS
\n\u00a0 \u00a0 name: “&cBoots”<\/p>\n
# All text and messages displayed to the player while using the plugin.
\nmessages:
\n\u00a0 # Displayed as a Title and in chat when the countdown ends.
\n\u00a0 pvp-enabled: “&a&lFIGHT! &7PvP mode has been activated.”
\n\u00a0 # Information shown after putting the sword away or leaving the server.
\n\u00a0 pvp-disabled: “&c&lEND! &7PvP mode has been disabled.”
\n\u00a0 # Main Title text during the countdown.
\n\u00a0 warmup-title: “&eGet ready…”
\n\u00a0 # Title Subtitle – %seconds% is automatically replaced by the remaining time in the code.
\n\u00a0 warmup-subtitle: “&7Combat starts in: &c%seconds%s”
\n\u00a0 # Message after clicking LMB when the armor is equipped.
\n\u00a0 armor-equipped: “&a&oYour armor has been equipped!”<\/p>\n
“`<\/p>\n
## \ud83d\udee0\ufe0f Technical Info and Permissions<\/p>\n
The plugin is optimized and does not strain the server CPU.<\/p>\n
Permissions:<\/p>\n
wolobbypvp.admin\u00a0\u2013 Access to the\u00a0\/wolobbypvp reload\u00a0command (reloads configuration without restarting the server).<\/p>\n
Technical Details:<\/p>\n
Versions:\u00a0Supports versions 1.18.2 and up (thanks to the implemented VersionManager).<\/p>\n
Security:\u00a0Uses advanced UUID mapping to store saved armor, preventing errors even if a player abruptly leaves the server.<\/p>\n
Restrictions:\u00a0The plugin automatically blocks dropping PvP items (DropItem) and manually removing armor from armor slots.<\/p>\n
## \u2753 FAQ – Frequently Asked Questions<\/p>\n
Do players lose their items upon death?\u00a0No. The plugin blocks item drops and automatically respawns the player with their original inventory restored.<\/p>\n
Can I change the sword slot?\u00a0Yes, in the\u00a0activator-item.slot\u00a0section of the config, you can set any slot from 1 to 9.<\/p>\n
Does the plugin conflict with other lobby plugins?\u00a0The plugin works independently. If another plugin grants effects on join, WoLobbyPvp will simply add its items to the designated slots.<\/p>\n
### \ud83c\udd98 Support and Help<\/p>\n
Having trouble with configuration? Found a bug?<\/p>\n
Discord:\u00a0wojteko<\/p>\n
Bugs:\u00a0Please report via private message on Discord. Do not use the review section for bug reports!<\/p>\n
Project Author: wojteko<\/p>\n
# PL
\n# \u2694\ufe0f WoLobbyPvp \u2013 Kompletny System Walki w Lobby<\/p>\n
WoLobbyPvp to lekkie i pot\u0119\u017cne narz\u0119dzie dla w\u0142a\u015bcicieli serwer\u00f3w, kt\u00f3re zamienia nudne oczekiwanie w lobby w ekscytuj\u0105c\u0105 zabaw\u0119. Plugin pozwala graczom na dynamiczne przechodzenie w tryb PvP za pomoc\u0105 jednego przedmiotu, bez ryzyka utraty ekwipunku czy niszczenia lobby.<\/p>\n
### \ud83d\ude80 Jak to dzia\u0142a? (Mechanika Pluginu)<\/p>\n
Plugin zosta\u0142 zaprojektowany z my\u015bl\u0105 o intuicyjno\u015bci. Nie wymaga od gracza wpisywania \u017cadnych komend:<\/p>\n
Automatyczny Start: Gracz po wej\u015bciu na serwer otrzymuje miecz na okre\u015blonym w konfiguracji slocie.<\/p>\n
Inteligentna Aktywacja: Walka nie zaczyna si\u0119 od razu. Po wybraniu miecza nast\u0119puje konfigurowalne odliczanie (Warmup), wy\u015bwietlane jako elegancki Title na \u015brodku ekranu.<\/p>\n
Zbroja Bojowa: Jednym klikni\u0119ciem (LPM) gracz przywo\u0142uje zestaw zbroi. Plugin inteligentnie zapisuje obecne ubranie gracza (np. skiny lub zbroje ozdobne) i przywraca je natychmiast po zako\u0144czeniu walki.<\/p>\n
Bezpiecze\u0144stwo Lobby: PvP dzia\u0142a tylko mi\u0119dzy graczami, kt\u00f3rzy maj\u0105 aktywny tryb. Osoby bez miecza w r\u0119ku s\u0105 ca\u0142kowicie bezpieczne i nie mog\u0105 by\u0107 atakowane.<\/p>\n
Brak Zu\u017cycia: Wszystkie przedmioty u\u017cywane w ramach pluginu s\u0105 niezniszczalne (Infinite Durability).<\/p>\n
### \u2699\ufe0f Przewodnik po Konfiguracji (config.yml)<\/p>\n
Ka\u017cdy element pluginu mo\u017cesz dostosowa\u0107 do w\u0142asnych potrzeb:<\/p>\n
YAML
\n“`
\n# ==========================================<\/p>\n
# \u00a0 \u00a0 \u00a0 \u00a0woLobbyPvp – Konfiguracja<\/p>\n
# ==========================================<\/p>\n
# Czas oczekiwania (w sekundach) od momentu wzi\u0119cia miecza do r\u0119ki do pe\u0142nej aktywacji PvP.<\/p>\n
# Kod u\u017cywa tej warto\u015bci w metodzie onSlotChange do uruchomienia odliczania.<\/p>\n
warmup-seconds: 3<\/p>\n
# Przedmiot, kt\u00f3ry gracz otrzyma automatycznie po wej\u015bciu na serwer.<\/p>\n
# Musi trzyma\u0107 go w r\u0119ce, aby aktywowa\u0107 tryb walki.<\/p>\n
activator-item:<\/p>\n
\u00a0 # Slot w pasku szybkiego wyboru (1-9), na kt\u00f3ry gracz otrzyma miecz.<\/p>\n
\u00a0 slot: 1<\/p>\n
\u00a0 # Materia\u0142 przedmiotu (u\u017cywaj nazw z dokumentacji Spigota, np. DIAMOND_SWORD).<\/p>\n
\u00a0 material: WOODEN_SWORD<\/p>\n
\u00a0 # Nazwa wy\u015bwietlana (obs\u0142uguje kolory &). Sprawdzana w metodzie isPvPItem.<\/p>\n
\u00a0 name: “&c&lMiecz Wyzwania”<\/p>\n
\u00a0 # Opis przedmiotu – dodaje klimatu i informuje gracza o zasadach.<\/p>\n
\u00a0 lore:<\/p>\n
\u00a0 \u00a0 – “&7Status: &eLobby PvP”<\/p>\n
\u00a0 \u00a0 – “”<\/p>\n
\u00a0 \u00a0 – “&fTrzymaj ten miecz, aby walczy\u0107!”<\/p>\n
\u00a0 \u00a0 – “&fKliknij &6LPM&f, aby ubra\u0107 zbroj\u0119.”<\/p>\n
\u00a0 \u00a0 – “”<\/p>\n
\u00a0 \u00a0 – “&7Uwaga: Schowanie miecza wy\u0142\u0105cza tryb PvP.”<\/p>\n
# Zestaw zbroi, kt\u00f3ry pojawia si\u0119 na graczu po klikni\u0119ciu Lewym Przyciskiem Myszy (LPM).<\/p>\n
# Przedmioty te s\u0105 tworzone dynamicznie przez funkcj\u0119 createItem w kodzie.<\/p>\n
armor:<\/p>\n
\u00a0 helmet:<\/p>\n
\u00a0 \u00a0 material: IRON_HELMET<\/p>\n
\u00a0 \u00a0 name: “&cHe\u0142m”<\/p>\n
\u00a0 chestplate:<\/p>\n
\u00a0 \u00a0 material: IRON_CHESTPLATE<\/p>\n
\u00a0 \u00a0 name: “&cKlata”<\/p>\n
\u00a0 leggings:<\/p>\n
\u00a0 \u00a0 material: IRON_LEGGINGS<\/p>\n
\u00a0 \u00a0 name: “&cSpodnie”<\/p>\n
\u00a0 boots:<\/p>\n
\u00a0 \u00a0 material: IRON_BOOTS<\/p>\n
\u00a0 \u00a0 name: “&cButy”<\/p>\n
# Wszystkie napisy i komunikaty, kt\u00f3re widzi gracz podczas korzystania z pluginu.<\/p>\n
messages:<\/p>\n
\u00a0 # Wy\u015bwietlane jako Title i na czacie w momencie zako\u0144czenia odliczania.<\/p>\n
\u00a0 pvp-enabled: “&a&lWALKA! &7Tryb PvP zosta\u0142 aktywowany.”<\/p>\n
\u00a0 # Informacja po schowaniu miecza lub wyj\u015bciu z serwera.<\/p>\n
\u00a0 pvp-disabled: “&c&lKONIEC! &7Tryb PvP zosta\u0142 wy\u0142\u0105czony.”<\/p>\n
\u00a0 # G\u0142\u00f3wny napis Title podczas odliczania.<\/p>\n
\u00a0 warmup-title: “&ePrzygotuj si\u0119…”<\/p>\n
\u00a0 # Podnapis Title – %seconds% jest automatycznie zamieniane na czas pozosta\u0142y w kodzie.<\/p>\n
\u00a0 warmup-subtitle: “&7Walka zacznie si\u0119 za: &c%seconds%s”<\/p>\n
\u00a0 # Komunikat po klikni\u0119ciu LPM, gdy zbroja wskoczy na swoje miejsce.<\/p>\n
\u00a0 armor-equipped: “&a&oTwoja zbroja zosta\u0142a za\u0142o\u017cona!”
\n“`<\/p>\n
### \ud83d\udee0\ufe0f Informacje Techniczne i Uprawnienia<\/p>\n
Plugin jest zoptymalizowany i nie obci\u0105\u017ca procesora serwera.<\/p>\n
Uprawnienia (Permissions):<\/p>\n
wolobbypvp.admin \u2013 Dost\u0119p do komendy \/wolobbypvp reload (prze\u0142adowanie konfiguracji bez restartu serwera).<\/p>\n
Szczeg\u00f3\u0142y techniczne:<\/p>\n
Wersje: Wspiera wersje od 1.18.2 wzwy\u017c (dzi\u0119ki zaimplementowanemu VersionManager).<\/p>\n
Bezpiecze\u0144stwo: Wykorzystuje zaawansowane mapowanie UUID do przechowywania zapisanych pancerzy, co zapobiega b\u0142\u0119dom nawet przy nag\u0142ym wyj\u015bciu gracza z serwera.<\/p>\n
Blokady: Plugin automatycznie blokuje wyrzucanie przedmiot\u00f3w PvP (DropItem) oraz r\u0119czne zdejmowanie zbroi z slot\u00f3w pancerza.<\/p>\n
### \u2753 FAQ – Najcz\u0119\u015bciej Zadawane Pytania<\/p>\n
Czy gracze trac\u0105 swoje itemy po \u015bmierci? Nie. Plugin blokuje wypadanie przedmiot\u00f3w (Drop) i automatycznie respawnuje gracza z przywr\u00f3conym ekwipunkiem podstawowym.<\/p>\n
Czy mog\u0119 zmieni\u0107 slot miecza? Tak, w sekcji activator-item.slot w configu mo\u017cesz ustawi\u0107 dowolne miejsce od 1 do 9.<\/p>\n
Czy plugin koliduje z innymi pluginami na lobby? Plugin dzia\u0142a niezale\u017cnie. Je\u015bli inny plugin nadaje efekty przy wej\u015bciu, WoLobbyPvp po prostu doda swoje przedmioty na wskazane sloty.<\/p>\n
## \ud83c\udd98 Wsparcie i Pomoc<\/p>\n
Masz problem z konfiguracj\u0105? Znalaz\u0142e\u015b b\u0142\u0105d?<\/p>\n
Discord: wojteko<\/p>\n
B\u0142\u0119dy: Prosz\u0119 zg\u0142asza\u0107 poprzez wiadomo\u015b\u0107 prywatn\u0105 na Discord. Nie u\u017cywaj sekcji recenzji do zg\u0142aszania b\u0142\u0119d\u00f3w!<\/p>\n
Autor projektu: wojteko<\/p>\n","protected":false},"excerpt":{"rendered":"
A seamless lobby PvP system featuring timed sword activation, automatic armor equipping, and unbreakable gear for the ultimate arena experience.<\/p>\n","protected":false},"featured_media":171039,"template":"","meta":{"_minecraft_slug":"wolobbypvp","_minecraft_project_id":"rOBVrmes","_minecraft_author":"wojteko","_minecraft_license":"MIT","_minecraft_downloads":19,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"wolobbypvp.zip","_minecraft_size_bytes":32453,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T22:40:18.140782Z","_minecraft_date_created":"2026-03-04T20:41:11.120898Z","_minecraft_date_modified":"2026-02-26T21:27:50.431719Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/wolobbypvp","_minecraft_icon_attachment_id":171039,"_minecraft_imported_at":"2026-06-09T21:11:06+00:00","_minecraft_import_hash":"9e4d94dadbca8ac8beb11f86f508ab2b","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,156,88,89,866,127,128,129],"mod_loader":[130,132,133,134],"minecraft_version":[51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82,83,167,163],"class_list":["post-171038","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-decoration","mod_category-equipment","mod_category-game-mechanics","mod_category-minigame","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_loader-bukkit","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n