BreakTogether - TreeCapitator & OreBreaker - BreakTogether - 连锁采集

Breaktogether 1.0

Breaktogether 是一款实用的 Minecraft 插件，它允许玩家一次性连锁采集整棵树木或整片相连的矿石，大幅提升资源收集效率。插件支持自定义消息、权限管理，并可集成 WorldGuard 以在特定区域禁用此功能。

💡核心功能

• 连锁砍树：当破坏原木时，自动连锁破坏整棵相连的树木。
• 连锁挖矿：当破坏矿石时，自动连锁破坏所有相连的同种矿石。
• 精准控制：可分别全局启用或禁用连锁挖矿与连锁砍树功能。
• 耐久度计算：连锁破坏会正确计算工具耐久消耗。若耐久不足，将尽可能多地破坏方块并提示玩家。
• 附魔支持：连锁挖矿时，工具的“时运”附魔效果会正确生效，并提示额外掉落的数量。
• WorldGuard 集成：可与 WorldGuard 插件联动，在指定区域内禁用连锁采集。

🎮配置说明

配置文件中的主要设置如下

功能开关

• breakOreActive: true - 全局启用或禁用连锁挖矿。
• breakTreeActive: true - 全局启用或禁用连锁砍树。

消息提示

您可以使用以下变量自定义提示消息

• %number% - 被破坏的方块数量。
• %ore% - 矿石类型（例如：diamond）。
• %fortuneOres% - 因“时运”附魔而额外掉落的矿石数量。

预设消息：

• brokenLogs - 成功连锁砍树后的提示。
• brokenPartialLogs - 因耐久不足仅部分砍树后的提示。
• brokenOres - 成功连锁挖矿后的提示。
• brokenOresWithFortune - 带有时运附魔效果连锁挖矿后的提示。
• brokePartialOres - 因耐久不足仅部分挖矿后的提示。
• notEnoughDurability - 工具耐久完全不足时的提示。
• noPermission - 玩家无权限操作时的提示。

🔧命令与权限

命令

• /bt reload - 重载插件配置文件。
• /bt <enable/disable> <ores/trees> - 为所有玩家全局启用或禁用连锁挖矿/砍树。
• /bt ores <on/off> - 仅为你自己启用或禁用连锁挖矿功能。
• /bt trees <on/off> - 仅为你自己启用或禁用连锁砍树功能。

权限节点

如果服务器未使用权限插件，OP 玩家将自动拥有所有功能。

• breaktogether.breakores.use - 使用连锁挖矿功能。
• breaktogether.breaktrees.use - 使用连锁砍树功能。
• breaktogether.reload - 使用 /bt reload 命令。
• breaktogether.disable - 使用 /bt disable 命令。
• breaktogether.enable - 使用 /bt enable 命令。
• breaktogether.breakores.toggle - 使用 /bt ores <on/off> 命令。
• breaktogether.breaktrees.toggle - 使用 /bt trees <on/off> 命令。

✨WorldGuard 集成

如需在特定区域禁止使用连锁采集，可以配合 WorldGuard 插件实现。

设置方法：

• 在目标区域创建一个 WorldGuard 区域。
• 为该区域设置 block-break 标志为 deny。
• 示例命令：/rg flag <region> block-break deny

当玩家在此区域内尝试破坏方块时，Breaktogether 的连锁采集功能将不会触发。

❓注意事项

• 更新插件配置后，请使用 /bt reload 命令使更改生效。
• 连锁采集会正常消耗工具耐久，请确保工具耐久充足以获得最佳体验。
• 权限系统为可选配置。若不配置，默认仅 OP 玩家拥有管理命令权限，所有玩家可使用采集功能。

BreakTogether 插件文档

BreakTogether 是一款便捷的 Minecraft 插件，它允许玩家一次性连锁采集整棵树木或整片相连的矿石，大幅提升了资源收集的效率。插件支持自定义消息、权限管理和 WorldGuard 区域保护集成。

💡核心功能

• 连锁砍树：当启用时，破坏树木的一个原木方块即可自动破坏所有与之相连的原木。
• 连锁挖矿：当启用时，破坏一个矿石方块（如钻石矿）即可自动破坏所有与之相连的同种矿石。
• 耐久度消耗：连锁破坏会正常消耗工具的耐久度。如果工具耐久不足，将停止破坏并提示玩家。
• 精准采集与时运：完全支持附魔效果。使用精准采集工具会掉落方块本身，使用时运工具会增加掉落物数量。
• WorldGuard 集成：可以与 WorldGuard 插件配合，在特定区域内禁用连锁破坏功能。
• 玩家控制：管理员可以全局启用或禁用功能，玩家也可以单独为自己开关连锁采集。

🎮配置说明

插件的配置文件 (config.yml) 结构如下，你可以修改消息和开关全局设置。

功能开关

# 为所有玩家启用或禁用插件功能，也可以通过命令 /bt <enable/disable> <ores/trees> 实现
breakOreActive: true
breakTreeActive: true

消息自定义

你可以使用以下变量自定义提示消息

• %number%：被破坏的方块数量。
• %ore%：矿石的类型（例如：diamond）。
• %fortuneOres%：因时运附魔而额外掉落的矿石数量。

砍树消息

brokenLogs: '§7§o你破坏了 §4%number% §7个原木！'
brokenPartialLogs: '§c§o耐久度不足以砍倒整棵树！只破坏了 %number% 个原木！'

挖矿消息

brokenOres: '§7§o你破坏了 %number% 个 §4§l§o%ore%！'
brokenOresWithFortune: '§7§o你破坏了 %number% 个 §4§l§o%ore%，因时运效果额外获得了 %fortuneOres% 个！'
brokePartialOres: '§7由于耐久度不足，只破坏了 %number% 个 %ore%！'

通用消息

notEnoughDurability: '§c§o耐久度不足！'
noPermission: '§c§o你没有权限执行此操作！'

🔧命令与权限

所有命令均以 /bt 或 /breaktogether 开头。

管理员命令

• /bt reload - 重载插件配置文件。
• /bt disable <ores/trees> - 为所有玩家禁用连锁挖矿或连锁砍树功能。
• /bt enable <ores/trees> - 为所有玩家启用连锁挖矿或连锁砍树功能。

玩家命令

• /bt ores <on/off> - 为自己开启或关闭连锁挖矿功能。
• /bt trees <on/off> - 为自己开启或关闭连锁砍树功能。

权限节点

如果服务器未设置权限，OP 玩家将默认拥有所有功能。

• breaktogether.breakores.use - 允许使用连锁挖矿。
• breaktogether.breaktrees.use - 允许使用连锁砍树。
• breaktogether.reload - 允许使用 /bt reload 命令。
• breaktogether.disable - 允许使用 /bt disable 命令。
• breaktogether.enable - 允许使用 /bt enable 命令。
• breaktogether.breakores.toggle - 允许使用 /bt ores <on/off> 命令。
• breaktogether.breaktrees.toggle - 允许使用 /bt trees <on/off> 命令。

✨WorldGuard 集成

为了防止在特定区域使用连锁破坏，插件集成了 WorldGuard API。

设置方法

• 确保安装了 WorldGuard 插件。
• 在目标区域创建一个 WorldGuard 区域。
• 为该区域设置 block-break 标志为 deny。

示例命令

/rg flag <区域名称> block-break deny

设置后，在该区域内的玩家将无法使用 BreakTogether 的连锁破坏功能。