TreeGravity - Tree Feller - TreeGravity - 一键砍树

TreeGravity 是一款类似于 TreeFeller、Timber、Choptree 和 TreeAssist 的插件，它允许玩家通过破坏一个方块来砍倒整棵树或采掘整条矿脉。以下是其主要功能与配置的详细介绍。

💡核心功能

TreeGravity 提供了多种砍树方式，适用于不同的游戏风格和服务器需求。

砍树模式

• Lumberjack Classic：砍掉一个原木，整棵树会倒下，所有原木会以一个物品堆的形式掉落。
• Lumberjack Natural：破坏一个原木，整棵树会自然倒下，每个原木会像正常破坏一样逐个掉落。
• Lumberjack Random：与 Classic 类似，但掉落的原木数量会有 ±20% 的随机波动（例如，一棵有 10 个原木的树会掉落 8 到 12 个）。
• Gravity：破坏一个原木，其上方的所有原木会像沙子/沙砾一样坠落。警告：此模式无法区分自然生成的树木和玩家放置的原木。
• 实验性方法：存在三种实验性方法（详见更新 3.9.1），它们涉及元数据操作，可能导致严重卡顿，请谨慎使用。

当前特性

• 支持所有树种，包括蘑菇树。
• 砍伐后不会留下任何浮空的木头或树叶。
• 内置玩家建筑/房屋保护，确保由原木和树叶建造的建筑安全。
• 自动重新种植树苗，保持森林繁茂。
• 兼容反破坏和领地保护插件，防止他人砍伐你的树木。
• 除了原木（或蘑菇块），只会破坏附着其上的物品，如藤蔓、可可豆等。
• 所有配置均可在游戏内更改。

🎮版本信息

请根据你的服务器版本选择对应的 TreeGravity 版本：

• Spigot/Paper 1.17：请使用版本 4.6.1
• Spigot/Paper 1.16：请使用版本 4.6.0
• Spigot/Paper 1.15+：请使用版本 4.3.0 至 4.5.0
• Spigot/Paper 1.13 & 1.14：请使用版本 4.2.2 或更早版本
• Spigot/Paper 1.12：请查看相关链接

注意：如果你遇到任何漏洞或有任何建议，请在讨论区反馈。关于与 EpicWorldGenerator (EWG) 的兼容性问题，请查看下方的“关于 EpicWorldGenerator 的说明”。

✨配置设置

你可以在 config.yml 文件中调整以下设置，以自定义插件行为。

常规设置

• tgType：设置当前激活的砍树方法。1 为 Lumberjack，4 为 Gravity。也可尝试实验性方法 [2.1, 4.1, 4.2]。
• toolsAllowed：设置允许触发砍树的工具列表（建议仅使用斧头）。
• chopMethod：设置砍树是否需要潜行。可选值：default, stand, sneak, sneak.notify。
• updateChecker：是否检查插件更新。
• debugger：是否在控制台输出砍树调试信息（仅限 Lumberjack 模式）。
• defaultUserPerm：是否默认给予所有玩家 TreeGravity 权限（砍树和使用 /tg 命令）。
• sound：砍树时播放的音效。可选值：none, scream, falling, treefiddy, creepy, LOTR。
• soundFrequency：砍树时播放音效的频率（0 到 1 的小数，尚未实现）。
• allowedWorlds：设置插件生效的世界列表。

Lumberjack 相关设置

• autoReplant：是否在砍树后自动重新种植树苗（约有 3 秒延迟）。
• houseProtection：设置插件判断建筑是人造还是树木的严格等级（0 到 5，0 为关闭，5 最严格）。
• fairDurability：斧头耐久度是否根据砍伐的原木数量下降。
• durabilityMultiplier：每个原木对工具耐久度的影响倍数（默认 1.0，与原版相同）。
• saplingDrop：是否在树底掉落一堆树苗（仅限 Lumberjack Classic 和 Random 模式）。
• fallMethod：设置树木倒下时的动画效果。可选值：pop, break, natural。
• dropMethod：设置原木的去向。可选值：itemdrop（掉落地面）或 inventory（直接进入玩家背包）。
• randomLogDrop：是否启用随机掉落原木数量（替代了旧的 tgType 3）。

其他设置

• mcmmoHook：是否与 McMMO 插件挂钩。
• mcmmoXpMultiplier：设置使用 TreeGravity 砍树时获得的 McMMO 经验百分比（0 到 1 的小数，尚未实现）。
• oreSweeper：是否启用快速采矿功能。用镐破坏一个矿石时，周围同种矿石会自然破裂。

默认 config.yml 示例

Treegravity:
  General:
    tgType: 1
    toolsAllowed:
      - STONE_AXE
      - IRON_AXE
      - GOLDEN_AXE
      - DIAMOND_AXE
    chopMethod: default
    updateChecker: true
    debugger: false
    defaultUserPerm: true
    sound: none
    soundFrequency: 1.0
    allowedWorlds:
      - all
  Lumberjack:
    houseProtection: 5
    fairDurability: true
    durabilityMultiplier: 1.0
    autoReplant: true
    saplingDrop: false
    fallMethod: pop
    dropMethod: itemdrop
    randomLogDrop: false
  Other:
    mcmmoHook: true
    mcmmoXpMultiplier: 1.0
  OreSweeper:
    enabled: false
    pickaxesAllowed:
      - WOODEN_PICKAXE
      - STONE_PICKAXE
      - IRON_PICKAXE
      - GOLDEN_PICKAXE

🔧命令列表

玩家命令

• /tg：显示此命令列表。
• /tg help：解释命令和设置。
• /tg info：提供插件的一般信息。
• /tg settings：显示服务器当前的 TreeGravity 配置。
• /tg toggle：为单个玩家开启或关闭 TreeGravity 功能。

管理员命令

• /tg reload：重载插件。
• /tgconfig：显示 /tgconfig 的子命令列表。
• /tgconfig [enable, disable]：开启或关闭插件。
• /tgconfig set type [lumberjack, gravity]：更改当前的砍树方法。
• /tgconfig set durabilitymultiplier [数值]：设置耐久度影响倍数（支持任意小数）。
• /tgconfig set houseprotection [0-5]：设置建筑保护等级。
• /tgconfig set chopmethod [default, stand, sneak, sneak.notify]：设置砍树是否需要潜行。
• /tgconfig set fallmethod [pop, break, natural]：设置树木倒下动画。
• /tgconfig set dropmethod [itemdrop, inventory]：设置原木去向。
• /tgconfig tools add/remove [工具]：在允许的工具列表中添加或移除工具。
• /tgconfig worlds add/remove [世界名]：在允许的世界列表中添加或移除世界。
• /tgconfig toggle [设置名]：开启或关闭特定设置（如 fairdurability, autoreplant 等）。

开发者命令

• /tgconfig toggle [debugger]：在控制台开启或关闭调试信息。
• /tgd：给予玩家一把钻石斧。
• /tgd g：给予玩家一把金斧。
• /tgd a：给予玩家每种类型的斧头各一把。

⭐权限节点

• tg.user：允许玩家砍树和使用除 /tg reload 外的所有 /tg 命令。默认授予所有玩家。
• tg.operator：允许使用 /tgconfig 命令和 /tg reload。默认授予所有管理员。

❓社区建议与开发计划

以下是社区提出的功能建议及其实现状态。

计划开发的功能（优先级较高）

• 与 Jobs Reborn 插件兼容。
• 为木材/矿石类型添加白名单。
• 增加更多自定义选项：
• messages.yml 文件。
• 配置中可设置最大原木数量变量。
• 配置中可设置玩家默认开启/关闭的变量。
• 为自定义物品名称/描述添加白名单（类似于 allowedTools 设置）。
• 自动重新种植的几率百分比（例如，50% 的几率自动重植）。

计划开发的功能（优先级较低）

• 要求砍断整个树干后树木才会倒下。
• 根据树木的原木数量添加“挖掘疲劳”效果（类似于将树木视为实体，需要砍伐多次才会倒下）。

已实现的功能

• 与 CoreProtect 兼容（于 2020年6月14日 在 4.5.0 版本中实现）。
• 与 Custom Enchants Plus 兼容（特别是 oreSweeper 功能，于 2020年6月5日 在 4.4.0 版本中实现）。
• 添加新模式：砍伐树干中部时，只破坏砍伐点以上的原木（于 2019年11月23日 完成，在 4.3.0 版本中实现）。
• 支持树叶立即枯萎（于 2019年8月17日 在 4.2.1 版本中实现）。
• 使 OreSweeper 与时运和精准采集附魔兼容（于 2019年8月17日 在 4.2.1 版本中实现）。
• 添加类似 tgType 4.2 的新方法，使所有原木在树下堆成锥形（于 2019年8月17日 在 4.2.0 版本中实现）。
• 添加配置选项以移除树叶或使其掉落（仅限树木周围合理立方区域内的树叶）（于 2019年8月17日 在 4.2.0 版本中实现）。
• 在 config.yml 中添加允许的世界列表（于 2019年5月26日 在 4.1.0 版本中实现）。
• 添加忽略 houseProtection 的选项，以便砍伐树叶稀少的云杉树（于 2019年5月26日 在 4.1.0 版本中实现）。
• 添加配置设置，使原木直接从树木进入玩家背包（于 2019年5月26日 在 4.1.0 版本中实现）。
• 与 McMMO 插件挂钩（于 2019年2月16日 在 3.11.0 版本中实现）。
• 添加修改版 Lumberjack 方法，使树叶随原木一起被破坏（于 2018年11月21日 在 3.9.1 版本中实现）。
• 添加修改版 Gravity 方法，砍伐一个方块时整棵树的原木都会落下（于 2018年11月21日 在 3.9.1 版本中实现）。
• 添加玩家个人开关选项（于 2018年11月21日 在 3.9.1 版本中实现）。
• 为 chopMethod 添加选项，使潜行时砍树不会触发整棵倒下（于 2018年11月21日 在 3.9.1 版本中实现）。
• 添加自动种植地面树苗的选项（于 2018年10月8日 实现）。
• 添加配置设置，使用 RNG 决定玩家获得更多、更少或确切数量的原木（于 2018年10月6日 实现）。

💡关于 EpicWorldGenerator (EWG) 的说明

TreeGravity 被报告与 EpicWorldGenerator (EWG) 不兼容。除了 HouseProtection 配置设置外，TreeGravity 的代码中没有任何内容会阻止 EWG 中的树木被砍伐。

**解决方案尝试**

如果你尝试同时使用这两个插件，请将 HouseProtection 设置为 0。

**开发者说明**

为了查明兼容性问题，插件作者多次联系 EWG 的开发者 minelazz，希望获得 EWG 的开发者版本进行测试，但未收到回复。因此，在获得测试用的 EWG jar 文件之前，无法确定导致不兼容的根本原因，也无法解决未知原因引起的问题。

**建议**

如果上述方法无效，你可以直接联系 minelazz，询问是否允许开发者测试其插件与 EWG 的兼容性，或者使用 minelazz 为 EWG 专门开发的 Treefeller 插件。

所有未来关于 TreeGravity 和 EWG 兼容性的评论/问题/反馈，都应直接联系 minelazz。