原创 开源 世界管理 [1.20.x-26.x]CancelBlockUpdate - 按世界抑制指定方块更新 1.1.0

[MD] # CancelBlockUpdate - 按世界抑制指定方块更新 CancelBlockUpdate 是一个轻量级方块更新抑制插件，用于在指定世界中取消指定方块相关的更新事件。插件适合用于一些需要保留特殊地形、红石结构、悬浮方块、装饰结构，或需要减少特定方块更新 影响的服务器场景。 插件支持 Bukkit / Paper / Purpur，兼容 Minecraft 1.20+ 到当前 26.x 版本线。 ## 主要功能 - 支持 Bukkit、Paper、Purpur 服务端 - 支持 Minecraft 1.20+ / 26.x - 可按世界开启或关闭方块更新抑制 - 可配置需要抑制更新的方块列表 - 支持 `/cbu block add <ID>` 快速添加方块 - 不填写 ID 时，可自动添加玩家当前看向的方块 - 支持 Multiverse 等多世界插件，通过 Bukkit 世界名识别世界 - 支持 LuckPerms 等权限插件 - 支持配置文件热重载 - 配置文件手动写错时具备有限容错能力 - 内置 10 个语言文件，支持中文、英文、日文、韩文、俄文、德文、法文、西班牙文、葡萄牙文等常见语言 ## 可抑制的更新类型 插件会尽量覆盖常见的方块更新相关事件，包括： - 方块物理更新 - 液体流动 - 方块蔓延、生长、枯萎、形成 - 树叶腐烂 - 方块燃烧 - 活塞推动/拉回 - 实体改变方块 - 红石电流变化 ## 命令 | 命令 | 权限 | 说明 | | --- | --- | --- | | `/cbu help` | `cbu.help` | 查看帮助 | | `/cbu reload` | `cbu.reload` | 重载配置和语言文件 | | `/cbu world enable` | `cbu.world` | 在当前世界启用正常方块更新 | | `/cbu world disable` | `cbu.world` | 在当前世界关闭指定方块更新 | | `/cbu block add <ID>` | `cbu.block.add` | 添加指定方块 ID 到抑制列表 | | `/cbu block add` | `cbu.block.add` | 添加玩家当前看向的方块 | 示例： ```text /cbu world disable /cbu block add GRASS_BLOCK /cbu block add minecraft:redstone_wire ``` ## 权限 | 权限 | 默认 | 说明 | | --- | --- | --- | | cbu.admin | OP | 管理员权限，包含所有子权限 | | cbu.help | OP | 查看帮助 | | cbu.reload | OP | 重载插件 | | cbu.world | OP | 管理当前世界的方块更新状态 | | cbu.block.add | OP | 添加抑制方块 | ## 配置示例 ```yaml messages: prefix: "&bCBU &7>> &r" default-block-updates-enabled: true max-target-distance: 8 suppressed-blocks: - GRASS_BLOCK worlds: world: block-updates-enabled: false ``` 说明： - default-block-updates-enabled: true 表示未单独配置的世界默认保持正常方块更新。 - block-updates-enabled: false 表示该世界会取消 suppressed-blocks 中方块相关的更新。 - suppressed-blocks 支持 Bukkit 材料 ID，例如 GRASS_BLOCK、SAND、REDSTONE_WIRE。 ## 配置容错 如果配置文件被手动写坏，插件会尽量避免直接崩溃： - 启动时配置 YAML 损坏，会使用内置默认配置并在控制台输出警告。 - /cbu reload 时配置 YAML 损坏，会保留上一次有效配置。 - 布尔值支持 true、false、on、off 等写法。 - suppressed-blocks 写成逗号分隔字符串时也会尝试读取。 - 无效方块 ID 会被忽略并输出警告。 ## 兼容性 - Minecraft：1.20+ - 服务端：Bukkit / Paper / Purpur - Java：取决于你的服务端版本，插件本身以 Java 17 字节码构建 - 可选兼容：Multiverse-Core、LuckPerms ## 下载 GitHub Releases： https://github.com/DrSmoothl/CancelBlockUpdate/releases [/MD]