Lobby4PvP

插件

· 作者 ThaRialSniper

通过在大厅中简单地持有一把剑即可启用交互式 PvP——安全、可视化,并完全可自定义,支持 VIP 装备、属性统计和 PlaceholderAPI。

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

最新 1.8.6 · 26.1.2 · Bukkit / Paper

一键开服(送7天)

⚔️ Lobby4PvP — 交互式大厅 PvP 系统

一套专为枢纽(Hubs)和大厅设计的现代轻量级 PvP 系统。
Lobby4PvP 让玩家只需按住剑即可启用 PvP —— 无需指令,无需菜单,纯粹依靠交互。

当玩家持有剑时,会自动进入 PvP 模式并获得可配置的护甲、音效和特效。
一旦松开剑,PvP 会在短暂延迟后安全禁用,将玩家返回大厅模式。
一切处理干净利落,无物品复制问题、无插件冲突或物品丢失。


✨ 主要功能

  • 交互式激活: 按住剑即可瞬间启用 PvP。
  • VIP 配置: 为 VIP 玩家提供自定义武器和护甲。
  • 防复制保护: 完全防止利用漏洞和幽灵物品。
  • 视觉反馈: ActionBar、BossBar 和聊天通知完美同步。
  • 持久化统计: 击杀数、死亡数、命中数和 KDR 安全存储在 stats.yml 中。
  • 配置重载: /lobby4pvp reload 安全地实时刷新所有设置。
  • 冲突覆盖: 与 WorldGuard、Essentials、PvPManager 和 CombatLogX 无缝协作。
  • PlaceholderAPI 支持: 完整集成以用于计分板和标签页列表。
  • bStats 指标: 匿名统计数据(ID 27655)。

? PlaceholderAPI 集成

Lobby4PvP 包含对 PlaceholderAPI 的完整支持,允许您在任何地方显示玩家的 PvP 数据 —— 包括计分板、全息图、菜单或标签页列表。
当插件在启动时检测到 PlaceholderAPI 时,所有占位符都会自动注册。

可用占位符

占位符 描述
%lobby4pvp_status% 显示玩家当前是否启用了 PvP 模式。
%lobby4pvp_cooldown% 显示重新启用 PvP 之前剩余的冷却时间。
%lobby4pvp_kills% 显示玩家在大厅中的总击杀数。
%lobby4pvp_deaths% 显示玩家在大厅中的总死亡数。
%lobby4pvp_hits% 显示玩家命中的次数。
%lobby4pvp_kdr% 显示玩家的击杀/死亡比率(KDR)。
%lobby4pvp_vip% 根据 VIP 状态返回 true 或 false。
%lobby4pvp_version% 显示当前 Lobby4PvP 插件版本。

使用示例

如果您的计分板或全息图插件支持 PlaceholderAPI(例如 TAB、AjLeaderboards、DecentHolograms 等),您可以直接使用这些占位符。


⚙️ 指令与权限

指令 描述 权限
/lobby4pvp 显示插件信息 lobby4pvp.info
/lobby4pvp reload 重载配置文件 lobby4pvp.reload
(VIP 装备) 获取 VIP 剑和护甲 lobby4pvp.vip

? 兼容性与配置

config.yml

# ╔══════════════════════════════════════════════════════════════════════╗
# ║                        Lobby4PvP — v1.8.6                            ║
# ║  Enable PvP in your lobby by holding a sword. Safe, robust, fast.    ║
# ╚══════════════════════════════════════════════════════════════════════╝
#
#  QUICK HELP:
#  • Reload everything live: /lobby4pvp reload
#  • Text supports both legacy '&' colors and MiniMessage
#  • Hotbar slots are 0..8 (0 = far left, 8 = far right)
#  • Java 17+ plugin build; latest Paper 26.1.x servers require Java 25 at runtime
#  • Invalid sounds, particles, materials, enchantments or out-of-range values warn in console and use safe runtime fallbacks
#  • Empty lore lines like "" are valid and kept as intentional spacing
#
#  REFERENCES:
#  • Materials    → https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html
#  • Sounds       → https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Sound.html
#  • Particles    → https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Particle.html
#  • Enchantments → https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/enchantments/Enchantment.html
#
#  NOTE ABOUT STATS:
#  • Player stats (kills, deaths, hits) are stored persistently in 'stats.yml'.
#  • No configuration is required; the file is created and maintained automatically.
#

# ┌──────────────────────────────────────────────────────────────────────┐
# │ Core & Safety                                                       │
# └──────────────────────────────────────────────────────────────────────┘
debug: false                        # Extra console logs (useful for diagnosing conflicts)
check-for-updates: true             # Notify in console if a new version is available
keep-inventory-on-death: true       # Prevent drops/exp on death in the lobby (safe duels)

# ┌──────────────────────────────────────────────────────────────────────┐
# │ PvP Policy (scope & override)                                       │
# └──────────────────────────────────────────────────────────────────────┘
pvp:
  override-others: true             # If true, Lobby4PvP can un-cancel other plugins' PvP blocks
                                    # when BOTH players are in Lobby4PvP mode.
  worlds: ["*"]                     # Where this plugin applies. ["*"] = all worlds.
                                    # Example: ["lobby", "hub1"]
  blocked-message: "&cPvP is blocked here."
                                    # Shown to the attacker when damage is denied by policy.
                                    # Supports legacy '&' colors and MiniMessage.

# ┌──────────────────────────────────────────────────────────────────────┐
# │ Timers (seconds)                                                    │
# └──────────────────────────────────────────────────────────────────────┘
timers:
  activate-seconds: 5               # Hold the sword for X seconds to enter PvP mode
  deactivate-seconds: 10            # After releasing the sword, PvP disables after X seconds
  cooldown-seconds: 0               # Wait time before enabling again (0 = off)

# ┌──────────────────────────────────────────────────────────────────────┐
# │ 显示(所有通道保持一致)                                          │
# └──────────────────────────────────────────────────────────────────────┘
display:
  actionbar: true                   # 在动作栏中显示进度/状态
  bossbar: false                    # 在 BossBar 中显示进度/状态
  chat: true                        # 同时打印整洁、非垃圾信息的聊天消息
  bossbar-color: GREEN              # GREEN, BLUE, RED, PURPLE, PINK, WHITE, YELLOW
  bossbar-style: SOLID              # SOLID, SEGMENTED_6, SEGMENTED_10, SEGMENTED_12, SEGMENTED_20

# ┌──────────────────────────────────────────────────────────────────────┐
# │ 默认剑(非 VIP 配置)                                             │
# └──────────────────────────────────────────────────────────────────────┘
sword:
  give-on-join: true                # 玩家加入时给予大厅剑
  slot: 2                           # 期望的热键栏槽位 (0..8)
  material: IRON_SWORD              # 任何有效的 Bukkit 材质
  display-name: "&aLobby Sword"
  lore:
    - ""
    - "&8-----------------------"
    - "&o按住以启用 PvP"
    - "&o在大厅中进行 &o有趣且安全的决斗!"
    - "&8-----------------------"
  lock: true                        # 防止移动/丢弃插件物品(防复制)
  enchantments:
    - SHARPNESS:4
    - UNBREAKING:4

# ┌──────────────────────────────────────────────────────────────────────┐
# │ 默认护甲(PvP 活跃时自动装备)                                    │
# └──────────────────────────────────────────────────────────────────────┘
armor:
  helmet:
    material: IRON_HELMET
    display-name: "&aLobby Helmet"
    lore: []
    enchantments: ["PROTECTION_ENVIRONMENTAL:3"]
  chestplate:
    material: IRON_CHESTPLATE
    display-name: "&aLobby Chestplate"
    lore: []
    enchantments: ["PROTECTION_ENVIRONMENTAL:3"]
  leggings:
    material: IRON_LEGGINGS
    display-name: "&aLobby Leggings"
    lore: []
    enchantments: ["PROTECTION_ENVIRONMENTAL:3"]
  boots:
    material: IRON_BOOTS
    display-name: "&aLobby Boots"
    lore: []
    enchantments: ["PROTECTION_FALL:4"]

# ┌──────────────────────────────────────────────────────────────────────┐
# │ VIP 配置(权限:lobby4pvp.vip)                                   │
# └──────────────────────────────────────────────────────────────────────┘
vip:
  enabled: true
  permission: lobby4pvp.vip

  sword:
    enabled: true                   # 如果为 false,VIP 将使用默认剑配置
    slot: 2                         # VIP 剑的期望槽位(可与非 VIP 不同)
    material: DIAMOND_SWORD
    display-name: "&bVIP Lobby Sword"
    lore:
      - ""
      - "&8-----------------------"
      - "&o专属 VIP 剑"
      - "&o按住以启用 PvP"
      - "&8-----------------------"
    enchantments:
      - SHARPNESS:5
      - UNBREAKING:3

  armor:
    helmet:
      material: DIAMOND_HELMET
      display-name: "&bVIP Helmet"
      lore: []
      enchantments: ["PROTECTION_ENVIRONMENTAL:4", "UNBREAKING:3"]
    chestplate:
      material: DIAMOND_CHESTPLATE
      display-name: "&bVIP Chestplate"
      lore: []
      enchantments: ["PROTECTION_ENVIRONMENTAL:4"]
    leggings:
      material: DIAMOND_LEGGINGS
      display-name: "&bVIP Leggings"
      lore: []
      enchantments: ["PROTECTION_ENVIRONMENTAL:4"]
    boots:
      material: DIAMOND_BOOTS
      display-name: "&bVIP Boots"
      lore: []
      enchantments: ["PROTECTION_FALL:4", "DEPTH_STRIDER:3"]

# ┌──────────────────────────────────────────────────────────────────────┐
# │ 物品标志                                                        │
# └──────────────────────────────────────────────────────────────────────┘
items:
  unbreakable: true                 # 使所有插件物品不可破坏

# ┌──────────────────────────────────────────────────────────────────────┐
# │ 特效                                                            │
# └──────────────────────────────────────────────────────────────────────┘
fx:
  sound: ENTITY_PLAYER_LEVELUP      # 启用 PvP 时播放
  particle: CRIT_MAGIC              # 启用 PvP 时在玩家周围生成
  disable-sound: ENTITY_ITEM_PICKUP # 禁用 PvP 时播放
  disable-particle: CRIT            # 禁用 PvP 时在玩家周围生成

# ┌──────────────────────────────────────────────────────────────────────┐
# │ 击杀庆祝                                                        │
# └──────────────────────────────────────────────────────────────────────┘
kill-firework:
  enabled: true
  power: 1                          # 1..4(数值越高,飞行高度越高)
# 当手动禁用 PvP 时应用的安全状态恢复
safe-state:
  auto-heal:
    enabled: true
    health: 20.0                    # 限制为玩家的最大生命值
  auto-feed:
    enabled: true
    food-level: 20                  # 0..20
    saturation: 0.0                 # 0.0..20.0

# ┌──────────────────────────────────────────────────────────────────────┐
# │ 消息(支持 '&' 颜色和 MiniMessage)                               │
# │ {seconds} 会被动态替换                                           │
# └──────────────────────────────────────────────────────────────────────┘
messages:
  prefix: "&aLobby4PvP &8» "
  enable: "&a&l已启用 PvP 模式。&r &7准备战斗吧。"
  disable: "&7已禁用 PvP 模式。你现在处于安全状态。"
  hold: "&7按住你的剑 &f{seconds}s &7以启用 &aPvP 模式&7。"
  already-active: "&7PvP 模式已处于活跃状态。"
  deactivate-progress: "&7PvP 模式将在 &f{seconds}s &7后禁用。"
  deactivate-cancelled: "&7取消禁用操作。"
  cooldown: "&7请等待 &f{seconds}s &7后再再次启用 &aPvP 模式&7。"
  world-pvp-disabled: "&c此处全局禁用了世界 PvP。Lobby4PvP 无法在此世界中启用战斗。"

# ┌──────────────────────────────────────────────────────────────────────┐
# │ PlaceholderAPI 格式设置                                           │
# │ 数值统计的可选视觉包装(使用 {value})            │
# │ 支持旧版 '&' 颜色和 MiniMessage                          │
# └──────────────────────────────────────────────────────────────────────┘
placeholders:
  status:
    enabled: "&aenabled"
    disabled: "&cdisabled"
  vip:
    true: "&btrue"
    false: "&7false"
  stats:
    kills: "&6⚔ {value}"
    deaths: "&c✖ {value}"
    hits: "&e☄ {value}"
    kdr: "&aKDR: {value}"
  • Minecraft: 1.18 → 26.1+
  • Java: 17 或更高版本
  • 支持的加载器: Paper, Spigot, Purpur, Bukkit (部分)
  • 依赖项: PlaceholderAPI(必需), bStats(包含)

❤️ 专为性能设计

Lobby4PvP 旨在提供干净、无卡顿的大厅 PvP 体验。
它在现代 Paper 服务器上高效运行,自动检测 PvP 冲突,并平滑适应配置更改。

安装简单,使用安全,随时准备迎接你的下一个网络。 ⚔️

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源