Thizzy'z Tree Feller - 高度自定义伐木插件

Tree Feller 是一款功能强大的 Minecraft 插件，它允许玩家一次性砍倒整棵树，极大地提升了伐木效率。插件支持自定义树木和工具，拥有丰富的配置选项和动画效果，并能与众多主流插件兼容。

💡核心特性

智能树木检测

• 独立树木检测：精准识别并砍伐单棵树木，不影响玩家建筑。
• 高级结构检测：可配置的检测逻辑，能处理各种形状和大小的树木。
• 自定义树木：支持为任何由相连原木构成的树木（包括模组树木）配置树叶和原木方块组合。

高度可配置性

• 游戏内配置：可通过 /treefeller config 命令在游戏内快速调整设置。
• 快速自定义：通过自动检测树木特征，几秒钟即可完成新树木的配置。
• 精细控制：几乎所有配置选项（如世界、游戏时间、游戏模式、权限等）都可以针对每把工具或每种树木单独设置。
• 工具自定义：可为工具配置自定义名称、耐久度、附魔等条件。

增强功能与效果

• 砍树动画：提供树木倒下的视觉动画。
• 高级物理效果：树木可以按不同物理行为倒下（如自然倒下、造成伤害等）。
• 特效系统：支持粒子效果、声音和爆炸等自定义效果。
• 冷却系统：支持全局以及针对工具或树木的独立冷却时间。
• 连锁砍伐：启用后，可以连锁砍伐相连的整片森林。

开箱即用与兼容性

• 即插即用：默认配置即可可靠地砍伐所有原版树木。
• 广泛兼容：与众多主流插件兼容，包括：

- McMMO

- MMOCore

- EcoSkills

- Zrip’s Jobs Reborn

- CoreProtect

- GriefPrevention

- WorldGuard

- Towny

- Ore Regenerator

- Drop2Inventory

❓常见问题与技巧

支持自定义树木吗？

是的。插件能够检测和砍伐任何形状和大小、且原木相连的树木。默认配置针对原版树木。如果你的自定义树木非常巨大，或包含多种不匹配的木材/树叶类型，则需要在配置文件中自行添加。

对于生成不当（例如包含对角线连接或永久性树叶）的自定义树木，你可能需要启用 ignore-leaf-data、diagonal-leaves 和 player-leaves 选项。

故障排除

如果遇到问题，请按以下步骤排查

• 确保你使用的是最新版本的插件。
• 运行 /treefeller debug 命令，然后尝试砍树。
• 检查服务器控制台中的启动日志。
• 如果仍无法定位问题，可以到 Discord 或 GitHub 寻求帮助。请务必提供配置文件、启动日志和 /treefeller debug 的调试信息。

技巧与趣味用法

• 用于采矿：你可以配置插件来“砍伐”矿石。

1. 添加一个以矿石为树干且禁用树叶的“树”，例如：

`[COAL_ORE, COAL_ORE, {required-leaves: 0, leaf-detect-range: 0, leaf-break-range: 0, max-height: 256}]`

2. 为每种镐子添加工具，并将 `allowed-trees` 设置为 `ORE`，例如：

`{type: IRON_PICKAXE, allowed-trees: ORE}`

3. 将斧头的 `allowed-trees` 设置为 `LOG`，例如：

`{type: IRON_AXE, allowed-trees: LOG}`

• 更精确的配置：allowed-trees 可以设置为树木索引列表，例如 [0, 1, 2, 3, 4, 5] 代表配置中定义的前6种树。
• 定义多个同类型工具或树木：这可用于实现“或”逻辑。例如，想让金斧头必须拥有“耐久 I” 或 “效率 II”：

    tools:
      {type: GOLDEN_AXE, required-enchantments: {unbreaking: 1}}
      {type: GOLDEN_AXE, required-enchantments: {efficiency: 2}}

• 检查顺序：工具和树木的检查是按配置顺序进行的。如果一个物品匹配多个工具定义，将总是使用第一个匹配的。

🎮命令与权限

所有命令都需要 treefeller.help 权限来查看帮助。

• /treefeller reload

- 权限：`treefeller.reload`

- 重新加载插件配置文件。

• /treefeller help

- 权限：`treefeller.help`

- 显示 Tree Feller 命令帮助。

• /treefeller on

- 权限：`treefeller.toggle`

- 为执行命令的玩家开启砍树功能。

• /treefeller off

- 权限：`treefeller.toggle`

- 为执行命令的玩家关闭砍树功能。

• /treefeller toggle

- 权限：`treefeller.toggle`

- 切换执行命令的玩家的砍树功能开关。

• /treefeller debug [on|off]

- 权限：`treefeller.debug`

- 全局开启或关闭调试模式。

• /treefeller config

- 权限：`treefeller.config`

- 打开游戏内配置界面。

🔧配置概述

更新插件时，请务必手动添加任何缺失的配置选项，因为它们不会自动添加。

配置文件非常详尽，主要包含以下部分

• 基础设置：如扫描距离、树叶检测范围、所需原木/树叶数量、最大高度等。
• 行为控制：如是否允许部分砍伐、是否检测玩家放置的树叶、是否留下树桩、砍伐动画设置等。
• 物理效果：定义原木和树叶的砍伐行为（如直接破坏、落入背包、自然倒下等）、下落方向、速度等。
• 工具限制：定义工具所需的附魔、耐久度、名称、Lore、权限、使用环境（世界、时间、游戏模式）等。
• 树木定义：定义每种树的原木材料、树叶材料以及该树种特有的设置（如树苗、根系、经验值等）。
• 特效系统：自定义粒子、声音、爆炸等效果，并可将其关联到特定工具或树木。
• 消息自定义：完全自定义插件发送给玩家的各类提示和调试信息。
• 兼容性设置：为每个支持的插件单独开关兼容性及配置经验值等。

（配置文件内容过长，此处仅作概括。具体每个选项的说明请参考插件生成的完整配置文件。）

✨支持与捐赠

我的插件将永远免费，但如果您喜欢它，可以考虑通过以下方式支持我：

• Ko-fi: ko-fi.com/thizthizzydizzy
• Patreon: patreon.com/thizthizzydizzy

如需帮助，请加入 Discord: https://discord.gg/dhcPSMt