BetterTimber
适用于 Paper、Purpur 和 Folia 26.x 的 Tree feller / TreeCapitator(伐木器)。 只需击碎一根原木,整棵树便会倒下——并带有平滑的原版风格动画。完全可自定义。
预览

工作原理
如果玩家拥有一把附魔了 效率 V、抢夺 III、耐久 III 和 经验修补 的 下界合金斧(此为默认设置,可在配置文件中更改),那么只需击碎一根原木,整棵树就会被砍倒。
您也可以允许使用任何斧头——无论是否附魔——甚至徒手。
Timber 附魔(附加组件)
希望玩家通过努力 获得 伐木能力吗?请安装附加组件 BetterTimberEnchantment:它为斧头添加了 Timber(伐木) 附魔(可通过附魔台、图书管理员村民或战利品获取),只有拥有 Timber 附魔的斧头才能砍倒整棵树。未安装该附加组件时,BetterTimber 的工作方式与之前完全相同。
功能特性
- 自动识别世界生成的树木,包括 2x2 及更大的树木以及所有新的木材类型
- 内置动画,保持原版生存风格的速度感,速度取决于斧头类型
- 保护您的建筑: 玩家放置的原木和紧邻树木建造的木屋永远不会被砍倒(重启后依然有效)
- 尊重保护插件 如 WorldGuard 或 GriefPrevention —— 每根原木都会触发独立的方块破坏事件,因此 CoreProtect 等日志插件也能记录
- 正确的耐久度消耗:按整棵树或按单根原木计算,尊重“耐久”附魔效果,斧头用尽后会损坏
- 潜行时可跳过动画(可禁用)
- 丢弃斧头会停止动画
- 支持 Folia —— 一个 JAR 文件同时兼容 Paper、Purpur 和 Folia
- MiniMessage 格式支持: 渐变、十六进制颜色等 —— 经典的
& 代码仍然可用
- 内置 英语、德语、法语、西班牙语、波兰语、俄语、葡萄牙语、土耳其语和中文,只需一个文件即可添加您自己的语言
- 轻量级:无递归调用,缓存材质数据,在没有树木被砍伐时不运行任何进程
- 可选的从 Modrinth 自动更新(默认关闭,通过 SHA-512 校验)—— 新增的配置选项会自动添加,您的原有值保持不变
- 快速树叶腐烂 —— 被砍倒的树木的树叶会在几秒钟内腐烂(其他树木的树叶和玩家放置的树叶保留)
命令与权限
/bettertimber reload(别名 /bt)—— 重新加载配置文件和消息,权限为 bettertimber.reload(默认为 OP 权限)
- 玩家无需任何权限 —— 任何持有有效斧头的玩家都可以砍伐树木。
要求
- Paper、Purpur 或 Folia 26.1 - 26.3
- Java 25
Bug 报告与支持
如果您需要帮助或发现 Bug,请通过 Discord 联系我(添加好友 ID: hassanbwo)。我将保证快速提供帮助 —— 感谢您的支持 :)
config.yml
在此添加可以砍伐树木的斧头类型及其所需的附魔。将两个列表留空以允许使用任何斧头。
# ==========================================
# BetterTimber – config.yml
# ==========================================
# 您可以在这里自定义斧头和附魔:
# 如果两者都留空,则接受每种斧头,无论其是否附魔。
# 如果仅留空其中一个字段,则要么接受每种斧头,要么接受每种附魔,或者都不接受。
# 请查看插件页面以获取正确的值:
# https://modrinth.com/plugin/bettertimber
# ==========================================
# 附加组件 "BetterTimberEnchantment" (https://modrinth.com/plugin/bettertimberenchantment):
# 添加了附魔 "Timber"(附魔台、村民、战利品)。如果已安装,则只有拥有
# Timber 附魔的斧头才能砍倒整棵树,下方的 valid_axes / required_enchantments 将不起作用。
# ==========================================
# 如果您需要帮助或发现 Bug,请通过 Discord 联系我(添加好友 ID: hassanbwo)。
# 我将保证快速提供帮助 —— 感谢您的支持 :)
# ==========================================
valid_axes:
- NETHERITE_AXE
required_enchantments:
unbreaking: 3
efficiency: 5
fortune: 3
mending: 1
# ==========================================
# 在这里您可以决定徒手是否能触发动画
# ==========================================
use_hand: false
# ==========================================
# 当玩家潜行时,不会触发动画。默认为 true。
# 在此停用(将 true 替换为 false),消息可以在 messages 文件中更改。
# ==========================================
sneak_skip_enabled: true
# ==========================================
# 在这里您可以选择每棵树只扣除一点耐久度,还是扣除与该树原木数量相等的耐久度
# 示例:如果树有 5 根原木,则扣除 5 点耐久度(默认 = true)
# 如果您希望每棵树只扣除 1 点耐久度,请将此设置为 false
# ==========================================
durability_per_log: true
# ==========================================
# 被砍倒的树木的树叶会快速腐烂(在几秒内而不是几分钟内)。
# 仍属于另一棵树的树叶和玩家放置的树叶会保留。
# 掉落物(树苗、棍子、苹果)与原版的相同。
# ==========================================
fast_leaf_decay: true
# ==========================================
# 在这里您可以选择砍伐木材的速度是否应根据斧头类型而定(默认 = true)
# ==========================================
axe_type_speed_enabled: true
# ==========================================
# 在这里您可以调整速度,数值越高,动画越慢
# ==========================================
axe_speed_multipliers:
WOODEN_AXE: 10
STONE_AXE: 8
IRON_AXE: 6
GOLDEN_AXE: 4
DIAMOND_AXE: 3
NETHERITE_AXE: 2
# ==========================================
# 所有消息的语言:en (English), de (Deutsch), fr (Français), es (Español),
# pl (Polski), ru (Русский), pt (Português), tr (Türkçe) 或 zh (简体中文)
# 文本位于 messages_en.yml / messages_de.yml 中,支持 MiniMessage (<red>, <gradient:...>)
# 以及经典颜色代码 (&c)。您可以添加自己的语言,例如 messages_it.yml -> language: it
# /bettertimber reload (权限 bettertimber.reload) 重新加载配置和消息。
# ==========================================
language: en
# Modrinth 更新:控制台总是会公告新版本。
# enabled: 自动下载新版本。下载时会使用来自 Modrinth 的 SHA-512 校验和进行检查
# 并在下次服务器重启时安装(plugins/update 文件夹)。仅下载适用于您的
# Minecraft 版本和服务端软件(Paper, Purpur, Folia)的版本。
# major_versions: 也自动下载大版本更新(例如 2.x -> 3.0),否则仅进行公告。
auto_update:
enabled: false
major_versions: false
messages_en.yml
所有文本均支持 MiniMessage (<red>, <bold>, <gradient:#ff5555:#ffaa00>Text</gradient>) 以及经典的 & 颜色代码。已包含德语、法语、西班牙语、波兰语、俄语、葡萄牙语、土耳其语和中文的翻译 - 在配置中使用 language: de, fr, es, pl, ru, pt, tr 或 zh 进行切换。
# ==========================================
# BetterTimber - 消息 (English)
# ==========================================
# 格式化:MiniMessage - https://docs.advntr.dev/minimessage/format
# 颜色: <red>, <gold>, <#ff8800>
# 样式: <bold>, <italic>, <underlined>
# 渐变: <gradient:#ff5555:#ffaa00>Text</gradient>
# 彩虹: <rainbow>Text</rainbow>
# 经典颜色代码如 &c, &l 或 &#ff8800 同样有效。
#
# 在 config.yml 中选择语言 (language: en)。您也可以创建自己的
# 文件,例如 messages_fr.yml,并设置 "language: fr"。缺失的文本将回退到英文。
# 将消息留空 ("") 以禁用它。
# ==========================================
# 当玩家在动画期间掉落斧头时的操作栏提示
axe_dropped: "<gray>你掉落了斧头,停止了你的 <gradient:#ffaa00:#ff5500>伐木工</gradient> 动作!"
# 当玩家潜行时的操作栏提示 (config.yml 中的 sneak_skip_enabled)
sneak_skip: "<gray>你潜行了,不再是一名 <gradient:#ffaa00:#ff5500>伐木工</gradient>!"
# /bettertimber reload
reload_success: "<gradient:#ffaa00:#ff5500><bold>BetterTimber</bold></gradient> <gray>配置重新加载成功!"
no_permission: "<red>你没有权限使用此命令。"
usage: "<red>用法: /bettertimber reload"
支持的斧头和附魔
斧头:WOODEN_AXE, STONE_AXE, COPPER_AXE, IRON_AXE, GOLDEN_AXE, DIAMOND_AXE, NETHERITE_AXE
附魔(键:等级):efficiency (1-5), unbreaking (1-3), fortune (1-3), mending (1), silk_touch (1), sharpness (1-5), smite (1-5), bane_of_arthropods (1-5), fire_aspect (1-2), vanishing_curse (1)
斧头必须恰好具有列出的附魔及其对应的等级。
BetterPlugins 的其他插件
全部适用于 Paper, Purpur 和 Folia 26.x,提供英语、德语、法语、西班牙语、波兰语、俄语、葡萄牙语、土耳其语和中文支持 - 查看整个 BetterPlugins 合集:
BetterTimber
Tree feller / TreeCapitator for Paper, Purpur and Folia 26.x. Break one log and the whole tree comes down - with a smooth, vanilla-style animation. Completely customizable.
Preview

How it works
If a player has a netherite axe with Efficiency V, Fortune III, Unbreaking III and Mending (default, change it in the config), the whole tree is felled by breaking only one log.
You can also allow every axe - enchanted or not - or even bare hands.
Timber enchantment (add-on)
Want players to earn the lumberjack ability? Install the add-on BetterTimberEnchantment: it adds the Timber enchantment for axes (enchanting table, librarian villagers, loot) and only axes with Timber fell whole trees. Without the add-on BetterTimber works exactly as before.
Features
- Automatically recognises world-generated trees, also 2x2 and larger trees and all new wood types
- Built-in animation that keeps the vanilla survival style, speed depends on the axe type
- Safe for your builds: player-placed logs and log houses next to trees are never felled (also after a restart)
- Respects protection plugins like WorldGuard or GriefPrevention - every log fires its own block break event, so logging plugins like CoreProtect record it too
- Correct durability: per tree or per log, respects Unbreaking, the axe breaks when it's used up
- Sneaking skips the animation (can be disabled)
- Dropping the axe stops the animation
- Folia support - one jar for Paper, Purpur and Folia
- MiniMessage formatting: gradients, hex colors and more - classic
& codes still work
- English, German, French, Spanish, Polish, Russian, Portuguese, Turkish and Chinese included, add your own language with one file
- Lightweight: no recursion, cached materials, nothing runs while no tree is felled
- Optional auto update from Modrinth (off by default, checked with SHA-512) - new config options are added automatically, your values are kept
- Fast leaf decay - the leaves of a felled tree decay within seconds (leaves of other trees and placed leaves stay)
Commands & permissions
/bettertimber reload (alias /bt) - reloads config and messages, permission bettertimber.reload (OP by default)
- Players need no permission - everyone with a valid axe can fell trees.
Requirements
- Paper, Purpur or Folia 26.1 - 26.3
- Java 25
Bug report & support
If you need help or have a bug please contact me via discord (add hassanbwo). I will guarantee quick help - Thanks for supporting :)
config.yml
Add the axe types that may fell trees and the enchantments they need. Leave both lists empty to allow every axe.
# ==========================================
# BetterTimber – config.yml
# ==========================================
# You can customise the axes and enchantments here:
# If both are left blank, each axe is accepted regardless of whether it is enchanted or not.
# If only one field is left empty, either every axe is accepted or every enchantment or none.
# Check the plugin page for correct values:
# https://modrinth.com/plugin/bettertimber
# ==========================================
# Add-on "BetterTimberEnchantment" (https://modrinth.com/plugin/bettertimberenchantment):
# adds the enchantment "Timber" (enchanting table, villagers, loot). If it is installed, only axes with
# the Timber enchantment fell whole trees and valid_axes / required_enchantments below are not used.
# ==========================================
# If you need help or have a bug please contact me via discord (add hassanbwo).
# I will guarantee quick help - Thanks for supporting :)
# ==========================================
valid_axes:
- NETHERITE_AXE
required_enchantments:
unbreaking: 3
efficiency: 5
fortune: 3
mending: 1
# ==========================================
# Here you can decide whether bare hands can trigger the animation
# ==========================================
use_hand: false
# ==========================================
# When a player sneaks, the animation is not triggered. true by default.
# Deactivate it here (replace true with false), the message can be changed in the messages file.
# ==========================================
sneak_skip_enabled: true
# ==========================================
# Here you can choose if only one durability point should be taken per tree or as many as the tree has logs
# Example: If the tree has 5 logs, 5 durability points are taken (default = true)
# If you want only 1 durability point to be taken per tree, set this to false
# ==========================================
durability_per_log: true
# ==========================================
# The leaves of a felled tree decay quickly (within a few seconds instead of minutes).
# Leaves that still belong to another tree and leaves placed by players stay.
# The drops (saplings, sticks, apples) are the same as in vanilla.
# ==========================================
fast_leaf_decay: true
# ==========================================
# Here you can select if the speed of the wood chopping should be according to the type of axe (default = true)
# ==========================================
axe_type_speed_enabled: true
# ==========================================
# Here you can adjust the speeds, the higher the number the slower the animation
# ==========================================
axe_speed_multipliers:
WOODEN_AXE: 10
STONE_AXE: 8
IRON_AXE: 6
GOLDEN_AXE: 4
DIAMOND_AXE: 3
NETHERITE_AXE: 2
# ==========================================
# Language of all messages: en (English), de (Deutsch), fr (Français), es (Español),
# pl (Polski), ru (Русский), pt (Português), tr (Türkçe) or zh (简体中文)
# The texts are in messages_en.yml / messages_de.yml and support MiniMessage (<red>, <gradient:...>)
# and the classic color codes (&c). You can add your own language, e.g. messages_it.yml -> language: it
# /bettertimber reload (permission bettertimber.reload) reloads config and messages.
# ==========================================
language: en
# Updates from Modrinth: a newer version is always announced in the console.
# enabled: download new versions automatically. Downloads are checked with the SHA-512 checksum from Modrinth
# and installed on the next server restart (plugins/update folder). Only releases for your
# Minecraft version and server software (Paper, Purpur, Folia) are downloaded.
# major_versions: also download big updates (e.g. 2.x -> 3.0) automatically, otherwise they are only announced.
auto_update:
enabled: false
major_versions: false
messages_en.yml
All texts support MiniMessage (<red>, <bold>, <gradient:#ff5555:#ffaa00>Text</gradient>) and the classic & color codes. Translations are included for German, French, Spanish, Polish, Russian, Portuguese, Turkish and Chinese - switch with language: de, fr, es, pl, ru, pt, tr or zh in the config.
# ==========================================
# BetterTimber - messages (English)
# ==========================================
# Formatting: MiniMessage - https://docs.advntr.dev/minimessage/format
# Colors: <red>, <gold>, <#ff8800>
# Styles: <bold>, <italic>, <underlined>
# Gradients: <gradient:#ff5555:#ffaa00>Text</gradient>
# Rainbow: <rainbow>Text</rainbow>
# Classic color codes like &c, &l or &#ff8800 still work as well.
#
# Select the language in config.yml (language: en). You can also create your own
# file, e.g. messages_fr.yml, and set "language: fr". Missing texts fall back to English.
# Leave a message empty ("") to disable it.
# ==========================================
# Action bar when the player drops the axe during the animation
axe_dropped: "<gray>You've dropped your axe, stopped your <gradient:#ffaa00:#ff5500>lumberjack</gradient> action!"
# Action bar when the player sneaks (sneak_skip_enabled in config.yml)
sneak_skip: "<gray>You have sneaked, you are no longer a <gradient:#ffaa00:#ff5500>lumberjack</gradient>!"
# /bettertimber reload
reload_success: "<gradient:#ffaa00:#ff5500><bold>BetterTimber</bold></gradient> <gray>config reloaded successfully!"
no_permission: "<red>You do not have permission to use this command."
usage: "<red>Usage: /bettertimber reload"
Possible axes and enchantments
Axes: WOODEN_AXE, STONE_AXE, COPPER_AXE, IRON_AXE, GOLDEN_AXE, DIAMOND_AXE, NETHERITE_AXE
Enchantments (key: level): efficiency (1-5), unbreaking (1-3), fortune (1-3), mending (1), silk_touch (1), sharpness (1-5), smite (1-5), bane_of_arthropods (1-5), fire_aspect (1-2), vanishing_curse (1)
The axe must have exactly the listed enchantments with the listed levels.
More plugins by BetterPlugins
All for Paper, Purpur and Folia 26.x, in English, German, French, Spanish, Polish, Russian, Portuguese, Turkish and Chinese - see the whole BetterPlugins collection:
|
|
 |
BetterAFK - Stylish AFK holograms, auto-AFK, kick and more |
 |
BannerForLabyMod - Custom image banner above the tab list for LabyMod |
 |
BetterCarry - Carry and throw players, mobs and chests |
 |
BetterTimberEnchantment - Timber enchantment for BetterTimber - enchanting table, villagers, loot |
 |
BetterRIP - Graves that keep your items in their slots and your experience |
 |
BetterSort - Sort chests with one click, hotbar refill and quick stack |
 |
BetterWaystones - Build, discover and travel between waystones - own 3D model, no resource pack |
评论 0
登录后参与评分
还没有评论,来抢沙发吧