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
Tree Quality of Life
Sneak + break a log, the whole tree comes down.
TreeQoL handles the boring part of tree chopping - breaking all the logs, clearing the leaves, and replanting the sapling - so you don't have to.
Simple breaking from top to bottom animation
Features
Tools - You customize tools. Blacklist individual axe types (e.g. golden axe) or add custom items from ItemsAdder or Nexo as valid axe tools.
Glow highlight - shows logs that will be chopped by glowing effect. Color and duration customizable.
Smart tree validation - min/max log count, max horizontal spread (so you can include branchy oaks but exclude log walls), and a leaf-percentage check that distinguishes natural trees from player-built structures.
Animation - off by default. When enabled, logs break layer by layer, top-down or bottom-up, with configurable delay, particles, and sounds. (Very satisfying with delay 0)
Auto replant - places a sapling at the root after chopping the tree. Can require suitable soil, can consume one from the player's inventory, and can be enabled/disabled per wood type.
Fast leaf decay - removes leaves in batched waves after the logs are gone. Speed and batch size are configurable. Can also be toggled per wood type.
Language - easy to use language system.
Commands
| Command |
Permission |
What it does |
/treeqol toggle |
treeqol.toggle |
Turn breaking trees on/off for yourself |
/treeqol lang <code|reset> |
treeqol.lang |
Override your language |
/treeqol reload |
treeqol.reload |
Reload config and lang files live |
/treeqol info |
- |
Version info |
/treeqol help |
- |
Command list |
| Permission |
Notes |
treeqol.use |
Required to chop whole trees |
treeqol.toggle |
Required for /treeqol toggle |
treeqol.lang |
Required for /treeqol lang |
treeqol.reload |
Required for /treeqol reload |
treeqol.bypass.worldguard |
Ignore WorldGuard restrictions |
Integrations
| Plugin |
Integration |
| WorldGuard |
Chopping respects the BUILD flag - blocked regions stay blocked |
| CoreProtect |
Every broken log is logged as a player block removal |
| ItemsAdder |
Custom items can be configured as tools |
| Nexo |
Same as ItemsAdder |
| Jobs Reborn |
Player work by chopping trees |
Languages
The plugin reads the player's client locale automatically and picks the matching lang/XX.yml file. Players can override this with /treeqol lang <code>. If a translation doesn't exist for their locale, it falls back to default-locale in config.yml (English by default).
Bundled: English (en), Polish (pl).
To add a new language, copy lang/en.yml to lang/de.yml (or whatever the locale code is), translate the strings, and reload. No restart needed.
Config
# ═══════════════════════════════════════════════════
# TreeQoL Configuration
# ═══════════════════════════════════════════════════
# Default locale used when the player's locale cannot be determined or their
# translation file does not exist. Must match a file in the lang/ folder.
default-locale: "en"
# Force all players to use this locale regardless of client locale.
# Leave empty ("") to use per-player locale detection.
force-locale: ""
# ── Core Behaviour ──────────────────────────────────
tree-felling:
# Master switch - set false to disable all features without unloading the plugin.
enabled: true
# Player must hold SHIFT while breaking a log to trigger tree chopping.
require-shift: true
# Permission node required to use tree chopping. Leave empty to allow everyone.
permission: "treeqol.use"
# ── Tool Restrictions ──────────────────────────────
tools:
# Controls which items can trigger tree chopping:
# ANY - any item (including bare hand)
# AXES - only axe-type items (default)
# SPECIAL_ONLY - only items listed in special-items below
mode: "AXES"
# Axe materials for which tree chopping is DISABLED even when mode is AXES.
# Use Bukkit Material names (e.g. GOLDEN_AXE, WOODEN_AXE).
disabled-axe-types: []
# Special items that always activate chopping regardless of mode setting.
# Supports vanilla materials and custom items from ItemsAdder / Nexo.
special-items:
enabled: false
items: []
# Example entries:
# items:
# - type: VANILLA
# material: NETHERITE_AXE
# display-name: "" # optional: require exact display name match
# - type: ITEMSADDER
# id: "mypack:magic_axe"
# - type: NEXO
# id: "magic_axe"
# ── Block / Tree Type Restrictions ────────────────
blocks:
# Whitelist: only these log types will trigger tree chopping.
# Leave empty to allow ALL log types.
allowed-log-types: []
# Blacklist: chopping is always disabled for these log types.
disabled-log-types: []
# ── Tree Size Limits ──────────────────────────────
size:
# Minimum number of log blocks required to trigger chopping.
# Prevents accidentally chopping 2-block posts or tiny structures.
min-logs: 3
# Maximum number of log blocks that can be broken at once.
# Safety cap to prevent lag on huge custom trees.
max-logs: 200
# Maximum horizontal spread (bounding box width/depth) of the tree.
# Purely vertical trees have spread 0. Increase for oak/jungle trees with branches.
max-horizontal-spread: 5
# Number of topmost log layers to scan for leaves when validating the tree.
leaf-validation-layers: 3
# Minimum percentage (0–100) of surrounding blocks that must be leaves
# for the structure to be recognised as a natural tree.
min-leaf-percentage: 20
# ── Visual Effects ────────────────────────────────
effects:
# Apply Mining Fatigue to the player when a tree chopping is triggered.
slow-mining:
enabled: true
amplifier: 0 # 0 = Mining Fatigue I, 1 = II, etc.
duration-ticks: 40
# Highlight (glowing outline) all log blocks that will be broken.
highlight-blocks:
enabled: true
duration-ticks: 20
# Glow colour - must be a valid ChatColor name.
color: "WHITE"
# ── Break Animation ───────────────────────────────
animation:
# Play a staged break animation instead of instant removal.
enabled: true
# Direction of staged breaking:
# TOP_DOWN - logs break from top to bottom (realistic fall)
# BOTTOM_UP - logs break from bottom to top
direction: "TOP_DOWN"
# Delay in ticks between each Y-layer of logs being broken.
delay-per-layer-ticks: 1
# Spawn block-crack particles at each broken log position.
particles: true
# Play the log break sound for each layer.
sounds: true
# ── Auto Replant ──────────────────────────────────
auto-replant:
# Automatically place a sapling at the tree's root after chopping.
enabled: false
# Delay in ticks before placing the sapling.
delay-ticks: 5
# Per-tree-type control. If a type is not listed, it inherits 'enabled' above.
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
# Require suitable soil (grass, dirt, farmland…) under the root for replanting.
check-soil: true
# Consume one sapling from the player's inventory instead of placing one for free.
# If the player has no matching sapling, replanting is skipped.
consume-sapling: false
# ── Fast Leaf Decay ───────────────────────────────
fast-leaf-decay:
# Quickly remove natural leaf blocks after a tree is chopped.
enabled: true
# Delay in ticks between each wave of leaf removal.
delay-per-wave-ticks: 2
# Maximum leaf blocks to remove per wave.
max-per-wave: 20
# Per-tree-type control. If a type is not listed, it inherits 'enabled' above.
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
# ── Plugin Integrations ───────────────────────────
integrations:
worldguard:
# Block tree chopping in regions where the player cannot build.
enabled: true
check-build-flag: true
coreprotect:
# Log each chopped block in CoreProtect as a player block removal.
enabled: true
# Label prepended to the CoreProtect log entry (useful for filtering).
action-label: "#treeqol"
itemsadder:
enabled: true
nexo:
enabled: true
jobs:
# Award Jobs Reborn payment/XP for every log chopped, as if the player
# had broken each one individually. Requires Jobs Reborn to be installed.
enabled: true
# ── Command Settings ──────────────────────────────
commands-config:
# Cooldown in seconds between /treeqol toggle uses. 0 disables cooldown.
toggle-cooldown: 0
评论 0
登录后参与评分
还没有评论,来抢沙发吧