WoLobbyPvp

插件

· 作者 wojteko

无缝大厅 PvP 系统,配备计时剑激活、自动装备盔甲以及不可破坏的装备,打造终极竞技场体验。

0 本站下载 0 关注 更新于 8 个月前

最新 1.0 · 26.1.2 · Bukkit / Paper

一键开服(送7天)

英文

⚔️ 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

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源