- 版权类型
- 原创
- 插件英文名称
- bedwarsbo6
- Plugin Name
- BedWarsBO6
- 支持的核心
- Bukkit
- Spigot
- Paper
- 其他Spigot下游
- 其他Paper下游
- 资源语言
- 简体中文
- 英语
- 支持版本(Java)
- 1.8
- 开源许可证
- 保留所有权益/无许可证
# BedWarsBO6 · 极速攻防(1v1 / 2v2 / 3v3)
> 版本:2.5.1 | 服务端:Spigot / Paper **1.8.8**(客户端 1.8.9) | 数据库:本地文件 / SQLite / MySQL(可选 Redis 缓存)
BedWarsBO6 是 Hypixel 起床战争「极速轮换攻防」玩法的 **BO6 定制版**:不再是"拆床即终局",而是一场最多 **6 小局**的攻防轮换赛 —— 每小局由擂台拼刀决定谁先挑**进攻方 / 防守方**,进攻方限时突破、防守方死守到底,先到 4 分拿下整场。
---
## 一、游戏内容
### 1.1 三种档位
| 档位 | 人数 | 每队人数 |
|------|------|----------|
| 1v1 | 2 | 1 |
| 2v2 | 4 | 2 |
| 3v3 | 6 | 3 |
不再提供 4v4。进房后先用红石火把选队(红 / 蓝 / 自动分配),人满倒计时 10 秒开局。
### 1.2 一整场的流程
1. **等待大厅** —— 每张地图有自己的等待大厅;可自选红 / 蓝队,不选则由系统在开局前按人数均衡分配。
2. **满员倒计时** —— 人满后倒数,倒数期间退出会回到等待状态。
3. **拼刀 / 选边擂台** —— 双方站上擂台,把对手推下去的一方获得**首局身份选择权**(擂台时限 90 秒,超时随机抽取)。
4. **投票选边** —— 胜方全队投票决定当进攻方还是防守方(15 秒,多数票生效;1v1 由胜者一人决定)。
5. **小局开打** —— 进攻方突入防守方基地,防守方死守。
6. **轮换** —— 每小局结束交换攻守身份,最多 **6 局**。
7. **加时** —— 常规打完仍平手则进入加时:比分从 0:0 重新计算,先到 3 分且领先者胜;加时最多 6 局,仍分不出按配置判平 / 继续。
8. **结算** —— 展示比分、击杀 / 死亡 / 拆床与本场经验,随后送回主大厅。
### 1.3 胜负与复活
- **先到 4 分**赢下整场(6 局上限);单局 12 分钟(720 秒)到点未分出则判该局平局、双方各得 1 分。
- **进攻方每局 4 条命**,**防守方无限复活**;死亡约 5 秒后重生(每小局重置复活次数)。
- 击杀归属判定:被打后 30 秒内死亡才算击杀,超时算自杀。
- 死亡保留护甲、清空武器与工具;**战靴永久保留**(出生自带、死了不掉)。便宜装备与稀有装备分别在死亡时按配置清除。
### 1.4 资源与经济
- 基地**铁 / 金生成点**持续产出(整体倍速 1.05,每 2 秒出一次铁,每 6 次铁出一次金)。
- **钻石靠击杀掉落**,出生点默认不产钻石(可开)。
- 地面掉落物 60 秒自动消失,每个刷新点堆积上限可配(铁 64 / 金 32 / 钻石 16),避免卡顿。
- 商店分**方块 / 武器 / 护甲 / 工具 / 消耗品 / 弓箭**等分类,支持**快捷购买页**(新号自带 Hypixel 同款默认模板,右键即可增删,镐 / 斧自动显示"当前该买的那一档")。
### 1.5 团队升级与陷阱
用钻石购买,**全队生效**,下一小局重置(可配置为整场保留):
| 升级 | 效果 |
|------|------|
| 锋利 | 全队剑附魔锋利(1 级封顶) |
| 保护 | 全队护甲保护 I ~ IV(逐级购买) |
| 急迫 | 全队急迫 I / II,挖方块拆羊毛更快 |
| 团队陷阱 | 敌人踏入基地触发:失明 + 缓慢 + 挖掘疲劳(半径 5 格,冷却 30 秒) |
升级按档位定价:档位越高、每级越贵(1v1 最便宜,3v3 最贵)。
### 1.6 爆炸与地形保护
- TNT **放置即点燃**(3 秒引信),爆炸威力 6.0(原版 4.0),拆床更凶。
- 爆炸**只破坏玩家本局放置的方块**,地图原始地形一律保留,回合结束整场方块自动回滚成建图初始状态。
- **床不会被 TNT 炸毁**,只能被玩家手动破坏。
- **玻璃 / 染色玻璃 / 玻璃板免疫爆炸**,且被玻璃挡住的方块(例如玩家把羊毛搭进玻璃房里)同样免疫 —— 从爆炸中心到目标方块做逐格射线检测,玻璃墙护住的东西炸不掉。
### 1.7 等级与每日任务
- 聊天前缀显示等级星:`[100★] 玩家名`,星星按等级换色(1 / 100 / 200 … 1200 级各有专属颜色),**1000 级以上数字变彩虹色**。
- **每级固定 5000 经验**。击杀 +10、拆床 +50、胜 +250、负 +50、平 +50。
- 每场对局经验上限 2000(可选"每小局"重新计满);每日任务奖励不占这个额度,一天打多少局都不封顶。
- **每日任务**(0 点重置):击杀 60 人 +5000 经验、拆床 12 张 +5000 经验。
- 中途弃赛会收回本场已发放的对局经验(任务奖励不回收)。
### 1.8 组队
- `/p` 一键组队:**队长带队进对局**,整支队伍必定被分到同一颜色(防内奸窥屏)。
- 队伍人数不设硬上限,进对局时按人数自动挑档位(2 人 → 2v2、3 人 → 3v3、4 人 → 2v2 包场、6 人 → 3v3 包场)。
- 队伍数据持久化:打完一把不散队,服务器重启也还在。
- 队员离线 5 分钟自动退队;队长离线满 5 分钟自动移交给在线队员;全队离线满 5 分钟自动解散。
- 不一定要用内置组队:关掉后插件可自动识别外部组队插件带进来的人(3 秒内先后进入同一档位视为一队)。
### 1.9 聊天分流
- **`/chat all`(默认)**:对局中发的消息只有本方队友看到,大厅里发的只有同样在大厅的人看到 —— 不会出现"大厅刷屏干扰对局"。
- **`/chat party`**:组队私聊,只有队员可见;不在组队里用不了。
- 对局中不屏蔽对手需要喊话时用 `/shout`。
### 1.10 数据与存档
- 存储可选 **LOCAL(本地文件,开箱即用)/ SQLITE / MYSQL**,并可叠加 Redis 缓存。
- 记录战绩、经验、快捷购买配置;每场对局生成存档(`matches/*.yml`),可随时回看。
- 每小局开始自动清空场地容器(箱子 / 末影箱等),上一局的残留物品不会带到下一局。
---
## 二、指令大全
> 主指令别名:`bw`、`bo6`、`bedwars`。权限:`bwbo6.use`(默认所有人)、`bwbo6.admin`(默认 OP)。
### 2.1 玩家指令
| 指令 | 作用 |
|------|------|
| `/bwb` | 查看帮助 |
| `/bwb join <1v1\|2v2\|3v3>` | 加入对应档位房间 |
| `/bwb leave` | 离开房间返回等待大厅 |
| `/bwb menu` | 打开档位选择菜单(显示总游玩人数 / 空闲服务器) |
| `/bwb shop` | 打开物品商店 |
| `/bwb upgrade` | 打开团队升级商人(锋利 / 保护 / 急迫 / 陷阱) |
| `/bwb choose <attack\|defend>` | 选边阶段投出首局身份(也可点菜单) |
| `/bwb status` | 查看当前对局状态(比分 / 局数 / 状态) |
| `/bwb level [玩家]` 或 `/level` | 查看起床等级与升级进度(别名 `lv`、`bwlevel`) |
| `/bwb gg` | 队友掉线超时未归后投降(本场战绩不计、经验不计入) |
| `/rejoin`(`re`) | 重新加入上一场对局 |
| `/hub`(`lobby`) | 回到选图大厅 / 退出当前对局 |
| `/shout <消息>`(`sh`、`all`) | 全服喊话,对局中也能让所有人看到 |
| `/chat <all\|party> [消息]`(`ch`、`c`) | 切换聊天频道;带消息则只发这一条 |
### 2.2 组队指令 `/party`(别名 `p`、`pt`)
| 指令 | 作用 |
|------|------|
| `/p create` | 创建组队(你当队长) |
| `/p invite <玩家>` | 邀请玩家(对方需 `/p accept`,60 秒有效) |
| `/p accept` / `/p deny` | 同意 / 拒绝最近一条邀请 |
| `/p join [1v1\|2v2\|3v3]` | **队长**带队进同一场(不写档位按人数自动选) |
| `/p warp` | 把全队在线成员传送到你身边;你已在房间里则队员一并入局 |
| `/p list` | 查看队员与组队状态(旧名 `/p info` 仍兼容) |
| `/p kick <玩家>` | 踢人(队长) |
| `/p transfer <玩家>` | 转移队长(队长) |
| `/p mute [玩家]` / `/p unmute <玩家>` | 静音全队 / 某队员 |
| `/p chat <消息>` | 队伍频道发言(也可直接 `/p <消息>`) |
| `/p leave` / `/p disband` | 退队 / 解散(队长) |
### 2.3 管理员指令(`bwbo6.admin`)
| 指令 | 作用 |
|------|------|
| `/bwb start` | 强制开局(无需开 debug,无视满员;需在房间内) |
| `/bwb draw` | 强制把本场判为平局(需在房间内) |
| `/bwb reload` | 重载全部配置 |
| `/bwb build` | 切换建造模式(地图默认受保护) |
| `/bwb setmainlobby` | 把当前位置设为全局主大厅(上线 / 离房 / 结算后的统一落点) |
| `/bwb match <list\|view\|player>` | 查看对局:`view <玩家名>` 实时对局,历史存档在 `matches/*.yml`,`player` 支持翻页 |
| `/bwb check <玩家名>` | 打开该玩家数据菜单(历史对局 + 总数据) |
| `/bwb arena <...>` | 竞技场(地图)配置,见下节 |
| `/bwb db <test\|readtest\|writetest\|cache clear\|migrate\|resetroom\|checkdata\|fallback>` | 存储调试与数据迁移 |
| `/bwbdebug <db\|start\|roundwin\|setscore\|board\|respawn\|stats\|sumoend>`(别名 `bwdebug`、`bwd`) | 对局调试(调试总开关默认关闭) |
### 2.4 建图指令 `/bwb arena`
按 1 → 10 的顺序走完,插件会在保存时自动做完整度检测(坐标点 + 擂台 + 图内商人 NPC 齐全才允许保存):
```
1. /bwb arena create <名称> <1v1|2v2|3v3|ALL> 新建一张地图
2. /bwb arena setwaitlobby <名称> 站在图内设本图等待大厅
3. /bwb arena setsumo <名称> 设选边拼刀擂台点(兼任中心点)
4. /bwb arena setsumo <名称> red 红方站位点(蓝方用 blue)
5. /bwb arena setspawn <名称> att 站在攻方基地设出生点(无床)
6. /bwb arena setspawn <名称> def 站在守方基地设出生点
7. /bwb arena setbed <名称> def 在守方基地设床点(全图仅 1 个)
8. /bwb arena addgen <名称> <iron|gold> 资源生成点(需 4 个)
9. /bwb arena npc spawn <shop|upgrade> 在图内放置菜单 NPC
10. /bwb arena save 保存
```
其他:`setspectator`(观战点,可选)、`info <名称>`(查看属性)、`list`(列出地图)、`delgen`(清空生成点)、`tp <名称>`(传送)、`remove <名称>`(删除)、`import`(导入 zip 地图)。
---
## 三、配置文件介绍
全部位于 `plugins/BedWarsBO6/config/`,改完用 **`/bwb reload`** 生效。
### 3.1 `config.yml` —— 主配置
| 段落 | 关键项 | 说明 |
|------|--------|------|
| `database` | `storage_mode` | `LOCAL`(本地文件,开箱即用)/ `SQLITE` / `MYSQL`;本地数据自动存档间隔、损坏自动重建 |
| | `redis` | 可选缓存层,无 Redis 自动退回内存;`server_id` 用于多服共库区分 |
| `language` | — | `zh-cn` 读 `messages.yml`,`en` 读 `messages_en.yml` |
| `basic` | `max_round` / `win_score` | 常规 6 局、先到 4 分胜 |
| | `lobby_countdown_time` | 满员后倒计时(默认 10 秒) |
| | `round_time_limit` | 单小局时限(720 秒),到点平局各 1 分 |
| | `round_intermission` / `finish_delay` | 局间休息 5 秒、结算后 8 秒回大厅 |
| `overtime` | `win_score` / `max_rounds` / `on_max_rounds` | 加时从 0:0 起、先到 3 分、最多 6 局,打满判平 / 继续 |
| `respawn` | `attacker_lives` / `defender_lives` | 进攻方 4 条命,防守方 `-1` = 无限复活;`respawn_tick` 100 = 5 秒 |
| `resource` | `iron_gold_speed_rate` 等 | 铁金倍速、出铁间隔、几次铁出一次金、钻石是否基地产出与击杀掉落数、掉落物过期与刷新点堆积上限 |
| `npc` | `silent` | 商人静音,不再哼唧 |
| `data_save` | `clear_item_per_round` 等 | 每小局清背包、团队升级是否整场保留、死亡是否清装备、永久战靴、死亡保留护甲 |
| `side_choose` | `mode` / `sumo_time` | 选边方式(SUMO)、擂台时限 90 秒、掉台判定低 6 格、超时随机抽人、投票 15 秒 / 平票随机 |
| `level` | `xp_per_level` 等 | 每级 5000 经验、每场上限 2000(`MATCH` / `ROUND`)、击杀 / 拆床 / 胜负经验、1000 级彩虹色、星级颜色表;`prefix_format` 控制聊天等级前缀样式 |
| | `quests` | 每日任务:击杀 60 / 拆床 12,各奖 5000 经验 |
| `enchant` | `trap_radius` / `trap_cooldown` | 陷阱半径 5 格、冷却 30 秒;可禁用附魔台与 `/enchant` |
| `shop` | `enable_quick_buy` / `quick_buy_slots` | 快捷购买开关与格子数(默认 27) |
| `board` | `refresh_tick` / `enable_lobby_board` | 计分板刷新频率(卡就调到 4~10)、大厅是否显示计分板 |
| `build` | `require_command` | 地图默认锁定,需 `/bwb build` 才能编辑 |
| `lobby` / `main_lobby` | 坐标 | 选图大厅落点;主大厅用 `/bwb setmainlobby` 设置(未设则回退到主世界出生点) |
| `starter` | `give_sword` / `give_boots` / `extra_items` | 初始装备与额外物品 |
| `explosion` | `tnt_power` | TNT 威力(默认 6.0,8.0 以上容易一炮清空半张床的防护) |
| `team` | `party_same_team` | 同组队必分同色(防内奸) |
| `party` | `enabled` / `auto_mode` / `detect_external` / `offline_kick_seconds` | 内置组队总开关、按人数自动挑档位、识别外部组队插件、离线 5 分钟自动退队 |
| `debug` | `enable_debug_mode` 等 | 调试总开关与日志开关,**默认全关,线上别开** |
### 3.2 `shop.yml` —— 物品商店
- 版面:第 1 行 `slot 0~7` = 分类页签,`slot 8` = 「我的资源」余额(勿占用);第 2~5 行 = 商品;第 6 行 = 翻页箭头。
- 通用字段:`id` / `slot` / `page` / `material` / `amount` / `display` / `cost_type` / `cost` / `enchant` / `potion` / `lore` / `data` / `color`。
- `quickbuy_default`:新号默认快捷购买模板(Hypixel 同款 3 排)。镐 / 斧**只占一格**且自动显示当前该买的档位,满级后自动隐藏。
- 可放置方块发放时会去掉自定义名称与 lore,保证和挖出来的方块能叠加。
### 3.3 `enchant.yml` —— 团队升级商人
- 页签:锋利 / 保护 / 急迫 / 陷阱,各自 `display`、`material`、`desc`。
- 定价公式:**实际价格 = 该级基准价 + step ×(每队人数 − 1)**,所以 3v3 每级都比 2v2 贵、2v2 比 1v1 贵,同级之间也逐级递增;`mode_cost.enabled: false` 可让所有档位同价。
- 购买后全队生效、不死掉落、重生自动补附魔;每小局重置。
### 3.4 `scoreboard.yml` —— 计分板文案
按场景分段,每段 `title` + `lines`:`lobby`(大厅)、`waiting`(等待大厅)、`countdown`(开局倒计时)、`sumo`(拼刀擂台)、`side_pick`(投票选边)、`round`(小局进行)、`finished`(结算)。
可用占位符:`{online}` `{mode}` `{players}` `{max}` `{redcount}` `{bluecount}` `{teammax}` `{unassigned}` `{countdown}` `{sumotime}` `{redkill}` `{bluekill}` `{sidewinner}` `{sidevotea}` `{sidevoted}` `{sidepick}` `{round}` `{maxround}` `{time}` `{red}` `{blue}` `{overtime}` `{attacker}` `{defender}` `{kills}` `{deaths}` `{respawn}` `{maxrespawn}` `{upgrade}` `{champion}` `{level}` `{levelbar}` `{levelpct}`。
`hide-numbers: true` 可隐藏右侧红字数字;行内容超过 16 字符由插件自动拆成 prefix / suffix 并继承颜色。
### 3.5 `menus.yml` —— 菜单
- `side_pick`:选边投票菜单(进攻 / 防守)。
- `team_select`:等待大厅「选择队伍」菜单(红队 / 蓝队 / 自动分配),占位符含红蓝人数、剩余空位、当前所在队、队伍规模等。
- `mode_select`:档位菜单项配置(图标材质、槽位、文案)。实际档位图标由插件生成,显示「总游玩人数 · 空闲服务器」与当前是否可加入。
### 3.6 `messages.yml` / `messages_en.yml` —— 全部游戏文案
- 所有提示、广播、菜单文案、结算文案都在这里,支持 `{0}` `{1}` … 占位符。
- 支持 `\n` 换行(会按行拆分发送),便于写多行提示。
- 中英文切换由 `config.yml` 的 `language` 决定;可复制 `messages.yml` 改名为 `messages_<语言>.yml` 做自己的语言包。
- 键缺失时不会把 key 名显示给玩家,代码里都有默认文案兜底。
### 3.7 `arenas.yml` —— 地图数据
- 由 `/bwb arena` 系列指令**自动写入**,记录每张地图的等待大厅、擂台与红蓝站位点、攻守出生点、床点、资源生成点、观战点、图内 NPC。
- **不建议手动编辑**,改错会导致地图不完整、无法开局。
### 3.8 目录结构一览
```
plugins/BedWarsBO6/
├── config/ # 全部配置(改完 /bwb reload)
│ ├── config.yml # 主配置:对局规则 / 等级 / 组队 / 存储
│ ├── shop.yml # 物品商店与快捷购买
│ ├── enchant.yml # 团队升级(锋利 / 保护 / 急迫 / 陷阱)
│ ├── scoreboard.yml
│ ├── menus.yml
│ ├── messages.yml / messages_en.yml
│ └── arenas.yml # 地图数据(插件自动写)
├── cache/ # 对局临时数据(打完即清)
├── stats/ # 玩家数据(战绩 / 经验 / 快捷购买)
└── matches/ # 每场对局存档,可回看
```
---
## 四、快速上手
1. 把插件放进 `plugins/`,启动一次生成默认配置。
2. 建图:按 **2.4 节**的 1 → 10 顺序跑完 `/bwb arena ...`,最后 `save` 通过完整度检测。
3. 设主大厅:站到落点打 `/bwb setmainlobby`。
4. `/bwb reload` 重载,玩家右键指南针即可选档位开局。
> 版本:2.5.1 | 服务端:Spigot / Paper **1.8.8**(客户端 1.8.9) | 数据库:本地文件 / SQLite / MySQL(可选 Redis 缓存)
BedWarsBO6 是 Hypixel 起床战争「极速轮换攻防」玩法的 **BO6 定制版**:不再是"拆床即终局",而是一场最多 **6 小局**的攻防轮换赛 —— 每小局由擂台拼刀决定谁先挑**进攻方 / 防守方**,进攻方限时突破、防守方死守到底,先到 4 分拿下整场。
---
## 一、游戏内容
### 1.1 三种档位
| 档位 | 人数 | 每队人数 |
|------|------|----------|
| 1v1 | 2 | 1 |
| 2v2 | 4 | 2 |
| 3v3 | 6 | 3 |
不再提供 4v4。进房后先用红石火把选队(红 / 蓝 / 自动分配),人满倒计时 10 秒开局。
### 1.2 一整场的流程
1. **等待大厅** —— 每张地图有自己的等待大厅;可自选红 / 蓝队,不选则由系统在开局前按人数均衡分配。
2. **满员倒计时** —— 人满后倒数,倒数期间退出会回到等待状态。
3. **拼刀 / 选边擂台** —— 双方站上擂台,把对手推下去的一方获得**首局身份选择权**(擂台时限 90 秒,超时随机抽取)。
4. **投票选边** —— 胜方全队投票决定当进攻方还是防守方(15 秒,多数票生效;1v1 由胜者一人决定)。
5. **小局开打** —— 进攻方突入防守方基地,防守方死守。
6. **轮换** —— 每小局结束交换攻守身份,最多 **6 局**。
7. **加时** —— 常规打完仍平手则进入加时:比分从 0:0 重新计算,先到 3 分且领先者胜;加时最多 6 局,仍分不出按配置判平 / 继续。
8. **结算** —— 展示比分、击杀 / 死亡 / 拆床与本场经验,随后送回主大厅。
### 1.3 胜负与复活
- **先到 4 分**赢下整场(6 局上限);单局 12 分钟(720 秒)到点未分出则判该局平局、双方各得 1 分。
- **进攻方每局 4 条命**,**防守方无限复活**;死亡约 5 秒后重生(每小局重置复活次数)。
- 击杀归属判定:被打后 30 秒内死亡才算击杀,超时算自杀。
- 死亡保留护甲、清空武器与工具;**战靴永久保留**(出生自带、死了不掉)。便宜装备与稀有装备分别在死亡时按配置清除。
### 1.4 资源与经济
- 基地**铁 / 金生成点**持续产出(整体倍速 1.05,每 2 秒出一次铁,每 6 次铁出一次金)。
- **钻石靠击杀掉落**,出生点默认不产钻石(可开)。
- 地面掉落物 60 秒自动消失,每个刷新点堆积上限可配(铁 64 / 金 32 / 钻石 16),避免卡顿。
- 商店分**方块 / 武器 / 护甲 / 工具 / 消耗品 / 弓箭**等分类,支持**快捷购买页**(新号自带 Hypixel 同款默认模板,右键即可增删,镐 / 斧自动显示"当前该买的那一档")。
### 1.5 团队升级与陷阱
用钻石购买,**全队生效**,下一小局重置(可配置为整场保留):
| 升级 | 效果 |
|------|------|
| 锋利 | 全队剑附魔锋利(1 级封顶) |
| 保护 | 全队护甲保护 I ~ IV(逐级购买) |
| 急迫 | 全队急迫 I / II,挖方块拆羊毛更快 |
| 团队陷阱 | 敌人踏入基地触发:失明 + 缓慢 + 挖掘疲劳(半径 5 格,冷却 30 秒) |
升级按档位定价:档位越高、每级越贵(1v1 最便宜,3v3 最贵)。
### 1.6 爆炸与地形保护
- TNT **放置即点燃**(3 秒引信),爆炸威力 6.0(原版 4.0),拆床更凶。
- 爆炸**只破坏玩家本局放置的方块**,地图原始地形一律保留,回合结束整场方块自动回滚成建图初始状态。
- **床不会被 TNT 炸毁**,只能被玩家手动破坏。
- **玻璃 / 染色玻璃 / 玻璃板免疫爆炸**,且被玻璃挡住的方块(例如玩家把羊毛搭进玻璃房里)同样免疫 —— 从爆炸中心到目标方块做逐格射线检测,玻璃墙护住的东西炸不掉。
### 1.7 等级与每日任务
- 聊天前缀显示等级星:`[100★] 玩家名`,星星按等级换色(1 / 100 / 200 … 1200 级各有专属颜色),**1000 级以上数字变彩虹色**。
- **每级固定 5000 经验**。击杀 +10、拆床 +50、胜 +250、负 +50、平 +50。
- 每场对局经验上限 2000(可选"每小局"重新计满);每日任务奖励不占这个额度,一天打多少局都不封顶。
- **每日任务**(0 点重置):击杀 60 人 +5000 经验、拆床 12 张 +5000 经验。
- 中途弃赛会收回本场已发放的对局经验(任务奖励不回收)。
### 1.8 组队
- `/p` 一键组队:**队长带队进对局**,整支队伍必定被分到同一颜色(防内奸窥屏)。
- 队伍人数不设硬上限,进对局时按人数自动挑档位(2 人 → 2v2、3 人 → 3v3、4 人 → 2v2 包场、6 人 → 3v3 包场)。
- 队伍数据持久化:打完一把不散队,服务器重启也还在。
- 队员离线 5 分钟自动退队;队长离线满 5 分钟自动移交给在线队员;全队离线满 5 分钟自动解散。
- 不一定要用内置组队:关掉后插件可自动识别外部组队插件带进来的人(3 秒内先后进入同一档位视为一队)。
### 1.9 聊天分流
- **`/chat all`(默认)**:对局中发的消息只有本方队友看到,大厅里发的只有同样在大厅的人看到 —— 不会出现"大厅刷屏干扰对局"。
- **`/chat party`**:组队私聊,只有队员可见;不在组队里用不了。
- 对局中不屏蔽对手需要喊话时用 `/shout`。
### 1.10 数据与存档
- 存储可选 **LOCAL(本地文件,开箱即用)/ SQLITE / MYSQL**,并可叠加 Redis 缓存。
- 记录战绩、经验、快捷购买配置;每场对局生成存档(`matches/*.yml`),可随时回看。
- 每小局开始自动清空场地容器(箱子 / 末影箱等),上一局的残留物品不会带到下一局。
---
## 二、指令大全
> 主指令别名:`bw`、`bo6`、`bedwars`。权限:`bwbo6.use`(默认所有人)、`bwbo6.admin`(默认 OP)。
### 2.1 玩家指令
| 指令 | 作用 |
|------|------|
| `/bwb` | 查看帮助 |
| `/bwb join <1v1\|2v2\|3v3>` | 加入对应档位房间 |
| `/bwb leave` | 离开房间返回等待大厅 |
| `/bwb menu` | 打开档位选择菜单(显示总游玩人数 / 空闲服务器) |
| `/bwb shop` | 打开物品商店 |
| `/bwb upgrade` | 打开团队升级商人(锋利 / 保护 / 急迫 / 陷阱) |
| `/bwb choose <attack\|defend>` | 选边阶段投出首局身份(也可点菜单) |
| `/bwb status` | 查看当前对局状态(比分 / 局数 / 状态) |
| `/bwb level [玩家]` 或 `/level` | 查看起床等级与升级进度(别名 `lv`、`bwlevel`) |
| `/bwb gg` | 队友掉线超时未归后投降(本场战绩不计、经验不计入) |
| `/rejoin`(`re`) | 重新加入上一场对局 |
| `/hub`(`lobby`) | 回到选图大厅 / 退出当前对局 |
| `/shout <消息>`(`sh`、`all`) | 全服喊话,对局中也能让所有人看到 |
| `/chat <all\|party> [消息]`(`ch`、`c`) | 切换聊天频道;带消息则只发这一条 |
### 2.2 组队指令 `/party`(别名 `p`、`pt`)
| 指令 | 作用 |
|------|------|
| `/p create` | 创建组队(你当队长) |
| `/p invite <玩家>` | 邀请玩家(对方需 `/p accept`,60 秒有效) |
| `/p accept` / `/p deny` | 同意 / 拒绝最近一条邀请 |
| `/p join [1v1\|2v2\|3v3]` | **队长**带队进同一场(不写档位按人数自动选) |
| `/p warp` | 把全队在线成员传送到你身边;你已在房间里则队员一并入局 |
| `/p list` | 查看队员与组队状态(旧名 `/p info` 仍兼容) |
| `/p kick <玩家>` | 踢人(队长) |
| `/p transfer <玩家>` | 转移队长(队长) |
| `/p mute [玩家]` / `/p unmute <玩家>` | 静音全队 / 某队员 |
| `/p chat <消息>` | 队伍频道发言(也可直接 `/p <消息>`) |
| `/p leave` / `/p disband` | 退队 / 解散(队长) |
### 2.3 管理员指令(`bwbo6.admin`)
| 指令 | 作用 |
|------|------|
| `/bwb start` | 强制开局(无需开 debug,无视满员;需在房间内) |
| `/bwb draw` | 强制把本场判为平局(需在房间内) |
| `/bwb reload` | 重载全部配置 |
| `/bwb build` | 切换建造模式(地图默认受保护) |
| `/bwb setmainlobby` | 把当前位置设为全局主大厅(上线 / 离房 / 结算后的统一落点) |
| `/bwb match <list\|view\|player>` | 查看对局:`view <玩家名>` 实时对局,历史存档在 `matches/*.yml`,`player` 支持翻页 |
| `/bwb check <玩家名>` | 打开该玩家数据菜单(历史对局 + 总数据) |
| `/bwb arena <...>` | 竞技场(地图)配置,见下节 |
| `/bwb db <test\|readtest\|writetest\|cache clear\|migrate\|resetroom\|checkdata\|fallback>` | 存储调试与数据迁移 |
| `/bwbdebug <db\|start\|roundwin\|setscore\|board\|respawn\|stats\|sumoend>`(别名 `bwdebug`、`bwd`) | 对局调试(调试总开关默认关闭) |
### 2.4 建图指令 `/bwb arena`
按 1 → 10 的顺序走完,插件会在保存时自动做完整度检测(坐标点 + 擂台 + 图内商人 NPC 齐全才允许保存):
```
1. /bwb arena create <名称> <1v1|2v2|3v3|ALL> 新建一张地图
2. /bwb arena setwaitlobby <名称> 站在图内设本图等待大厅
3. /bwb arena setsumo <名称> 设选边拼刀擂台点(兼任中心点)
4. /bwb arena setsumo <名称> red 红方站位点(蓝方用 blue)
5. /bwb arena setspawn <名称> att 站在攻方基地设出生点(无床)
6. /bwb arena setspawn <名称> def 站在守方基地设出生点
7. /bwb arena setbed <名称> def 在守方基地设床点(全图仅 1 个)
8. /bwb arena addgen <名称> <iron|gold> 资源生成点(需 4 个)
9. /bwb arena npc spawn <shop|upgrade> 在图内放置菜单 NPC
10. /bwb arena save 保存
```
其他:`setspectator`(观战点,可选)、`info <名称>`(查看属性)、`list`(列出地图)、`delgen`(清空生成点)、`tp <名称>`(传送)、`remove <名称>`(删除)、`import`(导入 zip 地图)。
---
## 三、配置文件介绍
全部位于 `plugins/BedWarsBO6/config/`,改完用 **`/bwb reload`** 生效。
### 3.1 `config.yml` —— 主配置
| 段落 | 关键项 | 说明 |
|------|--------|------|
| `database` | `storage_mode` | `LOCAL`(本地文件,开箱即用)/ `SQLITE` / `MYSQL`;本地数据自动存档间隔、损坏自动重建 |
| | `redis` | 可选缓存层,无 Redis 自动退回内存;`server_id` 用于多服共库区分 |
| `language` | — | `zh-cn` 读 `messages.yml`,`en` 读 `messages_en.yml` |
| `basic` | `max_round` / `win_score` | 常规 6 局、先到 4 分胜 |
| | `lobby_countdown_time` | 满员后倒计时(默认 10 秒) |
| | `round_time_limit` | 单小局时限(720 秒),到点平局各 1 分 |
| | `round_intermission` / `finish_delay` | 局间休息 5 秒、结算后 8 秒回大厅 |
| `overtime` | `win_score` / `max_rounds` / `on_max_rounds` | 加时从 0:0 起、先到 3 分、最多 6 局,打满判平 / 继续 |
| `respawn` | `attacker_lives` / `defender_lives` | 进攻方 4 条命,防守方 `-1` = 无限复活;`respawn_tick` 100 = 5 秒 |
| `resource` | `iron_gold_speed_rate` 等 | 铁金倍速、出铁间隔、几次铁出一次金、钻石是否基地产出与击杀掉落数、掉落物过期与刷新点堆积上限 |
| `npc` | `silent` | 商人静音,不再哼唧 |
| `data_save` | `clear_item_per_round` 等 | 每小局清背包、团队升级是否整场保留、死亡是否清装备、永久战靴、死亡保留护甲 |
| `side_choose` | `mode` / `sumo_time` | 选边方式(SUMO)、擂台时限 90 秒、掉台判定低 6 格、超时随机抽人、投票 15 秒 / 平票随机 |
| `level` | `xp_per_level` 等 | 每级 5000 经验、每场上限 2000(`MATCH` / `ROUND`)、击杀 / 拆床 / 胜负经验、1000 级彩虹色、星级颜色表;`prefix_format` 控制聊天等级前缀样式 |
| | `quests` | 每日任务:击杀 60 / 拆床 12,各奖 5000 经验 |
| `enchant` | `trap_radius` / `trap_cooldown` | 陷阱半径 5 格、冷却 30 秒;可禁用附魔台与 `/enchant` |
| `shop` | `enable_quick_buy` / `quick_buy_slots` | 快捷购买开关与格子数(默认 27) |
| `board` | `refresh_tick` / `enable_lobby_board` | 计分板刷新频率(卡就调到 4~10)、大厅是否显示计分板 |
| `build` | `require_command` | 地图默认锁定,需 `/bwb build` 才能编辑 |
| `lobby` / `main_lobby` | 坐标 | 选图大厅落点;主大厅用 `/bwb setmainlobby` 设置(未设则回退到主世界出生点) |
| `starter` | `give_sword` / `give_boots` / `extra_items` | 初始装备与额外物品 |
| `explosion` | `tnt_power` | TNT 威力(默认 6.0,8.0 以上容易一炮清空半张床的防护) |
| `team` | `party_same_team` | 同组队必分同色(防内奸) |
| `party` | `enabled` / `auto_mode` / `detect_external` / `offline_kick_seconds` | 内置组队总开关、按人数自动挑档位、识别外部组队插件、离线 5 分钟自动退队 |
| `debug` | `enable_debug_mode` 等 | 调试总开关与日志开关,**默认全关,线上别开** |
### 3.2 `shop.yml` —— 物品商店
- 版面:第 1 行 `slot 0~7` = 分类页签,`slot 8` = 「我的资源」余额(勿占用);第 2~5 行 = 商品;第 6 行 = 翻页箭头。
- 通用字段:`id` / `slot` / `page` / `material` / `amount` / `display` / `cost_type` / `cost` / `enchant` / `potion` / `lore` / `data` / `color`。
- `quickbuy_default`:新号默认快捷购买模板(Hypixel 同款 3 排)。镐 / 斧**只占一格**且自动显示当前该买的档位,满级后自动隐藏。
- 可放置方块发放时会去掉自定义名称与 lore,保证和挖出来的方块能叠加。
### 3.3 `enchant.yml` —— 团队升级商人
- 页签:锋利 / 保护 / 急迫 / 陷阱,各自 `display`、`material`、`desc`。
- 定价公式:**实际价格 = 该级基准价 + step ×(每队人数 − 1)**,所以 3v3 每级都比 2v2 贵、2v2 比 1v1 贵,同级之间也逐级递增;`mode_cost.enabled: false` 可让所有档位同价。
- 购买后全队生效、不死掉落、重生自动补附魔;每小局重置。
### 3.4 `scoreboard.yml` —— 计分板文案
按场景分段,每段 `title` + `lines`:`lobby`(大厅)、`waiting`(等待大厅)、`countdown`(开局倒计时)、`sumo`(拼刀擂台)、`side_pick`(投票选边)、`round`(小局进行)、`finished`(结算)。
可用占位符:`{online}` `{mode}` `{players}` `{max}` `{redcount}` `{bluecount}` `{teammax}` `{unassigned}` `{countdown}` `{sumotime}` `{redkill}` `{bluekill}` `{sidewinner}` `{sidevotea}` `{sidevoted}` `{sidepick}` `{round}` `{maxround}` `{time}` `{red}` `{blue}` `{overtime}` `{attacker}` `{defender}` `{kills}` `{deaths}` `{respawn}` `{maxrespawn}` `{upgrade}` `{champion}` `{level}` `{levelbar}` `{levelpct}`。
`hide-numbers: true` 可隐藏右侧红字数字;行内容超过 16 字符由插件自动拆成 prefix / suffix 并继承颜色。
### 3.5 `menus.yml` —— 菜单
- `side_pick`:选边投票菜单(进攻 / 防守)。
- `team_select`:等待大厅「选择队伍」菜单(红队 / 蓝队 / 自动分配),占位符含红蓝人数、剩余空位、当前所在队、队伍规模等。
- `mode_select`:档位菜单项配置(图标材质、槽位、文案)。实际档位图标由插件生成,显示「总游玩人数 · 空闲服务器」与当前是否可加入。
### 3.6 `messages.yml` / `messages_en.yml` —— 全部游戏文案
- 所有提示、广播、菜单文案、结算文案都在这里,支持 `{0}` `{1}` … 占位符。
- 支持 `\n` 换行(会按行拆分发送),便于写多行提示。
- 中英文切换由 `config.yml` 的 `language` 决定;可复制 `messages.yml` 改名为 `messages_<语言>.yml` 做自己的语言包。
- 键缺失时不会把 key 名显示给玩家,代码里都有默认文案兜底。
### 3.7 `arenas.yml` —— 地图数据
- 由 `/bwb arena` 系列指令**自动写入**,记录每张地图的等待大厅、擂台与红蓝站位点、攻守出生点、床点、资源生成点、观战点、图内 NPC。
- **不建议手动编辑**,改错会导致地图不完整、无法开局。
### 3.8 目录结构一览
```
plugins/BedWarsBO6/
├── config/ # 全部配置(改完 /bwb reload)
│ ├── config.yml # 主配置:对局规则 / 等级 / 组队 / 存储
│ ├── shop.yml # 物品商店与快捷购买
│ ├── enchant.yml # 团队升级(锋利 / 保护 / 急迫 / 陷阱)
│ ├── scoreboard.yml
│ ├── menus.yml
│ ├── messages.yml / messages_en.yml
│ └── arenas.yml # 地图数据(插件自动写)
├── cache/ # 对局临时数据(打完即清)
├── stats/ # 玩家数据(战绩 / 经验 / 快捷购买)
└── matches/ # 每场对局存档,可回看
```
---
## 四、快速上手
1. 把插件放进 `plugins/`,启动一次生成默认配置。
2. 建图:按 **2.4 节**的 1 → 10 顺序跑完 `/bwb arena ...`,最后 `save` 通过完整度检测。
3. 设主大厅:站到落点打 `/bwb setmainlobby`。
4. `/bwb reload` 重载,玩家右键指南针即可选档位开局。