⚔️ 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 冲突,并平滑适应配置更改。
安装简单,使用安全,随时准备迎接你的下一个网络。 ⚔️
你是这个资源的作者?登录后可认领此资源。
相似资源
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
ExyliaPlugins 的库。
通过对话框或铁砧界面帮助你的 Anthme
自定义你的Minecraft头像!
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
评论 0
登录后参与评分
还没有评论,来抢沙发吧