WoLobbyPvp
# ENG
# ⚔️ 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:
Automatic Start: Upon joining the server, the player receives a sword in the slot specified in the configuration.
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.
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.
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.
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:
YAML
“`
# ==========================================
# 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 Discord. Do not use the review section for bug reports!
Project Author: wojteko
# PL
# ⚔️ WoLobbyPvp – Kompletny System Walki w Lobby
WoLobbyPvp to lekkie i potężne narzędzie dla właścicieli serwerów, które zamienia nudne oczekiwanie w lobby w ekscytującą zabawę. Plugin pozwala graczom na dynamiczne przechodzenie w tryb PvP za pomocą jednego przedmiotu, bez ryzyka utraty ekwipunku czy niszczenia lobby.
### 🚀 Jak to działa? (Mechanika Pluginu)
Plugin został zaprojektowany z myślą o intuicyjności. Nie wymaga od gracza wpisywania żadnych komend:
Automatyczny Start: Gracz po wejściu na serwer otrzymuje miecz na określonym w konfiguracji slocie.
Inteligentna Aktywacja: Walka nie zaczyna się od razu. Po wybraniu miecza następuje konfigurowalne odliczanie (Warmup), wyświetlane jako elegancki Title na środku ekranu.
Zbroja Bojowa: Jednym kliknięciem (LPM) gracz przywołuje zestaw zbroi. Plugin inteligentnie zapisuje obecne ubranie gracza (np. skiny lub zbroje ozdobne) i przywraca je natychmiast po zakończeniu walki.
Bezpieczeństwo Lobby: PvP działa tylko między graczami, którzy mają aktywny tryb. Osoby bez miecza w ręku są całkowicie bezpieczne i nie mogą być atakowane.
Brak Zużycia: Wszystkie przedmioty używane w ramach pluginu są niezniszczalne (Infinite Durability).
### ⚙️ Przewodnik po Konfiguracji (config.yml)
Każdy element pluginu możesz dostosować do własnych potrzeb:
YAML
“`
# ==========================================
# woLobbyPvp – Konfiguracja
# ==========================================
# Czas oczekiwania (w sekundach) od momentu wzięcia miecza do ręki do pełnej aktywacji PvP.
# Kod używa tej wartości w metodzie onSlotChange do uruchomienia odliczania.
warmup-seconds: 3
# Przedmiot, który gracz otrzyma automatycznie po wejściu na serwer.
# Musi trzymać go w ręce, aby aktywować tryb walki.
activator-item:
# Slot w pasku szybkiego wyboru (1-9), na który gracz otrzyma miecz.
slot: 1
# Materiał przedmiotu (używaj nazw z dokumentacji Spigota, np. DIAMOND_SWORD).
material: WOODEN_SWORD
# Nazwa wyświetlana (obsługuje kolory &). Sprawdzana w metodzie isPvPItem.
name: “&c&lMiecz Wyzwania”
# Opis przedmiotu – dodaje klimatu i informuje gracza o zasadach.
lore:
– “&7Status: &eLobby PvP”
– “”
– “&fTrzymaj ten miecz, aby walczyć!”
– “&fKliknij &6LPM&f, aby ubrać zbroję.”
– “”
– “&7Uwaga: Schowanie miecza wyłącza tryb PvP.”
# Zestaw zbroi, który pojawia się na graczu po kliknięciu Lewym Przyciskiem Myszy (LPM).
# Przedmioty te są tworzone dynamicznie przez funkcję createItem w kodzie.
armor:
helmet:
material: IRON_HELMET
name: “&cHełm”
chestplate:
material: IRON_CHESTPLATE
name: “&cKlata”
leggings:
material: IRON_LEGGINGS
name: “&cSpodnie”
boots:
material: IRON_BOOTS
name: “&cButy”
# Wszystkie napisy i komunikaty, które widzi gracz podczas korzystania z pluginu.
messages:
# Wyświetlane jako Title i na czacie w momencie zakończenia odliczania.
pvp-enabled: “&a&lWALKA! &7Tryb PvP został aktywowany.”
# Informacja po schowaniu miecza lub wyjściu z serwera.
pvp-disabled: “&c&lKONIEC! &7Tryb PvP został wyłączony.”
# Główny napis Title podczas odliczania.
warmup-title: “&ePrzygotuj się…”
# Podnapis Title – %seconds% jest automatycznie zamieniane na czas pozostały w kodzie.
warmup-subtitle: “&7Walka zacznie się za: &c%seconds%s”
# Komunikat po kliknięciu LPM, gdy zbroja wskoczy na swoje miejsce.
armor-equipped: “&a&oTwoja zbroja została założona!”
“`
### 🛠️ Informacje Techniczne i Uprawnienia
Plugin jest zoptymalizowany i nie obciąża procesora serwera.
Uprawnienia (Permissions):
wolobbypvp.admin – Dostęp do komendy /wolobbypvp reload (przeładowanie konfiguracji bez restartu serwera).
Szczegóły techniczne:
Wersje: Wspiera wersje od 1.18.2 wzwyż (dzięki zaimplementowanemu VersionManager).
Bezpieczeństwo: Wykorzystuje zaawansowane mapowanie UUID do przechowywania zapisanych pancerzy, co zapobiega błędom nawet przy nagłym wyjściu gracza z serwera.
Blokady: Plugin automatycznie blokuje wyrzucanie przedmiotów PvP (DropItem) oraz ręczne zdejmowanie zbroi z slotów pancerza.
### ❓ FAQ – Najczęściej Zadawane Pytania
Czy gracze tracą swoje itemy po śmierci? Nie. Plugin blokuje wypadanie przedmiotów (Drop) i automatycznie respawnuje gracza z przywróconym ekwipunkiem podstawowym.
Czy mogę zmienić slot miecza? Tak, w sekcji activator-item.slot w configu możesz ustawić dowolne miejsce od 1 do 9.
Czy plugin koliduje z innymi pluginami na lobby? Plugin działa niezależnie. Jeśli inny plugin nadaje efekty przy wejściu, WoLobbyPvp po prostu doda swoje przedmioty na wskazane sloty.
## 🆘 Wsparcie i Pomoc
Masz problem z konfiguracją? Znalazłeś błąd?
Discord: [wojteko](https://discordapp.com/users/788117068829425715)
Błędy: Proszę zgłaszać poprzez wiadomość prywatną na Discord. Nie używaj sekcji recenzji do zgłaszania błędów!
Autor projektu: wojteko
