? TreeChopper — 带有掉落动画的伐木插件 | Paper · Spigot · Folia 1.16-26.2
砍断一根原木,看着整棵树倒下。
TreeChopper 是一款轻量级、注重性能的伐木插件,适用于 Paper、Spigot 和 Folia 服务器。使用斧头击中任何原木,整棵树就会坍塌——原木会一层层翻滚落下,带有真实的物理效果,树叶会自动腐烂,树苗会在树根处自动重新种植。
无需客户端模组。无重型依赖。只需放入 jar 文件即可运行。
✨ 为什么选择 TreeChopper?
大多数伐木插件都是多年前构建的,从未适应现代多线程服务器。TreeChopper 专为 现代 Minecraft 1.16-26.2 构建,具备真正的 Folia 支持 和完整的 原木掉落动画。
一款兼具掉落动画和真正 Folia 兼容性的伐木插件。
? 核心功能
掉落动画
原木不会凭空消失。它们会从顶部到底部断裂,并以 FallingBlock(掉落物)实体的形式向外飞出,遵循真实的 Minecraft 物理规则。
智能树木分离
并排生长的两棵树会被独立处理。砍倒一棵树,另一棵保持完好。所有权检查可防止对树叶、根系和附着植被造成跨树伤害。
2×2 巨型树支持
树干为 2×2 的大型丛林树、云杉树和黑橡树会被检测并作为整体进行砍伐。
改进的原版树木处理
更准确地处理复杂的自然树木,如 樱花木 (Cherry)、苍白橡木 (Pale Oak) 和 红树林 (Mangrove),包括不规则的树干形状、悬挂植被、气生根、可可果和红树林根系。
所有原版木材类型
橡木 · 白桦木 · 云杉木 · 丛林木 · 黑橡木 · 金合欢木 · 樱花木 · 红树林木 · 绯红菌柄 · 诡异菌柄 · 蘑菇菌柄
自动树叶腐烂
原木倒下后,被砍伐树木的树叶会自动破碎。与邻树共享的树叶将保持不变。
附着植被清理
藤蔓、可可果、苍白悬挂苔藓、红树林气生根等类似植被会被检测并随对应的树木一起清除。
⚖️ 平衡性与游戏体验
耐久度与无损
每砍断一根原木,斧头会消耗一点耐久度。无损附魔会对整棵树应用概率计算,符合原版行为。
时运与精准采集
斧头上的附魔会作用于每一根掉落的原木,而不仅仅是第一根。
玩家放置的原木保护
玩家放置的原木会被追踪,永远不会触发大规模砍伐。
结构检测 启发式分析有助于防止插件将村庄房屋、前哨站和其他生成的结构误认为是自然树木。
潜行激活模式
选择插件的激活方式:
ALWAYS_ON— 持有斧头时始终激活SNEAK_DISABLE— 默认激活,按住潜行键以禁用SNEAK_ENABLE— 默认禁用,按住潜行键以激活
单人开关
每个玩家可以使用 /treechopper toggle 为自己启用或禁用伐木功能。状态在会话之间持久保存。
? 插件集成
| 插件 | 行为 |
|---|---|
| WorldGuard | 在受保护区域内禁止砍伐 |
| GriefPrevention | 在被认领的土地上禁止砍伐 |
| CoreProtect | 每根被破坏的原木和重新种植的树苗都会记录在玩家名下 |
所有集成均为 软依赖。TreeChopper 在没有这些插件的情况下也能完美运行。
? 自动重植
砍伐树木后,树苗会自动放置在树根处:
- 支持普通树和巨型树(2×2)
- 可配置:从玩家物品栏中获取树苗,或免费放置
- 尊重 WorldGuard 和 GriefPrevention
- 修复了保护流程,如果放置被拒绝,树苗 不会被消耗
- 可以限制仅用于自然树木
- 按世界启用/禁用列表
⚙️ 配置
config.yml — 点击展开
language:
default: en # en · ru · uk
fallback: en
limits:
max-logs: 512
leaf-search-radius: 6
foreign-log-scan-radius: 8
performance:
max-blocks-per-task: 16
activation:
mode: SNEAK_DISABLE # ALWAYS_ON · SNEAK_DISABLE · SNEAK_ENABLE
player-toggle:
enabled: true
default-enabled: true
save-on-change: true
detection:
min-leaf-contacts: 4
min-mega-leaf-contacts: 8
max-structure-contacts: 4
protection:
enabled: true
use-worldguard: true
use-griefprevention: true
mode: FAIL_WHOLE_TREE
integrations:
coreprotect:
enabled: true
auto-replant:
enabled: true
require-sapling: false
consume-sapling: false
delay-ticks-after-fell: 20
replant-mega-trees: true
mega-mode: four-saplings # single · four-saplings
respect-protection: true
only-natural-trees: true
disabled-worlds: []
? 命令与权限
| 命令 | 权限 | 默认值 | 描述 |
|---|---|---|---|
/treechopper toggle |
treechopper.toggle |
所有人 | 为自己启用/禁用伐木功能 |
/treechopper reload |
treechopper.reload |
op | 重新加载配置和所有服务,无需重启 |
? 本地化
内置翻译:English, Russian, Ukrainian
语言文件位于 plugins/TreeChopper/lang/,可以自由编辑。在 config.yml 下的 language.default 中切换语言。
? 完美适用于
- SMP 服务器 — 令人满意的便利性提升,同时不破坏生存平衡
- Vanilla+ 服务器 — 感觉像是游戏自然的组成部分
- 经济类服务器 — 时运作用于所有原木;耐久度仍然重要
- Folia 服务器 — 安全的线程调度配合掉落动画
- 使用 WorldGuard / GriefPrevention / CoreProtect 的服务器 — 原生集成
? 要求
- 服务器: Paper, Spigot, 或 Folia
- Java: 21+
- Minecraft: 1.16-26.2
专为现代服务器构建,已通过 49 项单元测试。采用 MIT 许可证授权。
? TreeChopper — Tree Felling Plugin with Falling Animation | Paper · Spigot · Folia 1.16-26.2
Break one log. Watch the whole tree fall.
TreeChopper is a lightweight, performance-focused tree felling plugin for Paper, Spigot, and Folia servers. Hit any log with an axe and the entire tree collapses — logs tumble down layer by layer with real physics, leaves decay automatically, and a sapling replants itself at the base.
No client mods. No heavy dependencies. Just drop the jar and it works.
✨ Why TreeChopper?
Most tree felling plugins were built years ago and never adapted to modern threaded servers. TreeChopper is built for modern Minecraft 1.16-26.2, with real Folia support and a full falling log animation.
A tree chopper plugin with both falling animation and real Folia compatibility.
? Core Features
Falling animation
Logs do not just vanish. They break top-to-bottom and fly outward as FallingBlock entities with real Minecraft physics.
Smart tree separation
Two trees growing side by side are treated independently. Chop one tree and the other stays intact. Ownership checks prevent cross-tree damage to leaves, roots, and attached vegetation.
2×2 mega tree support
Large Jungle, Spruce, and Dark Oak trees with a 2×2 trunk are detected and felled as a single unit.
Improved vanilla tree handling
Complex natural trees such as Cherry, Pale Oak, and Mangrove are handled more accurately, including irregular trunk shapes, hanging vegetation, propagules, cocoa, and mangrove roots.
All vanilla wood types
Oak · Birch · Spruce · Jungle · Dark Oak · Acacia · Cherry · Mangrove · Crimson Stem · Warped Stem · Mushroom Stem
Automatic leaf decay
After the logs fall, leaves from the chopped tree break automatically. Leaves shared with a neighboring tree are left untouched.
Attached vegetation cleanup
Vines, cocoa, pale hanging moss, mangrove propagules, and similar vegetation are detected and removed along with the correct tree.
⚖️ Balance & Gameplay Feel
Durability & Unbreaking
The axe loses one durability per log broken. Unbreaking is applied probabilistically across the whole tree, matching vanilla behavior.
Fortune & Silk Touch
Enchantments on your axe apply to every log that falls, not just the first one.
Player-placed log protection
Logs placed by players are tracked and never trigger mass felling.
Structure detection
Heuristic analysis helps prevent the plugin from treating village houses, outposts, and other generated structures as natural trees.
Sneak activation modes
Choose how the plugin activates:
ALWAYS_ON— always active with an axeSNEAK_DISABLE— active by default, hold sneak to disableSNEAK_ENABLE— disabled by default, hold sneak to activate
Per-player toggle
Each player can enable or disable tree chopping for themselves using /treechopper toggle. State persists across sessions.
? Plugin Integrations
| Plugin | Behavior |
|---|---|
| WorldGuard | Felling is blocked inside protected regions |
| GriefPrevention | Felling is blocked inside claimed land |
| CoreProtect | Every broken log and replanted sapling is logged under the player's name |
All integrations are soft dependencies. TreeChopper works perfectly without any of them.
? Auto-Replant
After a tree is felled, a sapling is automatically placed at the base:
- Supports regular and mega (2×2) trees
- Configurable: take sapling from player inventory, or place it for free
- Respects WorldGuard and GriefPrevention
- Fixed protection flow so saplings are not consumed if placement is denied
- Can be limited to natural trees only
- Per-world enable/disable list
⚙️ Configuration
config.yml — click to expand
language:
default: en # en · ru · uk
fallback: en
limits:
max-logs: 512
leaf-search-radius: 6
foreign-log-scan-radius: 8
performance:
max-blocks-per-task: 16
activation:
mode: SNEAK_DISABLE # ALWAYS_ON · SNEAK_DISABLE · SNEAK_ENABLE
player-toggle:
enabled: true
default-enabled: true
save-on-change: true
detection:
min-leaf-contacts: 4
min-mega-leaf-contacts: 8
max-structure-contacts: 4
protection:
enabled: true
use-worldguard: true
use-griefprevention: true
mode: FAIL_WHOLE_TREE
integrations:
coreprotect:
enabled: true
auto-replant:
enabled: true
require-sapling: false
consume-sapling: false
delay-ticks-after-fell: 20
replant-mega-trees: true
mega-mode: four-saplings # single · four-saplings
respect-protection: true
only-natural-trees: true
disabled-worlds: []
? Commands & Permissions
| Command | Permission | Default | Description |
|---|---|---|---|
/treechopper toggle |
treechopper.toggle |
everyone | Enable/disable tree chopping for yourself |
/treechopper reload |
treechopper.reload |
op | Reload config and all services without restart |
? Localization
Built-in translations: English, Russian, Ukrainian
Language files are in plugins/TreeChopper/lang/ and can be freely edited. Switch language in config.yml under language.default.
? Perfect For
- SMP servers — satisfying QoL without breaking survival balance
- Vanilla+ servers — feels like a natural part of the game
- Economy servers — Fortune applies to all logs; durability still matters
- Folia servers — safe threaded scheduling with falling animation
- Servers using WorldGuard / GriefPrevention / CoreProtect — native integration
? Requirements
- Server: Paper, Spigot, or Folia
- Java: 21+
- Minecraft: 1.16-26.2
Built for modern servers. Tested with 49 passing unit tests. MIT licensed.
下载 TreeChopperUltra
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 TreeChopperUltra
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 TreeChopperUltra
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 TreeChopperUltra
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 TreeChopperUltra
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 TreeChopperUltra
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 TreeChopperUltra
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 TreeChopperUltra
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
TreeChopper 1.7.0
此版本新增了玩家统计、占位符、新翻译以及更广泛的服务器兼容性。
新增内容
- 通过
/treechopper stats查看玩家统计数据 - 通过
/treechopper top查看服务器排行榜 - 为个人统计数据和排行榜数据提供 PlaceholderAPI 占位符支持
- 内置波兰语、德语、法语、西班牙语、意大利语和捷克语翻译
兼容性
- 支持 Paper / Spigot / Folia
- 恢复对 Java 8+ 的运行时支持
- 在更多受支持的旧版 Minecraft 服务器版本中实现更广泛的兼容性
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
插件
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
评论 0
登录后参与评分
还没有评论,来抢沙发吧