L-BedWars
适用于 Folia/Paper/Spigot 1.19+ 的高级 BedWars 插件。完全可配置,支持多语言,具备统计追踪、装饰物品、战斗通行证、商店、团队升级及代理支持等功能。
功能特性
多竞技场系统
支持无限数量的竞技场,提供四种模式类型——单人(1 名玩家/队伍)、双人(2 人)、三人(3 人)、四人(4 人)。每个竞技场拥有独立的配置、商店、升级、生成器以及区域边界。
Folia 支持
游戏机制
- 赛前大厅:玩家加入共享的等待大厅,当满足最低人数要求时开始倒计时(每种模式的阈值均可配置)
- 游戏开始:5 秒无敌倒计时,装备护甲,发放物品,激活生成器,刷新商店/升级 NPC
- 床系统:每支队伍拥有一张床,会被敌方破坏。破坏床后,该队伍将无法重生
- 突然死亡:达到
max-game-time(最大游戏时间)时,所有剩余的床都会破碎并伴有粒子效果(BLOCK_CRACK, STEP_SOUND),掉落的床物品将被清理,拥有“龙增益”升级的队伍会召唤龙
- 胜利条件:最后存活的队伍获胜。如果所有玩家断开连接,游戏将立即重置
生成器
四种类型:铁、金、钻石、绿宝石,具有可配置的生成速率和升级时间表。
- 基础速率:铁 (2秒),金 (8秒),钻石 (30秒),绿宝石 (60秒)
- 钻石生成器在游戏进行到 300秒、600秒、900秒 时自动升级
- 绿宝石生成器在游戏进行到 360秒、720秒、1080秒 时自动升级
- 团队熔炉升级(通过团队升级)可提高铁/金的生成速率
- 每个升级层级都会减少一个可配置的生成延迟量
商店系统
按模式的商店配置 (shop/<mode>.yml)。分类包含可购买的商品,具有:
- 费用类型:铁、金、钻石或绿宝石
- 展示:自定义名称、描述、材质
- 奖励指令:可选的执行指令,在购买时运行
- 商店通过竞技场设置期间放置的商店 NPC 访问
团队升级
按模式的升级树 (upgrades/<mode>.yml),通过升级 NPC 使用钻石购买:
- 锋利剑刃 — 增加剑的伤害(多个层级)
- 强化护甲 — 减少受到的伤害(多个层级)
- 龙增益 — 在突然死亡阶段为你的队伍召唤一条龙
- 治疗池 — 在你基地的治疗区域
- 熔炉 — 提高生成器的生成速率
- 陷阱 — 当敌人进入你的基地时触发(警告队伍,暴露敌人位置)
- 警报陷阱 — 当敌人在附近时警告队伍
特殊物品
可从商店购买,具有独特的机制:
- 弹出塔(羊毛,6 绿宝石):逐块动画放置的塔(羊毛框架 + 梯子通道)。按照玩家面朝的方向建造。可配置的冷却时间 (
specials.popup-tower.cooldown)。安全检查防止在床、竞技场边界或队伍出生点入口附近建造
- 铁傀儡(铁锭,4 绿宝石):生成一个保护队伍的傀儡,具有可配置的生命值、速度、跟随范围和碰撞设置。攻击附近的敌人。生成之间有冷却时间
- 桥梁蛋(鸡蛋,2 绿宝石):投掷后,从撞击点创建一个临时桥梁
- 火球(火焰弹,1 绿宝石):能破坏方块并对实体造成伤害的爆炸性投射物
- TNT(TNT,2 金):可放置的爆炸物,具有可配置的引信和 TNT 跳跃的击退机制
追踪罗盘
可购买的罗盘(1 绿宝石),用于追踪最近的敌方玩家。右键点击以更新目标。仅追踪来自不同队伍的玩家。目标每 5 秒自动更新一次。死亡后移除。
观战系统
当玩家死亡(最后一击)时,他们进入观战模式,具有:
- 罗盘 — 循环切换活着的玩家以进行观战
- 红床 — 传送至队伍床的位置
- 玩家不可见且可以穿过方块飞行
- 管理员可通过
/bwa spectator 进行观战
重连系统
如果玩家在游戏中的床仍然存活时断开连接,他们可以使用 /bw rejoin 重新加入。他们在 5 秒倒计时后在队伍的出生点重生。
统计追踪
追踪每位玩家的统计数据,存储在 YAML、SQLite 或 MySQL 中:
- 击杀数、死亡数、K/D 比率
- 最后一击数、最后一击死亡数、最后一击 K/D 比率
- 胜场数、败场数、W/L 比率
- 破坏的床数、参与的游戏数
- 连胜记录(跨会话持久保存)
- 所有统计数据均可通过 PlaceholderAPI 占位符访问
等级系统
100 个等级,具有经验值缩放。经验公式:XP = floor(500 * 1.15^(level-1))。经验来源:
- 击杀:+10 XP
- 胜利:+60 XP
- 最后一击:+20 XP
- 破坏床:+30 XP
- 每提升 5 级会广播一条成就信息
战斗通行证
可配置的季节性进度系统:
- 层级:可配置的层级数量,每个层级有相应的经验需求
- 免费奖励:所有玩家均可获得(通过
/bw battlepass 开启)
- 高级奖励:需要单独的权限才能解锁
- 经验来源:击杀、胜利、最后一击、破坏床(在
rewards.yml 中配置)
- 为战斗通行证贡献经验:可切换 - 启用时,经验同时计入等级系统和战斗通行证系统
- 每个赛季通过
/bwa bp reset confirm 重置进度
每日奖励
可配置的每日奖励系统:
- 经验奖励:可配置的数量
- 金币奖励:可配置的数量
- 金钱奖励:Vault 经济集成(可配置的数量)
- 冷却时间:可配置的小时数(最小为 1)
- 通过
/bw dailyreward 领取
- 通过
/bwa reward * 进行管理
装饰物品
可通过 GUI 购买和选择的装饰物品:
- 击杀特效 — 击杀时的视觉效果(例如闪电、爱心、烟雾)
- 胜利舞蹈 — 游戏胜利时播放的效果
- 死亡惨叫 — 死亡时播放的声音
- 投射物轨迹 — 投射物后面的粒子轨迹
- 岛屿顶部装饰 — 放置在队伍出生点的装饰方块
- 胜利歌曲 — 由 NoteBlockAPI 驱动的胜利时播放的歌曲
- 每种装饰物品都有价格(金币)、权限节点和解锁条件
记分板
可自定义的记分板:
- 大厅记分板:显示竞技场名称、玩家数量、地图名称、模式、等待时间、你的队伍
- 游戏内记分板:显示击杀数、决赛次数、被摧毁的床、游戏时间(如果接近最大游戏时间则显示龙倒计时)、队伍信息
- 所有文本均可通过语言文件进行配置
- 每 2 秒更新一次
BossBar(顶部状态栏)
可配置的等待大厅指示器:
- 可通过
bossbar.enabled 切换开关
- 标题支持占位符:
{arena}、{seconds}、{count}、{max}
- 倒计时条(
show-countdown):在大厅倒计时期间消耗进度条
- 玩家加入竞技场大厅时立即显示
- 随着玩家加入/离开实时更新
- 游戏开始时隐藏
Tab 列表
每个竞技场可自定义的 Tab 列表头部和尾部:
- 支持按队伍颜色排序
- 支持竞技场名称、玩家数量、游戏状态的占位符
- 可通过语言文件进行配置
封禁系统
游戏内封禁管理:
- 封禁时长:支持秒(
5s)、分钟(30m)、小时(10h)、天(5d)、永久(perm)
- 封禁 GUI:通过
/bwa banlist 查看所有被封禁的玩家
- 解封:通过
/bwa unban <player> 移除封禁
- 加入竞技场时检查封禁状态
代理模式(BungeeCord/Velocity)
支持多服务器,需配合代理插件使用:
- 服务器状态广播:通过 TCP 共享竞技场状态、玩家数量、地图信息
- 跨服务器观战:传送至并观战任意服务器上的玩家
- 智能加入:
/bw join <mode> 在所有服务器中找到最佳可用竞技场
- 队列系统:如果没有可用竞技场,玩家将被排队,并在有竞技场开放时自动连接
- 小队支持:小队队长的排队状态将同步给所有成员
- 服务器 MOTD:显示竞技场状态和玩家数量
- 排行榜全息图:可放置的全息图,显示顶级玩家(每种统计数据可单独配置)
命令白名单
限制玩家在比赛期间可以使用哪些命令:
- 可通过
command-whitelist.enabled 切换开关(默认:false)
- 在
command-whitelist.commands 中配置允许的命令列表
- 非白名单命令将被静默取消
- 仅在
PLAYING(游戏中)状态下生效
小队集成
支持 alessiodp's Parties API:
- 小队成员一起加入同一竞技场
- 小队队长的游戏模式决定小队加入的模式
- 代理模式下的队列系统会将排队状态共享给所有小队成员
多语言
基于 YAML 的语言系统,内置支持 English、Turkish 和 Spanish:
- 从
messages_<lang>.yml 或 messages.yml(自定义)加载
- 所有游戏内消息、标题、动作栏、记分板行和 GUI 文本均可配置
- 通过在
config.yml 中设置 language 来指定语言
- 通过创建新的消息文件可以轻松添加新语言
PlaceholderAPI
超过 30 个占位符,标识符为 %lbedwars_*%,涵盖统计数据、等级、经济、外观和实时竞技场信息。
命令
/bedwars(别名:/bw)— 玩家命令
权限: bedwars.play(默认:所有玩家)
| 子命令 |
参数 |
描述 |
help |
— |
显示帮助菜单 |
join |
<arena> |
通过名称加入特定竞技场 |
randomjoin |
<mode> |
按模式(solo、duo、trio、quad)加入随机可用竞技场 |
rejoin |
— |
如果你的床还活着,重新加入上一局游戏 |
leave |
— |
离开当前竞技场 |
list |
— |
列出所有已启用的竞技场及其玩家数量 |
stats |
[player] |
查看你的统计数据或其他玩家的统计数据(打开 GUI) |
level |
— |
查看你的等级、经验值和下一级进度 |
dailyreward |
— |
领取每日奖励 |
cosmetics |
— |
打开外观选择菜单 |
battlepass |
— |
打开战斗通行证菜单 |
示例:
/bw help
/bw join BedWars1
/bw randomjoin solo
/bw rejoin
/bw leave
/bw list
/bw stats
/bw stats Notch
/bw level
/bw dailyreward
/bw cosmetics
/bw battlepass
/bedwarsadmin(别名:/bwa、/bwadmin)— 管理员命令
权限: bedwars.admin(默认:op)
竞技场管理
| 子命令 |
参数 |
描述 |
help |
— |
显示管理员帮助菜单 |
create |
<name> |
使用给定名称创建新竞技场 |
setup |
<arena> |
进入竞技场的设置模式(启用 /setup 命令) |
delete |
<arena> |
删除竞技场及其配置文件 |
enable |
<arena> |
启用竞技场以允许加入 |
disable |
<arena> |
禁用竞技场(防止加入) |
setlobby |
<arena> |
在你当前位置设置等待大厅出生点 |
setspectator |
<arena> |
在你当前位置设置观战出生点 |
setmainlobby |
— |
设置全局主大厅(游戏结束后的传送目的地) |
setmode |
<arena> <mode> |
设置竞技场游戏模式:solo、duo、trio、quad |
forcestart |
<arena> |
强制立即开始游戏倒计时 |
reload |
— |
重新加载所有配置和语言文件 |
队伍管理
| 子命令 |
参数 |
描述 |
addteam |
<arena> <name> <color> <max-players> |
向竞技场添加队伍(max-players:1-4) |
removeteam |
<arena> <name> |
从竞技场移除队伍 |
可用颜色: RED、BLUE、GREEN、YELLOW、AQUA、WHITE、BLACK、GOLD、GRAY、DARK_RED、DARK_BLUE、DARK_GREEN、LIGHT_PURPLE
观战
| 子命令 |
参数 |
描述 |
spectator |
<arena|player> |
观战竞技场或传送至并观战特定玩家 |
等级管理
| 子命令 |
参数 |
描述 |
addxp |
<player> <amount> |
向玩家添加经验值 |
战斗通行证管理
| 子命令 |
参数 |
描述 |
bp reset |
[confirm] |
重置战斗通行证赛季(必须在 30 秒内确认) |
每日奖励管理
| 子命令 |
参数 |
描述 |
reward help |
— |
显示奖励帮助菜单 |
reward setxp |
<数量> |
设置经验值奖励数量 |
reward setcoins |
<数量> |
设置金币奖励数量 |
reward setmoney |
<数量> |
设置货币奖励数量(需要 Vault) |
| reward setcooldown | <小时数> | 设置奖励冷却时间(单位为小时,最小值为 1) |
| reward reset | <玩家> | 重置特定玩家的奖励冷却时间 |
| reward info | — | 显示当前奖励设置 |
| reward toggle | — | 启用/禁用奖励系统 |
封禁管理
| 子命令 |
参数 |
描述 |
ban |
[duration] <player> <reason> |
将玩家从 BedWars 中封禁。持续时间格式:5s、30m、10h、5d、perm 或 permanent。默认值:永久 |
unban |
<player> |
解除对玩家的封禁 |
banlist |
[page] |
打开封禁列表 GUI 或查看特定页面 |
示例:
/bwa create MyArena
/bwa setup MyArena
/bwa addteam MyArena Red RED 4
/bwa removeteam MyArena Red
/bwa delete MyArena
/bwa enable MyArena
/bwa disable MyArena
/bwa reload
/bwa setlobby MyArena
/bwa setspectator MyArena
/bwa setmainlobby
/bwa forcestart MyArena
/bwa setmode MyArena quad
/bwa spectator MyArena
/bwa spectator Notch
/bwa addxp Notch 500
/bwa bp reset
/bwa bp reset confirm
/bwa reward setxp 100
/bwa reward setcoins 50
/bwa reward setmoney 1000.0
/bwa reward setcooldown 24
/bwa reward reset Notch
/bwa reward info
/bwa reward toggle
/bwa ban 7d Notch Griefing
/bwa ban perm Notch Hacking
/bwa unban Notch
/bwa banlist
/setup — 竞技场设置命令
权限: bedwars.setup(默认:op)
注意: 必须先使用 /bwa setup <arena> 进入设置模式。在设置模式下,你将获得一根烈焰棒作为工具。
| 子命令 |
参数 |
描述 |
help |
— |
显示设置帮助菜单 |
setspawn |
<team> |
将当前所在位置设置为该队伍的出生点 |
setbed |
<team> |
设置队伍的床位置(站在床边并注视它;会自动同时设置床头和床尾) |
setgenerator |
<type> |
在你所在位置放置一个发电机。类型:IRON、GOLD、DIAMOND、EMERALD |
setshop |
— |
在你当前位置放置一个商店 NPC |
setupgrade |
— |
在你当前位置放置一个升级 NPC |
setregion |
— |
使用你手持的烈焰棒法杖选定的两个角来保存竞技场区域(左键点击 = 角 1,右键点击 = 角 2) |
done |
— |
最终确定并保存竞技场配置,退出设置模式 |
示例:
/bwa setup MyArena (进入设置模式)
/setup setspawn Red
/setup setbed Blue
/setup setgenerator IRON
/setup setgenerator DIAMOND
/setup setshop
/setup setupgrade
/setup setregion (先用法杖选择角落)
/setup done (保存并退出)
权限
| 权限节点 |
默认值 |
描述 |
bedwars.play |
true |
访问玩家命令和游戏内容 |
bedwars.admin |
op |
访问管理员命令 |
bedwars.setup |
op |
访问竞技场设置命令 |
bedwars.bypass |
op |
绕过方块/游戏限制(游戏中放置/破坏方块、加入已开始的游戏) |
占位符 (PlaceholderAPI)
所有占位符均使用 %lbedwars_<placeholder>% 格式。
统计信息
| 占位符 |
类型 |
描述 |
%lbedwars_kills% |
int |
总击杀数 |
%lbedwars_deaths% |
int |
总死亡数 |
%lbedwars_kd% |
float |
击杀/死亡比(保留两位小数) |
%lbedwars_finalkills% |
int |
最终击杀数 |
%lbedwars_finaldeaths% |
int |
最终死亡数 |
%lbedwars_finalkd% |
float |
最终击杀/死亡比(保留两位小数) |
%lbedwars_wins% |
int |
总胜场数 |
%lbedwars_losses% |
int |
总负场数 |
%lbedwars_wlr% |
float |
胜/负比(保留两位小数) |
%lbedwars_bedsbroken% |
int |
被破坏的床数量 |
%lbedwars_gamesplayed% |
int |
已玩局数 |
%lbedwars_winstreak% |
int |
当前连胜场次 |
等级与经验值
| 占位符 |
类型 |
描述 |
%lbedwars_level% |
int |
当前等级(1–100) |
%lbedwars_xp% |
int |
当前经验值数量 |
%lbedwars_xp_required% |
int |
升至下一等级所需的经验值 |
%lbedwars_xp_percent% |
float |
升至下一等级的进度百分比(0–100) |
%lbedwars_xp_progress% |
string |
进度条(20 段,已填充/未填充) |
经济系统
| 占位符 |
类型 |
描述 |
%lbedwars_balance% |
int |
余额(整数,向下取整) |
%lbedwars_balance_formatted% |
string |
格式化后的余额 |
外观装饰
| 占位符 |
类型 |
描述 |
%lbedwars_active_killeffect% |
string |
当前激活的击杀特效名称 |
%lbedwars_active_victorydance% |
string |
当前激活的胜利舞蹈名称 |
%lbedwars_active_trail% |
string |
当前激活的弹道轨迹名称 |
%lbedwars_active_victorysong% |
string |
当前激活的胜利歌曲名称 |
Arena(实时 — 仅在玩家处于竞技场中时显示数据)
| 占位符 |
类型 |
描述 |
%lbedwars_arena% |
string |
当前竞技场名称 |
%lbedwars_gamestate% |
string |
当前游戏状态(WAITING / STARTING / PLAYING / ENDING) |
%lbedwars_gametime% |
string |
游戏经过时间,格式为 MM:SS |
%lbedwars_isplaying% |
string |
如果正在游玩则为 YES,否则为 NO |
%lbedwars_isspectating% |
string |
如果正在观战则为 YES,否则为 NO |
%lbedwars_players% |
int |
竞技场中的当前玩家数量 |
%lbedwars_maxplayers% |
int |
竞技场中的最大玩家数量 |
%lbedwars_team% |
string |
队伍名称 |
%lbedwars_teamcolor% |
string |
队伍颜色代码(例如 &c) |
%lbedwars_team_colored% |
string |
应用了颜色代码的队伍名称 |
%lbedwars_teammates% |
int |
队伍中的队友总数 |
%lbedwars_teammates_alive% |
int |
存活的队友数量 |
%lbedwars_hasbed% |
string |
如果床存活则为 YES,否则为 NO |
Position Leaderboards(需要在线数据库)
%lbedwars_position_kills%
%lbedwars_position_wins%
%lbedwars_position_final-kills%
%lbedwars_position_beds-broken%
返回玩家的排名位置(整数)。
rewards.yml — 游戏事件奖励
| 路径 |
类型 |
默认值 |
描述 |
game-rewards.kill-xp |
int |
10 |
每次击杀获得的经验值 |
game-rewards.win-xp |
int |
60 |
每次胜利获得的经验值 |
game-rewards.bed-break-xp |
int |
30 |
每次破坏床获得的经验值 |
game-rewards.final-kill-xp |
int |
20 |
每次终结击杀获得的经验值 |
game-rewards.kill-coins |
int |
5 |
每次击杀获得的金币 |
game-rewards.win-coins |
int |
30 |
每次胜利获得的金币 |
battlepass.yml — 战斗通行证设置
| 路径 |
类型 |
默认值 |
描述 |
battlepass.enabled |
boolean |
false |
启用战斗通行证系统 |
battlepass.contribute-to-bp |
boolean |
true |
如果为 true,游戏中获得的经验值也将计入战斗通行证进度 |
battlepass.tiers |
int |
50 |
通行证中的层级数量 |
battlepass.xp-per-tier |
int |
250 |
每层所需的经验值 |
battlepass.rewards.free.<tier> |
list |
— |
每层的免费奖励命令 |
battlepass.rewards.premium.<tier> |
list |
— |
每层的高级奖励命令 |
cosmetics.yml — 外观配置
| 路径 |
类型 |
默认值 |
描述 |
kill-effects.<name>.material |
string |
— |
GUI 中显示的物品材质 |
kill-effects.<name>.price |
int |
— |
价格(金币) |
kill-effects.<name>.permission |
string |
— |
所需的权限节点 |
kill-effects.<name>.effect |
string |
— |
效果类型(例如 LIGHTNING, HEART, NOTE, SMOKE, FLAME, EXPLOSION, CRIT, SPELL) |
victory-dances.* |
— |
— |
结构与击杀特效相同 |
death-cries.* |
— |
— |
结构相同,但使用声音名称 |
trails.* |
— |
— |
结构相同,但使用粒子类型 |
island-toppers.* |
— |
— |
结构相同,但使用方块材质 |
victory-songs.* |
— |
— |
结构相同,但使用 NBS 文件名 |
dailyrewards.yml — 每日奖励设置
| 路径 |
类型 |
默认值 |
描述 |
enabled |
boolean |
true |
启用每日奖励 |
xp |
int |
50 |
经验值奖励数量 |
coins |
int |
25 |
金币奖励数量 |
money |
double |
100.0 |
金钱奖励数量(Vault) |
cooldown |
int |
24 |
冷却时间(小时) |
shop/<mode>.yml — 商店配置
每个类别的结构:
categories:
<category_name>:
item: <material> # 在商店 GUI 中显示的物品
name: "<display name>" # 类别显示名称
lore:
- "<lore line>" # 类别背景文本
items:
- material: <material> # 购买物品
name: "<display name>" # 物品显示名称
lore: # 物品背景文本
- "<lore line>"
price-type: IRON|GOLD|DIAMOND|EMERALD
price: <amount> # 成本
amount: <count> # 获得数量
reward-commands: # 购买时运行的命令(可选)
- "<command>"
upgrades/<mode>.yml — 升级配置
每个升级的结构:
upgrades:
<upgrade_name>:
name: "<display name>"
item: <material>
lore:
- "<lore line>"
max-tier: <tier_count>
costs:
- <diamond_cost> # 每层一个成本(列表)
values:
- <value> # 每层一个数值(列表)
默认升级:sharpened-swords, reinforced-armor, dragon-buff, heal-pool, forge, trap, alarm-trap。
arenas/<arena>/config.yml — 竞技场定义
在安装过程中自动生成。包含:
- 模式和显示名称
- 队伍定义:颜色、名称、出生点位置、床位置及朝向方向、床脚位置
- 生成器位置:铁、金、钻石、绿宝石的位置
- NPC 位置:商店和升级 NPC 的坐标
- 区域边界:最小/最大 X、Y、Z 坐标
- 大厅位置:等待大厅的出生点
- 观战出生点:观战观察位置
依赖项
必需:
- Paper 1.19+(或带有 Paper API 的 Folia/Spigot)
软依赖项(可选):
| 插件 |
用途 |
| PlaceholderAPI |
%lbedwars_*% 的占位符扩展 |
| Vault |
用于商店购买的经济学集成 |
| NoteBlockAPI |
胜利歌曲播放(.nbs 文件) |
| Parties (alessiodp) |
组队排队系统 |
Proxy Module
一个配套的 BungeeCord/Velocity 插件 (L-BedWarsProxy),用于多服务器网络。
功能
-
智能加入:/bw join <模式> 自动查找最佳可用的竞技场服务器并连接玩家
-
排队系统:如果所有服务器已满,玩家进入队列并在有空位时自动连接
-
队伍支持:队长排队状态共享,所有成员一起连接
-
服务器状态广播:游戏服务器通过 TCP(可配置端口)报告竞技场状态
-
服务器 MOTD:在服务器列表中显示当前竞技场状态和玩家数量
-
跨服观战:管理员可跨服务器观战任何玩家
-
排行榜全息图:可放置的全息图,显示各项统计(击杀数、胜利次数、最终击杀数、床破坏数、死亡数、最终死亡数、失败次数、游戏场次)的顶级玩家
代理命令
/bw — 加入命令(无需权限)
| 子命令 |
参数 |
描述 |
join |
<模式> |
查找并连接至最佳可用竞技场 |
rejoin |
— |
重新连接至上一个游戏服务器 |
stats |
[玩家] |
查看统计数据界面 |
battlepass / bp |
— |
打开战斗通行证界面 |
/bwa — 管理员命令 (权限: lbedwarsproxy.admin, 默认: op)
| 子命令 |
参数 |
描述 |
gui |
[filter] |
打开竞技场浏览器 UI (过滤条件: all, solo, duo, trio, quad) |
tp |
<player> |
传送至并旁观跨服务器的玩家 |
leaderboard |
[stat] |
打开排行榜 GUI (统计项: kills, wins, final_kills, beds_broken) |
hologram set |
[stat] |
放置一个排行榜全息图 |
hologram remove |
[id] |
通过 ID 移除一个全息图 |
hologram list |
— |
列出所有已放置的全息图 |
ban |
[duration] <player> <reason> |
全局封禁 |
unban |
<player> |
全局解封 |
banlist |
[page] |
查看被封禁的玩家列表 |
支持
discord: squezsaz
discord:
L-BedWars
Advanced BedWars plugin for Folia/Paper/Spigot 1.19+. Fully configurable, multi-language, with stats tracking, cosmetics, battle pass, shop, team upgrades, and proxy support.
Features
Multi-Arena System
Supports unlimited arenas with four mode types — solo (1 player/team), duo (2), trio (3), quad (4). Each arena has its own config, shop, upgrades, generators, and region bounds.
Folia Support
Game Mechanics
- Pre-game lobby: Players join a shared waiting lobby, countdown starts when minimum players are met (configurable per mode)
- Game start: 5-second invulnerability countdown, armor is applied, items given, generators activated, shop/upgrade NPCs spawned
- Bed system: Each team has a bed breakable by enemies. Breaking a bed prevents that team from respawning
- Sudden death: When
max-game-time is reached, all remaining beds break with particle effects (BLOCK_CRACK, STEP_SOUND), dropped bed items are cleaned up, and dragons spawn for teams with the Dragon Buff upgrade
- Win condition: Last team alive wins. If all players disconnect, the game resets immediately
Generators
Four types: Iron, Gold, Diamond, Emerald with configurable spawn rates and upgrade schedules.
- Base rates: Iron (2s), Gold (8s), Diamond (30s), Emerald (60s)
- Diamond generators auto-upgrade at 300s, 600s, 900s into game
- Emerald generators auto-upgrade at 360s, 720s, 1080s into game
- Team forge upgrades (via team upgrades) improve iron/gold rates
- Each upgrade tier reduces spawn delay by a configurable amount
Shop System
Per-mode shop configuration (shop/<mode>.yml). Categories contain buyable items with:
- Cost type: Iron, Gold, Diamond, or Emerald
- Display: Custom name, lore, material
- Reward commands: Optional commands executed on purchase
- Shop is accessed via Shop NPC placed during arena setup
Team Upgrades
Per-mode upgrade trees (upgrades/<mode>.yml) purchased with diamonds via Upgrade NPC:
- Sharpened Swords — increases sword damage (multiple tiers)
- Reinforced Armor — reduces incoming damage (multiple tiers)
- Dragon Buff — spawns a dragon for your team at sudden death
- Heal Pool — regeneration zone at your base
- Forge — improves generator spawn rates
- Trap — triggers when enemies enter your base (alerts team, reveals enemies)
- Alarm Trap — alerts team when enemies are nearby
Special Items
Buyable from the shop with unique mechanics:
- Pop-Up Tower (Wool, 6 emeralds): Animated block-by-block tower placement (wool frame + ladder access). Built in the direction the player is facing. Configurable cooldown (
specials.popup-tower.cooldown). Safety checks prevent building near beds, arena boundaries, or team spawn entrances
- Iron Golem (Iron Ingot, 4 emeralds): Spawns a team-protecting golem with configurable health, speed, follow range, and collidable setting. Attacks nearby enemies. Cooldown between spawns
- Bridge Egg (Egg, 2 emeralds): When thrown, creates a temporary bridge from the impact point
- Fireball (Fire Charge, 1 emerald): Explosive projectile that destroys blocks and damages entities
- TNT (TNT, 2 gold): Placeable explosive with configurable fuse and knockback mechanics for TNT jumping
Tracker Compass
Buyable compass (1 emerald) that tracks the nearest enemy player. Right-click to update target. Tracks players from different teams only. Target updates every 5 seconds automatically. Removed on death.
Spectator System
When a player dies (final kill), they enter spectator mode with:
- Compass — cycle through alive players to spectate
- Red Bed — teleport to team bed locations
- Players are invisible and can fly through blocks
- Admin spectate via
/bwa spectator
Rejoin System
If a player disconnects during a game while their bed is still alive, they can rejoin using /bw rejoin. They respawn at their team's spawn after a 5-second countdown.
Stats Tracking
Tracks per-player statistics stored in YAML, SQLite, or MySQL:
- Kills, Deaths, K/D Ratio
- Final Kills, Final Deaths, Final K/D Ratio
- Wins, Losses, W/L Ratio
- Beds Broken, Games Played
- Winstreak (persistent across sessions)
- All stats accessible via PlaceholderAPI placeholders
Level System
100 levels with XP scaling. XP formula: XP = floor(500 * 1.15^(level-1)). XP sources:
- Kill: +10 XP
- Win: +60 XP
- Final Kill: +20 XP
- Bed Break: +30 XP
- Each 5 levels grants an achievement broadcast
Battle Pass
Configurable season-based progression system:
- Tiers: Configurable number of tiers with XP requirements per tier
- Free Rewards: Available to all players (opened via
/bw battlepass)
- Premium Rewards: Require a separate permission to unlock
- XP Sources: Kills, wins, final kills, bed breaks (configured in
rewards.yml)
- Contribute to Battle Pass: Toggleable - when enabled, XP goes to both level and battle pass systems
- Progress resets each season via
/bwa bp reset confirm
Daily Rewards
Configurable daily reward system:
- XP Reward: Configurable amount
- Coins Reward: Configurable amount
- Money Reward: Vault economy integration (configurable amount)
- Cooldown: Configurable in hours (minimum 1)
- Claim via
/bw dailyreward
- Admin management via
/bwa reward *
Cosmetics
Cosmetic items purchasable and selectable via GUI:
- Kill Effects — visual effects on kill (e.g., lightning, hearts, smoke)
- Victory Dances — effects played on game win
- Death Cries — sound played on death
- Projectile Trails — particle trails behind projectiles
- Island Toppers — decorative blocks placed at team spawn
- Victory Songs — NoteBlockAPI-powered songs played on win
- Each cosmetic has a price (coins), permission node, and unlock condition
Scoreboard
Customizable scoreboards:
- Lobby Scoreboard: Shows arena name, player count, map name, mode, waiting time, your team
- In-Game Scoreboard: Shows kills, finals, beds broken, game time (with dragon countdown if near max-game-time), team information
- All text configurable via language files
- Updates every 2 seconds
BossBar
Configurable waiting lobby indicator:
- Toggleable via
bossbar.enabled
- Title with placeholders:
{arena}, {seconds}, {count}, {max}
- Countdown bar (
show-countdown): Drains the progress bar during the lobby countdown
- Appears instantly when a player joins the arena lobby
- Updates in real-time as players join/leave
- Hidden when the game starts
Tab List
Customizable tab list header and footer per arena:
- Supports team color sorting
- Placeholders for arena name, player count, game state
- Configurable via language files
Ban System
In-game ban management:
- Ban duration: Supports seconds (
5s), minutes (30m), hours (10h), days (5d), permanent (perm)
- Ban GUI: View all banned players with
/bwa banlist
- Unban: Remove bans via
/bwa unban <player>
- Bans check on arena join
Proxy Mode (BungeeCord/Velocity)
Multi-server support with companion proxy plugin:
- Server status broadcasting: Arena state, player count, map info shared via TCP
- Cross-server spectate: Teleport to and spectate players on any server
- Smart joining:
/bw join <mode> finds the best available arena across all servers
- Queue system: If no arena is available, players are queued and auto-connected when one opens
- Party support: Party leader's queue state shared with members
- Server MOTD: Displays arena status and player count
- Leaderboard holograms: Placeable holograms showing top players (configurable per stat)
Command Whitelist
Limit which commands players can use during matches:
- Toggleable via
command-whitelist.enabled (default: false)
- Configurable command list in
command-whitelist.commands
- Silent cancellation for non-whitelisted commands
- Only active during
PLAYING game state
Party Integration
Support for alessiodp's Parties API:
- Party members join the same arena together
- Party leader's game mode determines which mode the party joins
- Queue system in proxy mode shares queue state with all party members
Multi-Language
YAML-based language system with built-in support for English, Turkish, and Spanish:
- Loaded from
messages_<lang>.yml or messages.yml (custom)
- All in-game messages, titles, action bars, scoreboard lines, and GUI text are configurable
- Language set via
language in config.yml
- Easy to add new languages by creating new message files
PlaceholderAPI
30+ placeholders under the %lbedwars_*% identifier covering stats, levels, economy, cosmetics, and real-time arena information.
Commands
/bedwars (alias: /bw) — Player Commands
Permission: bedwars.play (default: all players)
| Subcommand |
Arguments |
Description |
help |
— |
Shows the help menu |
join |
<arena> |
Join a specific arena by name |
randomjoin |
<mode> |
Join a random available arena by mode (solo, duo, trio, quad) |
rejoin |
— |
Rejoin your last game if your bed is still alive |
leave |
— |
Leave the current arena |
list |
— |
List all enabled arenas with player counts |
stats |
[player] |
View your stats or another player's stats (opens GUI) |
level |
— |
View your level, XP, and progress to next level |
dailyreward |
— |
Claim your daily reward |
cosmetics |
— |
Open the cosmetics selection menu |
battlepass |
— |
Open the Battle Pass menu |
Examples:
/bw help
/bw join BedWars1
/bw randomjoin solo
/bw rejoin
/bw leave
/bw list
/bw stats
/bw stats Notch
/bw level
/bw dailyreward
/bw cosmetics
/bw battlepass
/bedwarsadmin (aliases: /bwa, /bwadmin) — Admin Commands
Permission: bedwars.admin (default: op)
Arena Management
| Subcommand |
Arguments |
Description |
help |
— |
Shows the admin help menu |
create |
<name> |
Create a new arena with the given name |
setup |
<arena> |
Enter setup mode for an arena (enables /setup commands) |
delete |
<arena> |
Delete an arena and its config |
enable |
<arena> |
Enable an arena for joining |
disable |
<arena> |
Disable an arena (prevents joining) |
setlobby |
<arena> |
Set the waiting lobby spawn at your current location |
setspectator |
<arena> |
Set the spectator spawn at your current location |
setmainlobby |
— |
Set the global main lobby (post-game teleport destination) |
setmode |
<arena> <mode> |
Set arena game mode: solo, duo, trio, quad |
forcestart |
<arena> |
Force-start the game countdown immediately |
reload |
— |
Reload all configurations and language files |
Team Management
| Subcommand |
Arguments |
Description |
addteam |
<arena> <name> <color> <max-players> |
Add a team to an arena (max-players: 1-4) |
removeteam |
<arena> <name> |
Remove a team from an arena |
Available colors: RED, BLUE, GREEN, YELLOW, AQUA, WHITE, BLACK, GOLD, GRAY, DARK_RED, DARK_BLUE, DARK_GREEN, LIGHT_PURPLE
Spectate
| Subcommand |
Arguments |
Description |
spectator |
<arena|player> |
Spectate an arena or teleport to and spectate a specific player |
Level Management
| Subcommand |
Arguments |
Description |
addxp |
<player> <amount> |
Add XP to a player |
Battle Pass Management
| Subcommand |
Arguments |
Description |
bp reset |
[confirm] |
Reset the Battle Pass season (must confirm within 30s) |
Daily Reward Management
| Subcommand |
Arguments |
Description |
reward help |
— |
Show reward help menu |
reward setxp |
<amount> |
Set the XP reward amount |
reward setcoins |
<amount> |
Set the coin reward amount |
reward setmoney |
<amount> |
Set the money reward amount (requires Vault) |
reward setcooldown |
<hours> |
Set reward cooldown in hours (minimum 1) |
reward reset |
<player> |
Reset a specific player's reward cooldown |
reward info |
— |
Show current reward settings |
reward toggle |
— |
Enable/disable the reward system |
Ban Management
| Subcommand |
Arguments |
Description |
ban |
[duration] <player> <reason> |
Ban a player from BedWars. Duration formats: 5s, 30m, 10h, 5d, perm or permanent. Default: permanent |
unban |
<player> |
Unban a player |
banlist |
[page] |
Open the ban list GUI or view a specific page |
Examples:
/bwa create MyArena
/bwa setup MyArena
/bwa addteam MyArena Red RED 4
/bwa removeteam MyArena Red
/bwa delete MyArena
/bwa enable MyArena
/bwa disable MyArena
/bwa reload
/bwa setlobby MyArena
/bwa setspectator MyArena
/bwa setmainlobby
/bwa forcestart MyArena
/bwa setmode MyArena quad
/bwa spectator MyArena
/bwa spectator Notch
/bwa addxp Notch 500
/bwa bp reset
/bwa bp reset confirm
/bwa reward setxp 100
/bwa reward setcoins 50
/bwa reward setmoney 1000.0
/bwa reward setcooldown 24
/bwa reward reset Notch
/bwa reward info
/bwa reward toggle
/bwa ban 7d Notch Griefing
/bwa ban perm Notch Hacking
/bwa unban Notch
/bwa banlist
/setup — Arena Setup Commands
Permission: bedwars.setup (default: op)
Note: Must be in setup mode first using /bwa setup <arena>. In setup mode you get a blaze rod wand.
| Subcommand |
Arguments |
Description |
help |
— |
Shows setup help menu |
setspawn |
<team> |
Set the team's spawn point at your current location |
setbed |
<team> |
Set the team's bed location (stand near the bed and look at it; sets both head and foot automatically) |
setgenerator |
<type> |
Place a generator at your location. Types: IRON, GOLD, DIAMOND, EMERALD |
setshop |
— |
Place a shop NPC at your current location |
setupgrade |
— |
Place an upgrade NPC at your current location |
setregion |
— |
Save the arena region using the two corners selected with your blaze rod wand (left-click = corner 1, right-click = corner 2) |
done |
— |
Finalize and save the arena configuration, exit setup mode |
Examples:
/bwa setup MyArena (enter setup mode)
/setup setspawn Red
/setup setbed Blue
/setup setgenerator IRON
/setup setgenerator DIAMOND
/setup setshop
/setup setupgrade
/setup setregion (select corners with wand first)
/setup done (save and exit)
Permissions
| Permission |
Default |
Description |
bedwars.play |
true |
Access to player commands and gameplay |
bedwars.admin |
op |
Access to admin commands |
bedwars.setup |
op |
Access to arena setup commands |
bedwars.bypass |
op |
Bypass block/game restrictions (place/break during game, join started games) |
Placeholders (PlaceholderAPI)
All placeholders use the %lbedwars_<placeholder>% format.
Stats
| Placeholder |
Type |
Description |
%lbedwars_kills% |
int |
Total kills |
%lbedwars_deaths% |
int |
Total deaths |
%lbedwars_kd% |
float |
Kill/death ratio (2 decimal places) |
%lbedwars_finalkills% |
int |
Final kills |
%lbedwars_finaldeaths% |
int |
Final deaths |
%lbedwars_finalkd% |
float |
Final kill/death ratio (2 decimal places) |
%lbedwars_wins% |
int |
Total wins |
%lbedwars_losses% |
int |
Total losses |
%lbedwars_wlr% |
float |
Win/loss ratio (2 decimal places) |
%lbedwars_bedsbroken% |
int |
Beds broken |
%lbedwars_gamesplayed% |
int |
Games played |
%lbedwars_winstreak% |
int |
Current win streak |
Level & XP
| Placeholder |
Type |
Description |
%lbedwars_level% |
int |
Current level (1–100) |
%lbedwars_xp% |
int |
Current XP amount |
%lbedwars_xp_required% |
int |
XP required to reach next level |
%lbedwars_xp_percent% |
float |
Progress to next level as percentage (0–100) |
%lbedwars_xp_progress% |
string |
Progress bar (20 segments, filled/unfilled) |
Economy
| Placeholder |
Type |
Description |
%lbedwars_balance% |
int |
Balance (integer, rounded down) |
%lbedwars_balance_formatted% |
string |
Balance with formatting |
Cosmetics
| Placeholder |
Type |
Description |
%lbedwars_active_killeffect% |
string |
Name of active kill effect |
%lbedwars_active_victorydance% |
string |
Name of active victory dance |
%lbedwars_active_trail% |
string |
Name of active projectile trail |
%lbedwars_active_victorysong% |
string |
Name of active victory song |
Arena (real-time — only shows data when player is in an arena)
| Placeholder |
Type |
Description |
%lbedwars_arena% |
string |
Current arena name |
%lbedwars_gamestate% |
string |
Current game state (WAITING / STARTING / PLAYING / ENDING) |
%lbedwars_gametime% |
string |
Game elapsed time in MM:SS format |
%lbedwars_isplaying% |
string |
YES if playing, NO otherwise |
%lbedwars_isspectating% |
string |
YES if spectating, NO otherwise |
%lbedwars_players% |
int |
Current player count in arena |
%lbedwars_maxplayers% |
int |
Maximum player count in arena |
%lbedwars_team% |
string |
Team name |
%lbedwars_teamcolor% |
string |
Team color code (e.g., &c) |
%lbedwars_team_colored% |
string |
Team name with color codes applied |
%lbedwars_teammates% |
int |
Total teammates in the team |
%lbedwars_teammates_alive% |
int |
Alive teammates |
%lbedwars_hasbed% |
string |
YES if bed is alive, NO otherwise |
Position Leaderboards (requires online database)
%lbedwars_position_kills%
%lbedwars_position_wins%
%lbedwars_position_final-kills%
%lbedwars_position_beds-broken%
Returns the player's ranking position (integer).
rewards.yml — Game Event Rewards
| Path |
Type |
Default |
Description |
game-rewards.kill-xp |
int |
10 |
XP earned per kill |
game-rewards.win-xp |
int |
60 |
XP earned per win |
game-rewards.bed-break-xp |
int |
30 |
XP earned per bed break |
game-rewards.final-kill-xp |
int |
20 |
XP earned per final kill |
game-rewards.kill-coins |
int |
5 |
Coins earned per kill |
game-rewards.win-coins |
int |
30 |
Coins earned per win |
battlepass.yml — Battle Pass Settings
| Path |
Type |
Default |
Description |
battlepass.enabled |
boolean |
false |
Enable the Battle Pass system |
battlepass.contribute-to-bp |
boolean |
true |
If true, XP earned in games also contributes to battle pass progress |
battlepass.tiers |
int |
50 |
Number of tiers in the pass |
battlepass.xp-per-tier |
int |
250 |
XP required per tier |
battlepass.rewards.free.<tier> |
list |
— |
Free reward commands per tier |
battlepass.rewards.premium.<tier> |
list |
— |
Premium reward commands per tier |
cosmetics.yml — Cosmetics Configuration
| Path |
Type |
Default |
Description |
kill-effects.<name>.material |
string |
— |
Display material in GUI |
kill-effects.<name>.price |
int |
— |
Price in coins |
kill-effects.<name>.permission |
string |
— |
Required permission node |
kill-effects.<name>.effect |
string |
— |
Effect type (e.g., LIGHTNING, HEART, NOTE, SMOKE, FLAME, EXPLOSION, CRIT, SPELL) |
victory-dances.* |
— |
— |
Same structure as kill effects |
death-cries.* |
— |
— |
Same structure with sound name |
trails.* |
— |
— |
Same structure with particle type |
island-toppers.* |
— |
— |
Same structure with block material |
victory-songs.* |
— |
— |
Same structure with NBS filename |
dailyrewards.yml — Daily Reward Settings
| Path |
Type |
Default |
Description |
enabled |
boolean |
true |
Enable daily rewards |
xp |
int |
50 |
XP reward amount |
coins |
int |
25 |
Coins reward amount |
money |
double |
100.0 |
Money reward amount (Vault) |
cooldown |
int |
24 |
Cooldown in hours |
shop/<mode>.yml — Shop Configuration
Structure per category:
categories:
<category_name>:
item: <material> # Display item in shop GUI
name: "<display name>" # Category display name
lore:
- "<lore line>" # Category lore
items:
- material: <material> # Item to buy
name: "<display name>" # Item display name
lore: # Item lore
- "<lore line>"
price-type: IRON|GOLD|DIAMOND|EMERALD
price: <amount> # Cost
amount: <count> # Quantity received
reward-commands: # Commands run on purchase (optional)
- "<command>"
upgrades/<mode>.yml — Upgrade Configuration
Structure per upgrade:
upgrades:
<upgrade_name>:
name: "<display name>"
item: <material>
lore:
- "<lore line>"
max-tier: <tier_count>
costs:
- <diamond_cost> # One cost per tier (list)
values:
- <value> # One value per tier (list)
Default upgrades: sharpened-swords, reinforced-armor, dragon-buff, heal-pool, forge, trap, alarm-trap.
arenas/<arena>/config.yml — Arena Definition
Auto-generated during setup. Contains:
- Mode and display name
- Team definitions: color, name, spawn location, bed location + facing direction, bed foot location
- Generator locations: iron, gold, diamond, emerald positions
- NPC locations: shop and upgrade NPC coordinates
- Region bounds: min/max X, Y, Z coordinates
- Lobby location: waiting lobby spawn point
- Spectator spawn: spectator observation location
Dependencies
Required:
- Paper 1.19+ (or Folia/Spigot with Paper API)
Soft dependencies (optional):
| Plugin |
Purpose |
| PlaceholderAPI |
Placeholder expansion for %lbedwars_*% |
| Vault |
Economy integration for shop purchases |
| NoteBlockAPI |
Victory song playback (.nbs files) |
| Parties (alessiodp) |
Party queue system |
Proxy Module
A companion BungeeCord/Velocity plugin (L-BedWarsProxy) for multi-server networks.
Features
- Smart Joining:
/bw join <mode> finds the best available arena server and connects the player
- Queue System: If all servers are full, players queue and auto-connect when a slot opens
- Party Support: Party leader's queue state is shared, all members connect together
- Server Status Broadcasting: Game servers report arena states via TCP (configurable port)
- Server MOTD: Displays current arena status and player counts on the server list
- Cross-Server Spectate: Admin spectate any player across servers
- Leaderboard Holograms: Placeable holograms showing top players per stat (kills, wins, final kills, beds broken, deaths, final deaths, losses, games played)
Proxy Commands
/bw — Join Commands (no permission required)
| Subcommand |
Arguments |
Description |
join |
<mode> |
Find and connect to best available arena |
rejoin |
— |
Reconnect to your previous game server |
stats |
[player] |
View stats GUI |
battlepass / bp |
— |
Open Battle Pass GUI |
/bwa — Admin Commands (permission: lbedwarsproxy.admin, default: op)
| Subcommand |
Arguments |
Description |
gui |
[filter] |
Open arena browser UI (filter: all, solo, duo, trio, quad) |
tp |
<player> |
Teleport to and spectate a player across servers |
leaderboard |
[stat] |
Open leaderboard GUI (stat: kills, wins, final_kills, beds_broken) |
hologram set |
[stat] |
Place a leaderboard hologram |
hologram remove |
[id] |
Remove a hologram by ID |
hologram list |
— |
List all placed holograms |
ban |
[duration] <player> <reason> |
Proxy-wide ban |
unban |
<player> |
Proxy-wide unban |
banlist |
[page] |
View banned players |
SUPPORT
discord: squezsaz
discord:
评论 0
登录后参与评分
还没有评论,来抢沙发吧