原创 工具 🔥 WarZScriptBlockPlus - 下一代脚本方块解决方案 全版本 · 原生 Folia · Web 可视化 · REST API 1.1.8

[MD] # WarZScriptBlockPlus v1.1.8 更新内容总结 > 一句话总结：**冷却范围可配置** —— 每个脚本方块都能选择「每位玩家独立冷却」或「全服共享冷却」。 ## 具体更新 ### 新增冷却范围 | 范围 | 含义 | 适用场景 | | :--- | :--- | :--- | | `PLAYER`（默认） | 每位玩家各自计算冷却，玩家 A 触发后不影响玩家 B | 个人传送、每日领取、单人机关 | | `GLOBAL` | 同一个方块全服共用一份冷却，任意玩家触发后所有人都要等冷却结束 | 全服活动、公共宝箱、限量机关 | > 注意：`GLOBAL` 是**同一个方块**全服共享，不是所有脚本方块共用一个冷却。 ### 指令 ```text /wsb cooldown <秒数> [player|global] ``` 示例： ```text /wsb cooldown 30 # 30 秒，保持当前范围（新方块默认 player） /wsb cooldown 30 player # 30 秒，每位玩家独立 /wsb cooldown 30 global # 30 秒，全服玩家共享 ``` 也支持中文别名：`个人` / `全服` / `全局`。 ### 各编辑入口 - **GUI 编辑器**：点击冷却按钮后输入 `30 global`，或只输入 `global` / `player` 切换范围。 - **Web 编辑器**：新增「冷却范围」下拉框；方块列表会给全服冷却显示 `30s 全服` 徽章。 - **`/wsb info`**：新增「冷却范围」显示。 - **全局绑定**（`config.yml`）：新增 `cooldown-scope: "PLAYER|GLOBAL"` 配置项。 ```yaml global-bindings: public_chest: material: CHEST trigger: INTERACT cooldown: 60 cooldown-scope: "GLOBAL" ``` ### 顺带修正 红石触发（`REDSTONE`）此前没有接入冷却判定，本次统一纳入冷却逻辑，配置了冷却的红石方块也会按范围正常冷却。 ## 兼容性 - 旧 `blocks.json` 没有 `cooldownScope` 字段时按 `PLAYER` 处理，行为与旧版完全一致。 - 旧 `global-bindings` 没有 `cooldown-scope` 时同样按 `PLAYER` 处理。 - 不涉及数据迁移，不需要改任何已有配置。 ## 升级注意 1. 用 `target/WarZScriptBlockPlus-1.1.8.jar` 替换旧版，**重启服务器**生效。 2. 重启后可按需执行 `/wsb reload` 重载配置与 `blocks.json`。 3. 想让某个方块全服共享冷却，执行 `/wsb cooldown <秒数> global` 即可。 [/MD]

[MD] # WarZScriptBlockPlus v1.1.7 更新内容总结 > 一句话总结：**修复 1.12.x 打开 `/wsb editor` GUI 编辑器崩溃（NoSuchFieldError: CLOCK）的问题**。 ## 具体更新 ### 修复内容 `Material.CLOCK` 是 1.13+ 的枚举名，1.12 中该物品叫 `WATCH`。 插件按 1.20.4 API 编译，编译不报错，但在 Paper 1.12.2 运行时链接失败， 导致 `/wsb editor` 一打开就抛 `NoSuchFieldError: CLOCK`，点击 GUI 时同样会崩。 修复方式：冷却时间按钮的材质改为按名称动态解析—— 1.13+ 命中 `CLOCK`，1.12 及以下自动回退 `WATCH`。 ### 影响版本 - **1.12.x 及更早**：本次修复对象，编辑器恢复正常使用。 - **1.13+ / Folia**：行为与 v1.1.6 完全一致，无任何变化，可放心升级也可不升。 ## 升级注意 1. 替换 jar 后**重启服务器**生效。 2. 无配置 / 数据迁移，直接替换即可。 [/MD]

[MD] # WarZScriptBlockPlus v1.1.6 更新内容总结 > 一句话总结：**条件不足提示全面自定义** —— 单条条件、整个方块、全局绑定都能配专属提示，还支持静默。 ## 具体更新 ### 三级提示优先级 ``` 条件行内 "-> 提示" > 方块 denyMessage > config.yml messages.condition-failed （最具体） （最兜底） ``` 任一层填 `none`（不分大小写）→ 该层静默；三层都空 → 不发任何提示。 ### 用法示例 **① 单条条件专属提示**（`->` 或 `||` 分隔，支持颜色、PAPI 变量、`\n` 换行）： ``` [NUM_GTE] %player_level% 50 -> &c需要 50 级！\n&7当前等级: &e%player_level% [PERMISSION] vip.use||&c需要 VIP 权限！ ![PERMISSION] bad.perm -> &c你不该有这个权限 [OP] -> &c只有 OP 能触发 ``` **② 整个方块的默认提示**（命令 / GUI / Web 编辑器均可设置）： ``` /wsb denymsg &c✘ 你还不能进入这片区域 # 设置 /wsb denymsg clear # 恢复 config.yml 默认 /wsb denymsg none # 静默无提示 ``` **③ 动作流内嵌套条件的专属提示**（失败时先提示再中断，不再"点了没反应"）： ``` [CONDITION] [PERMISSION] vip.use -> &c需要 VIP 才能继续！ [MESSAGE] &aVIP 专属奖励已发放 ``` **④ 全局绑定**（config.yml）： ```yaml global-bindings: vip_door: conditions: - "[PERMISSION] wsb.use" deny-message: "&c✘ 需要 wsb.use 权限才能使用。" ``` **⑤ 全局兜底**（config.yml，占位符 `%condition%` = 未通过的条件原文）： ```yaml messages: condition-failed: "&c✘ 你不满足触发条件。" ``` ## 对服主的价值 - **玩家知道缺什么**：提示可以带上具体数据（等级、余额、变量），告别千篇一律的"你不满足触发条件"。 - **按方块控制静默**：踩踏板、机关类方块可单独 `/wsb denymsg none`，不用再清空全局提示殃及所有方块。 - **`[CONDITION]` 中断不再无声**：动作流水线里的条件判定失败会先发提示，减少玩家困惑与客诉。 ## 升级注意 1. **替换 jar 后必须重启服务器**（`/wsb reload` 不足以加载新的类结构）。 2. 存量 `blocks.json`、存量条件**零改动、零迁移**：没写 `->` 的条件行为与旧版完全一致。 3. 之前为静默把 `messages.condition-failed` 清空了的，建议恢复全局提示，改为对个别方块执行 `/wsb denymsg none`。 4. 红石触发器（REDSTONE）维持静默失败设计，本次未改动。 [/MD]

• Web 端可直接新建脚本：顶栏、侧栏、空状态加号、欢迎页都能进创建弹窗
• 填写名称、世界、坐标、触发方式后立刻写入，并进入编辑
• 坐标已有脚本时自动打开，不重复创建
• 创建不再依赖世界必须已加载，按 world + x/y/z 直接落盘
• 空状态加号从装饰改为真正的创建入口

Web 编辑器全面重做（Script Studio）

• 默认按名称 A→Z 排序（中文数字自然序，副本2 在 副本10 前）
• 未命名脚本统一沉底
• 搜索：名称 / 世界 / 坐标 / 触发方式
• 筛选：世界下拉 + 触发方式芯片
• 分组标题（首字母 / 世界 / 触发）
• 稳定坐标 key 选中，不再乱序丢选中
• 未保存脏标记、切换前提醒
• Ctrl+S 保存、/ 聚焦搜索
• 条件/动作序号徽章，上下移后自动重排
• 深色全息控制台视觉

WarZScriptBlockPlus v1.1.3 更新内容

1. 新增脚本方块命名功能
- 支持 /wsb name <名称> 设置脚本方块名称
- 支持 /wsb rename <名称> 别名命令
- /wsb info、游戏内 GUI、Web 编辑器均会显示名称
- blocks.json / blocks.js 可直接添加 name 字段，方便批量管理

2. 新增数值比较条件
- 新增 [NUM_GTE] 大于等于
- 新增 [NUM_LTE] 小于等于
- 支持别名 [NUM_GE] / [NUM_LE]
- 例如 50 级传送可写：[NUM_GTE] %player_level% 50

3. 优化 reload
- /wsb reload 现在会重载脚本方块数据文件
- 手动修改 blocks.json / blocks.js 后无需重启服务器
- 自动读取最近修改的数据文件

4. 数据文件优化
- 使用 UTF-8 读写，中文名称更稳定
- 加载时会重新建立坐标索引，批量改文件更方便

5. 修复
- 修复 Web 编辑器动作上下移动按钮异常

• 修复 Paper 1.21.11 环境下对 Folia 的误判，避免普通 Paper 错误走 Folia 调度逻辑。
• 修复 [PLAYER_COMMAND]、[OP_COMMAND]、`[BYPASS]`` 在新内核下可能出现的权限失效问题，改为按玩家实体调度执行。
• 优化 [COMMAND] / [CONSOLE] 命令执行流程，兼容命令前导 /。
• 新增调试日志开关，开启 debug: true 后可在控制台查看命令执行结果，便于排查兼容问题。
• 统一项目与文档版本号为 1.1.2。

WarZScriptBlockPlus 1.1.1更新内容总结
1. 修复游戏内GUI shift+左键调整顺序功能
- 问题 : GUIManager中物品描述显示了"Shift+左键 - 移动"但实际未实现
- 修复 :
- 添加了Shift+左键的处理逻辑
- 玩家点击后会提示输入目标位置(数字1-N)
- 支持输入 cancel 取消操作
2. Web编辑器添加上下移按钮
- 为每个动作添加了 ↑ 上移 和 ↓ 下移 按钮
- 可直接在浏览器中拖拽调整动作顺序

修复1.12.2低版本下方法缺失的问题。

[MD] ### 物品系统详解 (Item System) `[ITEM]` 动作支持扣除多种类型的物品，插件会自动按照以下优先级进行检查： 1. **强制指定前缀**：如果提供了前缀，只检查对应来源。 2. **自动识别**：如果没有前缀，依次检查 `原版材质` -> `WarZItems` -> `MythicMobs`。 #### 支持的命名空间前缀 - `minecraft:` - 原版材质 (如 `minecraft:DIAMOND`) - `mm:` 或 `mythicmobs:` - MythicMobs 物品 (如 `mm:Excalibur`) - `wz:` 或 `warzitems:` - WarZItems 物品 (如 `wz:AK47`) #### 示例 - **扣除原版钻石**： - `[ITEM] minecraft:DIAMOND 1` (推荐，防止冲突) - `[ITEM] DIAMOND 1` (如果不存在同名自定义物品) - **扣除 MythicMobs 物品**： - `[ITEM] mm:Excalibur 1` - **扣除 WarZItems 物品**： - `[ITEM] wz:AK47 1` [/MD]