CancelBlockUpdate

CancelBlockUpdate

CancelBlockUpdate is a Bukkit-compatible plugin that suppresses selected block updates on a per-world basis.

这是一个 Bukkit 兼容的方块更新抑制插件，支持按世界开启或关闭指定方块的更新抑制，适配 Multiverse 多世界场景，并使用 Bukkit 权限节点兼容 LuckPerms。

Compatibility

• Minecraft 1.20.x through current 26.x servers.
• Bukkit / CraftBukkit-compatible servers.
• Paper and Purpur servers.
• Plugin api-version is 1.20 so older supported servers do not reject the plugin at load time.
• Built against the Spigot/Bukkit 1.20 API and Java 17 bytecode. Run the server with the Java version required by that server release.

The latest Paper release checked while updating this plugin was 26.1.2.

Features

• Per-world block update control.
• Multiverse-compatible world handling through Bukkit world names.
• LuckPerms-compatible permissions through standard Bukkit permission nodes.
• /cbu command prefix with tab completion.
• Runtime reload for config and locale files.
• Configurable chat message prefix.
• 10 bundled i18n files under locals/.
• Player messages follow the player's Minecraft client language when a bundled locale matches.
• Console messages default to English.
• Configurable suppressed block material list.
• Efficient suppression lookup using a material set and early per-world checks.

Installation

1. Build the plugin jar.
2. Copy build/libs/CancelBlockUpdate-1.1.0.jar into your server's plugins/ directory.
3. Restart the server.
4. Edit plugins/CancelBlockUpdate/config.yml as needed.
5. Run /cbu reload after editing config or locale files.

Commands

Material IDs may use Bukkit material names, lower-case names, hyphenated names, or a minecraft: namespace, for example:

GRASS_BLOCK
sand
minecraft:redstone_wire

Permissions

LuckPerms can manage these nodes directly.

Configuration

Default config.yml:

messages:
  prefix: "&bCBU &7>> &r"

default-block-updates-enabled: true
max-target-distance: 8

suppressed-blocks:
  - GRASS_BLOCK

worlds: {}

Example per-world configuration:

worlds:
  world:
    block-updates-enabled: false
  world_nether:
    block-updates-enabled: true

block-updates-enabled: false means updates for materials in suppressed-blocks will be cancelled in that world.

Config Tolerance

The plugin tolerates common manual edit mistakes, but it is not a full config repair tool:

• If config.yml is malformed YAML on startup, bundled defaults are used and a warning is logged.
• If config.yml becomes malformed during /cbu reload, the previous valid settings are kept and a warning is logged.
• Boolean strings such as true, false, on, and off are accepted.
• suppressed-blocks may be a YAML list or a single comma-separated string.
• worlds.<name>: false is accepted as a shorthand for worlds.<name>.block-updates-enabled: false.
• Invalid material ids and wrong value types are logged and ignored or replaced by defaults.

Locale Files

Locale files are copied to:

plugins/CancelBlockUpdate/locals/

Bundled locales:

• en_US.yml
• zh_CN.yml
• zh_TW.yml
• es_ES.yml
• fr_FR.yml
• de_DE.yml
• pt_BR.yml
• ru_RU.yml
• ja_JP.yml
• ko_KR.yml

The locale matcher accepts exact bundled locales and language-level fallbacks. For example, es_mx falls back to es_ES, pt_pt falls back to pt_BR, Simplified Chinese locales use zh_CN, and Traditional Chinese locales such as zh_tw, zh_hk, zh_mo, and zh_hant use zh_TW.