英文
⚔️ WoLobbyPvp – 完整的大厅战斗系统
WoLobbyPvp 是一款轻量且强大的工具,专为服务器所有者设计,能将无聊的大厅等待时间转化为令人兴奋的乐趣。该插件允许玩家通过单一物品动态进入 PvP 模式,无需担心丢失物品栏或破坏大厅环境。
? 工作原理(插件机制)
插件的设计注重直观易用性,玩家无需输入任何命令:
自动开始:玩家加入服务器时,会在配置指定的槽位中获得一把剑。
智能激活:战斗不会立即开始。选中剑后,会启动一个可配置的预备时间(Warmup),并以优雅的标题(Title)形式显示在屏幕中央。
战斗护甲:只需单击一次(左键鼠标,LMB),玩家即可召唤一套护甲。插件会智能保存玩家当前的装备(例如皮肤或装饰性护甲),并在战斗结束后立即恢复。
大厅安全:PvP 仅在拥有激活模式的玩家之间生效。手中没有剑的玩家完全安全,无法被攻击。
无耐久损耗:插件内使用的所有物品均为不可摧毁状态(无限耐久)。
⚙️ 配置指南 (config.yml)
您可以自定义插件的每个元素以符合您的需求:
YAML
# ==========================================
# woLobbyPvp - Configuration
# ==========================================
# 从持有剑到完全激活 PvP 模式的等待时间(秒)。
# 代码在 onSlotChange 方法中使用此值来启动倒计时。
warmup-seconds: 3
# 玩家加入服务器时自动获得的物品。
# 他们必须手持此物品才能激活战斗模式。
activator-item:
# 玩家获得剑的热键槽位(1-9)。
slot: 1
# 物品材质(使用 Spigot 文档中的名称,例如 DIAMOND_SWORD)。
material: WOODEN_SWORD
# 显示名称(支持 & 颜色代码)。在 isPvPItem 方法中检查。
name: "&c&l挑战之剑"
# 物品描述 - 增加氛围并告知玩家规则。
lore:
- "&7状态: &e大厅 PvP"
- ""
- "&f手持此剑进行战斗!"
- "&f点击 &6左键(LMB)&f 装备护甲。"
- ""
- "&7注意:收起剑将禁用 PvP 模式。"
# 玩家在单击左键鼠标按钮 (LMB) 后出现的护甲套装。
# 这些物品由代码中的 createItem 函数动态创建。
armor:
helmet:
material: IRON_HELMET
name: "&c头盔"
chestplate:
material: IRON_CHESTPLATE
name: "&c胸甲"
leggings:
material: IRON_LEGGINGS
name: "&c护腿"
boots:
material: IRON_BOOTS
name: "&c靴子"
# 使用插件期间向玩家显示的所有文本和消息。
messages:
# 倒计时结束时作为标题显示并在聊天中显示。
pvp-enabled: "&a&l战斗! &7PvP 模式已激活。"
# 收起剑或离开服务器后显示的信息。
pvp-disabled: "&c&l结束! &7PvP 模式已禁用。"
# 倒计时期间的主标题文本。
warmup-title: "&e准备就绪..."
# 标题副标题 - %seconds% 会在代码中自动替换为剩余时间。
warmup-subtitle: "&7战斗开始于: &c%seconds%s"
# 装备护甲后单击左键时的消息。
armor-equipped: "&a&o您的护甲已装备!"
?️ 技术信息与权限
插件经过优化,不会占用服务器 CPU 资源。
权限:
wolobbypvp.admin – 访问 /wolobbypvp reload 命令的权限(重新加载配置而无需重启服务器)。
技术细节:
版本:支持 1.18.2 及以上版本(得益于实现的 VersionManager)。
安全性:使用高级 UUID 映射来存储保存的护甲,即使玩家突然离开服务器也不会出错。
限制:插件会自动阻止丢弃 PvP 物品(DropItem)和手动从护甲槽位移除护甲。
❓ 常见问题解答 (FAQ)
玩家死亡时会丢失物品吗?不会。插件会阻止物品掉落,并让玩家重生时自动恢复原始物品栏。
我可以更改剑的槽位吗?可以,在 config 的 activator-item.slot 部分,您可以设置 1 到 9 之间的任意槽位。
插件是否与其他大厅插件冲突?插件独立工作。如果其他插件在加入时赋予效果,WoLobbyPvp 只会将物品添加到指定槽位。
? 支持与帮助
配置遇到困难?发现了 Bug?
Discord:wojteko
Bug 报告:请通过 Discord 私讯报告。请勿在评论板块提交 Bug 报告!
项目作者:wojteko
波兰语
⚔️ WoLobbyPvp – 完整的大厅战斗系统
WoLobbyPvp 是一款轻量且强大的工具,专为服务器所有者设计,能将无聊的大厅等待时间转化为令人兴奋的乐趣。该插件允许玩家通过单一物品动态进入 PvP 模式,无需担心丢失物品栏或破坏大厅环境。
? 工作原理(插件机制)
插件的设计注重直观易用性,玩家无需输入任何命令:
自动开始:玩家加入服务器时,会在配置指定的槽位中获得一把剑。
智能激活:战斗不会立即开始。选中剑后,会启动一个可配置的预备时间(Warmup),并以优雅的标题(Title)形式显示在屏幕中央。
战斗护甲:只需单击一次(左键鼠标,LPM),玩家即可召唤一套护甲。插件会智能保存玩家当前的装备(例如皮肤或装饰性护甲),并在战斗结束后立即恢复。
大厅安全:PvP 仅在拥有激活模式的玩家之间生效。手中没有剑的玩家完全安全,无法被攻击。
无消耗:插件内使用的所有物品均为不可摧毁状态(无限耐久)。
⚙️ 配置指南 (config.yml)
你可以自定义插件的每一个元素以满足你的需求:
YAML
# ==========================================
# woLobbyPvp - 配置
# ==========================================
# 从拔出剑到 PvP 完全激活所需的等待时间(秒)。
# 代码在 onSlotChange 方法中使用此值来启动倒计时。
warmup-seconds: 3
# 玩家进入服务器后自动获得的物品。
# 必须手持该物品以激活战斗模式。
activator-item:
# 快捷栏槽位 (1-9),玩家将在该槽位获得剑。
slot: 1
# 物品材质(使用 Spigot 文档中的名称,例如 DIAMOND_SWORD)。
material: WOODEN_SWORD
# 显示名称(支持颜色代码 &)。在 isPvPItem 方法中进行检查。
name: "&c&l挑战之剑"
# 物品描述 - 增加氛围并告知玩家规则。
lore:
- "&7状态: &e大厅 PvP"
- ""
- "&f手持此剑即可战斗!"
- "&f点击 &6左键&f穿戴盔甲。"
- ""
- "&7注意:收起剑将禁用 PvP 模式。"
# 点击鼠标左键 (LPM) 后出现在玩家身上的盔甲套装。
# 这些物品由代码中的 createItem 函数动态创建。
armor:
helmet:
material: IRON_HELMET
name: "&c头盔"
chestplate:
material: IRON_CHESTPLATE
name: "&c胸甲"
leggings:
material: IRON_LEGGINGS
name: "&c护腿"
boots:
material: IRON_BOOTS
name: "&c靴子"
# 玩家在插件使用过程中看到的所有文本和消息。
messages:
# 倒计时结束时作为 Title 显示并在聊天中发送。
pvp-enabled: "&a&l战斗开始! &7PVP 模式已激活。"
# 收起剑或退出服务器后的信息。
pvp-disabled: "&c&l结束! &7PVP 模式已关闭。"
# 倒计时期间的主要 Title 文本。
warmup-title: "&e准备..."
# Title 副标题 - %seconds% 会在代码中自动替换为剩余时间。
warmup-subtitle: "&7战斗将在以下时间开始: &c%seconds%s"
# 点击左键且盔甲装备到位后的消息。
armor-equipped: "&a&o你的盔甲已穿戴完毕!"
?️ 技术信息和权限
插件经过优化,不会占用大量服务器 CPU 资源。
权限 (Permissions):
wolobbypvp.admin – 访问命令 /wolobbypvp reload(无需重启服务器即可重载配置)。
技术细节:
版本:支持 1.18.2 及以上版本(得益于实现的 VersionManager)。
安全性:使用高级 UUID 映射来存储保存的盔甲,即使玩家突然离开服务器也能防止错误。
限制:插件会自动阻止丢弃 PvP 物品 (DropItem) 以及手动从盔甲槽位卸下盔甲。
❓ FAQ - 常见问题解答
玩家死亡后会丢失物品吗?不会。插件会阻止物品掉落 (Drop) 并在重生时自动恢复基础装备。
我可以更改剑的槽位吗?可以,在配置的 activator-item.slot 部分,你可以设置 1 到 9 之间的任意位置。
插件会与大厅上的其他插件冲突吗?插件独立运行。如果其他插件在进入时赋予效果,WoLobbyPvp 只会将物品添加到指定的槽位。
? 支持与帮助
遇到配置问题?发现了 bug?
Discord: wojteko
Bug 报告:请通过 Discord 私信报告。请勿在评论部分报告 bug!
项目作者:wojteko
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
Błędy: Proszę zgłaszać poprzez wiadomość prywatną na Discord. Nie używaj sekcji recenzji do zgłaszania błędów!
Autor projektu: wojteko
评论 0
登录后参与评分
还没有评论,来抢沙发吧