TreeQoL

插件

· 作者 Tems

用于一次性砍伐整棵树的简易插件

0 本站下载 0 关注 更新于 8 个月前

最新 1.0 · 1.21.11 · Folia / Paper

一键开服(送7天)

Tree Quality of Life

潜行 + 破坏原木,整棵树倒下。

TreeQoL 处理砍树时繁琐的部分——破坏所有原木、清理树叶并重新种植树苗——让你无需亲力亲为。

简单的自上而下动画分解效果


功能

工具 - 自定义工具。禁用特定的斧头类型(例如金斧),或从 ItemsAdder 或 Nexo 添加自定义物品作为有效的斧头工具。

发光高亮 - 通过发光效果显示将被砍伐的原木。颜色和持续时间可自定义。

智能树木验证 - 最小/最大原木数量、最大水平扩散范围(以便包含多分支的橡树但排除原木墙),以及一个叶子百分比检查,用于区分自然生成的树木和玩家建造的结构。

动画 - 默认关闭。启用后,原木将逐层破坏,支持自上而下或自下而上,可配置延迟、粒子效果和声音。(延迟设为 0 时非常有满足感)

自动补种 - 在砍伐树木后于根部放置树苗。可以要求合适的土壤,可以从玩家的库存中消耗一棵树苗,并且可以为每种木材类型单独启用/禁用。

快速树叶腐烂 - 在原木消失后以批量波次移除树叶。速度和批大小可配置。也可以为每种木材类型单独切换。

语言 - 易于使用的语言系统。

命令

命令 权限 作用
/treeqol toggle treeqol.toggle 开启或关闭你自己砍树的特性
/treeqol lang <code|reset> treeqol.lang 覆盖你的语言设置
/treeqol reload treeqol.reload 实时重载配置和语言文件
/treeqol info - 版本信息
/treeqol help - 命令列表
权限 备注
treeqol.use 砍伐整棵树所需
treeqol.toggle 用于 /treeqol toggle
treeqol.lang 用于 /treeqol lang
treeqol.reload 用于 /treeqol reload
treeqol.bypass.worldguard 忽略 WorldGuard 限制

集成

插件 集成方式
WorldGuard 砍伐尊重 BUILD 标志 - 被禁止的区域保持禁止状态
CoreProtect 每个被破坏的原木都会记录为玩家方块移除
ItemsAdder 自定义物品可配置为工具
Nexo 与 ItemsAdder 相同
Jobs Reborn 通过砍树进行玩家工作

语言

插件会自动读取玩家的客户端区域设置并选择匹配的 lang/XX.yml 文件。玩家可以使用 /treeqol lang <code> 覆盖此设置。如果没有为其区域设置提供翻译,则回退到 config.yml 中的 default-locale(默认为英语)。

内置:English (en),Polish (pl)。

要添加新语言,请将 lang/en.yml 复制为 lang/de.yml(或其他区域代码),翻译字符串,然后重载。无需重启服务器。


配置

# ═══════════════════════════════════════════════════
#                  TreeQoL Configuration
# ═══════════════════════════════════════════════════

# 当无法确定玩家的区域设置或其翻译文件不存在时使用的默认区域设置。
# 必须匹配 lang/ 文件夹中的一个文件。
default-locale: "en"

# 强制所有玩家使用此区域设置,无论其客户端区域设置如何。
# 留空 ("") 以使用按玩家的区域设置检测。
force-locale: ""

# ── 核心行为 ──────────────────────────────────
tree-felling:
  # 主开关 - 设置为 false 以禁用所有功能,而无需卸载插件。
  enabled: true

  # 玩家必须在破坏原木时按住 SHIFT 键才能触发砍树。
  require-shift: true

  # 使用砍树功能所需的权限节点。留空以允许所有人使用。
  permission: "treeqol.use"

  # ── 工具限制 ──────────────────────────────
  tools:
    # 控制哪些物品可以触发砍树:
    #   ANY          - 任何物品(包括空手)
    #   AXES         - 仅斧头类物品(默认)
    #   SPECIAL_ONLY - 仅下面列出的特殊物品
    mode: "AXES"

    # 即使模式为 AXES,也禁用砍树的斧头材质。
    # 使用 Bukkit Material 名称(例如 GOLDEN_AXE, WOODEN_AXE)。
    disabled-axe-types: []

    # 无论模式设置如何,始终激活砍树的特殊物品。
    # 支持原版材质以及来自 ItemsAdder / Nexo 的自定义物品。
    special-items:
      enabled: false
      items: []
      # 示例条目:
      # items:
      #   - type: VANILLA
      #     material: NETHERITE_AXE
      #     display-name: ""        # 可选:需要精确匹配显示名称
      #   - type: ITEMSADDER
      #     id: "mypack:magic_axe"
      #   - type: NEXO
      #     id: "magic_axe"

  # ── 方块 / 树木类型限制 ────────────────
  blocks:
    # 白名单:只有这些原木类型会触发砍树。
    # 留空以允许所有原木类型。
    allowed-log-types: []

    # 黑名单:对于这些原木类型,砍树始终被禁用。
    disabled-log-types: []

  # ── 树木尺寸限制 ──────────────
  size:
    # 触发砍树所需的最小原木方块数量。
    # 防止意外砍伐 2 格高的柱子或小型结构。
    min-logs: 3

    # 一次可以破坏的最大原木数量。
    # 安全上限,以防止在大规模自定义树木上产生卡顿。
    max-logs: 200

    # 树木的最大水平扩散范围(边界框宽度/深度)。
    # 纯垂直树木的扩散范围为 0。对于具有分支的橡树/丛林树请增加此值。
    max-horizontal-spread: 5

    # 在验证树木时扫描的最顶层原木层数以查找树叶。
    leaf-validation-layers: 3

    # 周围方块中必须是树叶的最小百分比(0–100),
    # 该结构才会被识别为自然树木。
    min-leaf-percentage: 20

# ── 视觉效果 ────────────────────────────────
  effects:
    # 触发砍树时给予玩家挖掘疲劳效果。
    slow-mining:
      enabled: true
      amplifier: 0          # 0 = 挖掘疲劳 I,1 = II,以此类推
      duration-ticks: 40

    # 高亮显示(发光轮廓)所有即将被破坏的原木方块。
    highlight-blocks:
      enabled: true
      duration-ticks: 20
      # 发光颜色 - 必须是有效的 ChatColor 名称。
      color: "WHITE"

  # ── 破坏动画 ───────────────────────────────
  animation:
    # 播放分阶段的破坏动画,而非瞬间移除。
    enabled: true

    # 分阶段破坏的方向:
    #   TOP_DOWN  - 原木从顶部到底部依次断裂(真实掉落效果)
    #   BOTTOM_UP - 原木从底部到顶部依次断裂
    direction: "TOP_DOWN"

    # 每层 Y 轴原木被破坏之间的延迟(以刻为单位)。
    delay-per-layer-ticks: 1

    # 在每个被破坏的原木位置生成方块碎裂粒子效果。
    particles: true

    # 为每一层播放原木断裂的声音。
    sounds: true

  # ── 自动补种 ──────────────────────────────────
  auto-replant:
    # 砍伐后在树根处自动放置树苗。
    enabled: false

    # 放置树苗前的延迟(以刻为单位)。
    delay-ticks: 5

    # 按树木类型控制。如果未列出某种类型,则继承上方的 'enabled' 设置。
    per-type:
      OAK_LOG: true
      BIRCH_LOG: true
      SPRUCE_LOG: true
      JUNGLE_LOG: true
      ACACIA_LOG: true
      DARK_OAK_LOG: true
      MANGROVE_LOG: true
      CHERRY_LOG: true
      PALE_OAK_LOG: true

    # 要求树根下方有合适的土壤(草方块、泥土、耕地…)才能进行补种。
    check-soil: true

    # 从玩家的物品栏中消耗一棵树苗,而不是免费放置。
    # 如果玩家没有匹配的树苗,则跳过补种。
    consume-sapling: false

  # ── 快速树叶腐烂 ───────────────────────────────
  fast-leaf-decay:
    # 砍树后迅速移除自然生成的树叶方块。
    enabled: true

    # 每次树叶清除波次之间的延迟(以刻为单位)。
    delay-per-wave-ticks: 2

    # 每波次最大可移除的树叶方块数量。
    max-per-wave: 20

    # 按树木类型控制。如果未列出某种类型,则继承上方的 'enabled' 设置。
    per-type:
      OAK_LOG: true
      BIRCH_LOG: true
      SPRUCE_LOG: true
      JUNGLE_LOG: true
      ACACIA_LOG: true
      DARK_OAK_LOG: true
      MANGROVE_LOG: true
      CHERRY_LOG: true
      PALE_OAK_LOG: true

# ── 插件集成 ───────────────────────────────
integrations:
  worldguard:
    # 在玩家无法建造的区域阻止砍树。
    enabled: true
    check-build-flag: true

  coreprotect:
    # 将每个被砍伐的方块记录到 CoreProtect 中,作为玩家方块移除操作。
    enabled: true
    # 添加到 CoreProtect 日志条目前缀(便于筛选)。
    action-label: "#treeqol"

  itemsadder:
    enabled: true

  nexo:
    enabled: true

  jobs:
    # 为每次砍伐原木提供 Jobs Reborn 的金钱/经验奖励,仿佛玩家逐个破坏了它们。需要安装 Jobs Reborn。
    enabled: true

# ── 命令设置 ──────────────────────────────
commands-config:
  # 使用 /treeqol toggle 命令之间的冷却时间(秒)。设为 0 则禁用冷却。
  toggle-cooldown: 0

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源