二次开发 付费 BedWarsHeypixel - 添加诸多功能 - 基于BW1058的二次开发 26.7

新增功能​

1. 快捷栏预设（测试阶段功能，fastbuy.yml）​

• 快捷购买界面新增红石图标（默认槽位 45，可通过 icon.slot 修改），点击打开预设设置界面。
• 可为每个商店类别设置“购买后物品自动放入的快捷栏槽位（0-8）”，之后购买该类别物品时自动移位到指定槽位（若目标槽位已有物品则交换）。
• 本功能处于测试阶段。fastbuy.yml 内含总开关 enabled 与全部界面文本 / 图标配置。
• 预设数据按玩家保存在内存中，玩家重新进入服务器后需重新设置。

2. 事件加血（healthadd.yml，新建配置文件）​

• 可配置游戏开始后 1~4 次全体加血事件，或完全关闭。
• 默认 2 次（开局后第 5 分钟、第 10 分钟），每次默认 +5 颗心（amount=10，单位为半心，可修改）。
• 每次的触发时间（time-minutes / time-seconds）与血量（amount）均可单独配置。
• 自动集成到游戏计分板事件显示：当加血时间早于下一个事件链事件时，事件行显示加血事件倒计时。
• 触发时全竞技场广播提示并播放音效。

3. 游戏总时长限制（config.yml：game-duration-limit）​

• 默认 60（分钟），游戏进行到时限后强制结算。
• 单位仅为分钟，设为 <=0 时关闭限制。

4. 隐身增强（config.yml：invisibility-enhance）​

• invisibility-enhance.enabled=true（默认开启）。
• 玩家喝下隐身药水后，非队友完全看不到该玩家（包括手持物品）。
• 队友可以看到其头顶名字标签，方便队内识别。
• 隐身玩家未蹲下时持续向队友发送粒子效果（蹲下即隐藏粒子），比原版疾跑粒子更实用。
• 粒子参数可调：particle-interval=4（发送间隔）、particle-amount=3（粒子数量）。

5. 重生时间减少增益开关（config.yml：respawn-time-reduction-enabled）​

• 默认 true。
• 关闭后，“重生时间减少”团队升级将不再生效。

6. 4/5 级资源点级别（钻石 / 绿宝石 Tier IV/V）​

• generators.yml 新增默认值：
  
  • 钻石：IV 级 1800 秒出现，V 级 2520 秒出现。
  • 绿宝石：IV 级 2160 秒出现，V 级 2880 秒出现。
  • 均可自行修改。
• config.yml 新增 generator-tier-4-5-enabled=true，设为 false 可整体关闭 IV/V 级资源点。

7. 胜利用时显示开关（config.yml：win-time-display）​

• 默认 true，胜利副标题显示“获得胜利, 用时”。
• 消息可在语言文件 GAME_END_WIN_TIME_SUBTITLE 中自定义，支持 {team} / {time} 占位符。

8. 等级显示模式（config.yml：levels-display-mode）​

• fancy：原有彩色阶数 / 星级显示（默认）。
• simple：纯色简版显示。

9. 新版本适配​

• 新增支持 Minecraft 1.20.5、1.20.6、1.21、1.21.1、1.21.2、1.21.3、1.21.4（此前最高 1.20.4）。

10. 语言精简​

• 语言系统仅保留简体中文（zh_cn）、繁体中文（zh_tw，新增）、英文（en），移除其余 11 种语言。

BUG 修复​

1. 修复 Shift+点击购买一组只扣除 1 份资源的问题——现按比例计价（例：羊毛 16 个 / 4 铁，Shift+点击买 64 个扣 16 铁）。
2. 修复 debug 模式 /bw time add 后事件系统卡死、游戏永不结束的 bug——倒计时被减到 0 后事件不再推进；现在计数归零立即推进事件、倒计时钳制最小 1 秒、单次加时不超过当前阶段剩余时间，重复输入可继续推进。
3. 修复 ChunkLoad 监听器在异步线程调用实体 API 的问题——改回主线程执行。

优化​

1. 版本适配层重构：新增 versionsupport_v1_21_R1/R2/R3 模块；1.20.5+ 适配器不再依赖带版本号的 CraftBukkit 包名（改用公开 Bukkit API + 运行时反射，物品标识改用 PersistentDataContainer）。
2. 隐身玩家名牌显示按队伍区分（BwTabList）。
3. 隐身粒子仅发送给队友，降低网络 / 客户端开销。
4. /bw time add 每次最多推进到下一个事件，防止误操作跳过床摧毁阶段。

配置文件变更​

config.yml 新增​

配置项	默认值	说明
game-duration-limit	60	游戏总时长限制（分钟），<=0 关闭
win-time-display	true	胜利副标题显示用时
respawn-time-reduction-enabled	true	重生时间减少团队升级开关
generator-tier-4-5-enabled	true	钻石 / 绿宝石 IV/V 级资源点总开关
levels-display-mode	fancy	等级显示模式：fancy / simple
invisibility-enhance.enabled	true	隐身增强总开关
invisibility-enhance.particle-interval	4	隐身粒子发送间隔
invisibility-enhance.particle-amount	3	隐身粒子数量

新增文件​

• healthadd.yml：全体加血事件配置。
• fastbuy.yml：快捷栏预设（测试阶段）配置。

generators.yml 新增​

• Default.diamond.tierIV.* / Default.diamond.tierV.* 配置节。
• Default.emerald.tierIV.* / Default.emerald.tierV.* 配置节。

其他​

• shopxp.yml：移除自动生成的“下界合金剑”与“石中剑 EX”两项（下界合金套装保留）。
• 语言文件：仅保留 zh_cn / zh_tw / en。

升级注意​

1. 版本兼容：本版本支持 1.8.8 ~ 1.21.4；1.20.5+ 通过新适配器支持，无需额外操作。
2. 1.20.5+ 物品标识变更：物品标识改用 PersistentDataContainer，与旧版本（1.20.4 及以下）的物品 tag 不互通。从旧版本升级且跨版本使用数据 / 地图时请注意。
3. 1.20.5+ 召唤物行为：银鲛鱼 / 铁傀儡召唤物在 1.20.5+ 使用原版 AI，行为与旧版本略有差异。
4. 构建环境：自行编译需要 JDK 21（运行服务器本身按其对应版本要求即可）。
5. 配置自动合并：首次以 26.9 启动时，config.yml 新增项、generators.yml IV/V 级配置节、healthadd.yml、fastbuy.yml 会自动生成；如需自定义请在其后修改并执行 /bw reload。
6. 快捷栏预设为测试阶段功能：数据不持久化（重进服务器需重设），如不稳定可通过 fastbuy.yml 中 enabled: false 关闭。