? Topple
会真正倒下的树木。砍断一根原木,整棵树就会倾斜、倒塌并掉落 loot(战利品),落在它着地的位置。
不是瞬移成一堆物品:而是真实、流畅的倒下动画,树冠摆动落下,撞击时弹跳一下,并溅出树叶碎片。
仅服务端。无需资源包、模组或依赖项。支持 Paper 和 Folia,版本 1.20 → 26.x。
✨ 功能特性
? 砍伐整棵树
- 用斧头击打最底部的原木,其上方的所有原木、树叶、藤蔓和可可豆都会随之一起掉落。
- 如果从中间砍断,只有上半部分会倒下,留下一个树桩。
- 也能识别树枝(包括金合欢、樱桃、红树林、丛林木),像黑橡树、丛林木和巨型云杉这样的2×2 大树会作为整体倒下。
- 潜行可以只获取单个原木,这是原版的行为方式。执行
/topple toggle 可关闭你自己的伐木功能。
? 真实的倒下动画
- 树木以树桩为轴心转动,就像真正的树干一样:起初缓慢,然后加速,最后砰然落地。
- 它会向远离你的方向倒下,绝不会砸在你头上。
- 在平坦地面上会平躺,在墙壁和山坡上会倾斜,还会从悬崖边缘翻落。
- 开始时发出木头嘎吱声,落地时有撞击声和树叶碎片,短暂弹跳后碎裂成 loot。
- 基于原版方块显示实体(block displays)构建,客户端进行插值处理,因此即使服务器卡顿也能保持流畅,且无需任何资源包即可让所有玩家看到效果。
? Loot 落在着地处
- 原木、树苗、苹果和木棍会掉落在每个方块着地的地面位置。沿着倒下的树干走,就能把它们全部拾取。
- 喜欢简单模式?可以将掉落物发送到树桩处或直接放入背包。
- 完全符合原版掉落机制: Fortune(时运)对树叶生效,精准采集、剪刀行为以及掉落表均正常运作。
? 自动重新种植
- 一棵树苗会在树干原来的位置弹出,并带有小小的粒子特效。2×2 的大树会生成四棵,这样黑橡树就能恢复生长。
- 菌类会重新出现在下界岩上,红树林气生根会出现在泥块上。
- 可选设置要求树苗必须来自该树的掉落物,确保不会凭空生成。
? 永远不会砍倒你的房子
- Topple 会记住玩家放置的每一个原木,数据存储在区块本身中(无需数据库)。由原木砌成的墙壁、小屋和屋顶永远不会被“连根拔起”。
- 树木需要自然生成的树叶。玩家手动放置的树叶不会腐烂,因此带有装饰性树叶的原木柱子会保持原位。
- 两棵树相互接触?只有你砍的那一棵会倒下。它的邻居保留其树干和树冠。
- 大型建筑也很安全:超过
max-logs 数量的大树会被逐根砍伐。
?️ 与服务器完美兼容
- 保护机制兼容: WorldGuard、GriefPrevention、Lands、Towny 及其他领地插件都会被查询每个方块的状态。如果任一方块受保护,则只有你击打的那个原木会被破坏。
- CoreProtect 会记录每一棵被砍伐的树木,以便回溯树木破坏行为。
- 斧头耐久度按每根原木扣除(考虑了无损修复),并且斧头永远不会因为砍树而损坏:如果耐久度不足以一次性砍倒,你会逐根砍伐。
- 每砍一根原木消耗饥饿值,统计原版挖掘数据,蜂巢中的蜜蜂会被惊飞。
- 原生支持 Folia: 每个方块、实体和掉落物都由拥有它的区域处理。
? 游戏中的每一种树
橡木、云杉、白桦、丛林、金合欢、黑橡、红树林、樱桃、苍白橡木、杜鹃花树、绯红菌索和诡异菌索以及巨型蘑菇。木材类型源自 Minecraft 自身的标签系统,因此未来更新添加的新树木无需插件更新即可支持。
⌨️ 命令
| 命令 |
描述 |
权限 |
/topple toggle |
开启或关闭你自己的树木砍伐功能 |
topple.toggle |
/topple stats |
查看已砍伐的树木数量和砍断的原木数 |
topple.use |
/topple toggle <player> |
切换其他玩家的设置 |
topple.admin |
/topple stats <player> |
查看其他玩家的统计信息 |
topple.admin |
/topple reload |
重载配置文件和消息 |
topple.admin |
砍伐功能需要 topple.use 权限(默认开启)。别名:/timber。topple.notify (op) 用于通知管理员更新信息。
⚙️ 配置
所有选项均可切换,执行 /topple reload 即可实时应用更改:
activation: standing # standing(潜行=单根原木), sneaking(潜行激活), always(始终激活)
require-axe: true
fall-direction: away # 或 random(随机)
drops: landing # landing(着地), stump(树桩), inventory(背包)
tree:
max-logs: 256
leaves: fall # fall(随树倒下), break(破碎), decay(腐烂)
nether-trees: true
huge-mushrooms: true
animation:
enabled: true # false = 经典瞬间伐木
speed: 1.0 # 0.5 = 慢动作
settle-ticks: 30
sounds:
impact:
- "minecraft:entity.zombie.break_wooden_door 0.9 0.6"
replant:
enabled: true
use-drops: true
durability:
per-log: 1
protect-axe: true
此外还支持按世界禁用、视距、粒子效果、饥饿值消耗以及所有音效。所有消息均使用 MiniMessage 格式;内置英文和波兰文,你可以添加自己的 lang/<name>.yml 文件。
? PlaceholderAPI
| 占位符 |
值 |
%topple_enabled% |
true / false |
%topple_trees% |
已砍伐的树木数量 |
%topple_logs% |
砍伐过程中砍断的原木数量 |
?? 开发者接口
TreeFellEvent 在树木倒下前触发。你可以取消事件、读取即将倒下的原木和树叶,或改变倒下方向:
@EventHandler
public void onFell(TreeFellEvent event) {
if (event.getLogs().size() > 100) event.setCancelled(true);
event.setDirection(new Vector(1, 0, 0)); // 总是向东倒下
}
? 兼容性
|
|
| 服务端 |
Paper, Folia, Purpur 及其他 Paper 分支 |
| 版本 |
1.20 → 26.x |
| Java |
17+ (1.20.5 及更高版本需 Java 21+,正如 Minecraft 自身要求) |
| 依赖项 |
无。PlaceholderAPI 为可选依赖 |
| 客户端 |
原版客户端。无需安装任何东西 |
不支持纯 Spigot:Topple 使用了 Paper 的调度器和物品 API。
? Topple
Trees that really fall. Chop one log and the whole tree tips over, crashes to the ground and drops its loot where it lands.
Not a teleporting pile of items: a real, smooth falling animation, with the crown swinging down, a bounce on impact and a burst of leaves.
Server-side only. No resource pack, no mods, no dependencies. Paper and Folia, 1.20 → 26.x.
✨ Features
? Fell the whole tree
- Hit the bottom log with an axe and every log, leaf, vine and cocoa pod above it comes down together.
- Cut halfway up and only the top falls, leaving a stump behind.
- Branches are found too (acacia, cherry, mangrove, jungle), and 2×2 trees like dark oak, jungle and giant spruce fall as one.
- Sneak to take a single log, the vanilla way.
/topple toggle turns felling off for yourself.
? A real falling animation
- The tree turns around its stump like a real trunk: slow at first, then faster, then thud.
- It falls away from you, never on your head.
- It lies flat on level ground, leans on walls and hills, and tips over the edge of a cliff.
- Creaking wood when it starts, a crash and leaf debris when it lands, a short bounce, then it breaks apart into loot.
- Built on vanilla block displays with client-side interpolation, so it is smooth even when the server isn't, and works for every player without a resource pack.
? Loot where it lands
- Logs, saplings, apples and sticks drop on the ground where each block landed. Walk along the fallen trunk and pick it all up.
- Prefer it simple? Send drops to the stump or straight into the inventory.
- Real vanilla drops: Fortune on leaves, Silk Touch, shears behaviour and loot tables all still apply.
? Auto-replant
- A sapling pops back where the trunk stood, with a little sparkle. 2×2 trees get four, so dark oak grows back.
- Fungi go back on nylium, mangrove propagules on mud.
- Optionally the sapling must come from the tree's own drops, so nothing is created out of thin air.
? Never fells your house
- Topple remembers every log a player places, inside the chunk itself (no database). Log walls, cabins and roofs are never felled.
- Trees need natural leaves. Player-placed leaves never decay, so a log pillar with decorative leaves stays put.
- Two trees touching? Only the one you chopped falls. Its neighbour keeps its trunk and its crown.
- Huge builds are safe too: anything over
max-logs is chopped one log at a time.
?️ Plays nice with your server
- Protection aware: WorldGuard, GriefPrevention, Lands, Towny and other claim plugins are asked about every block. If any is protected, only the log you hit breaks.
- CoreProtect logs every felled block, so tree griefing can be rolled back.
- Axe durability is charged per log (Unbreaking counts), and the axe is never broken by a tree: if it can't take it, you chop log by log.
- Hunger cost per log, vanilla mining statistics, bee nests release their bees.
- Folia native: every block, entity and drop is handled by the region that owns it.
? Every tree in the game
Oak, spruce, birch, jungle, acacia, dark oak, mangrove, cherry, pale oak, azalea trees, crimson and warped fungi and huge mushrooms. Wood types come from Minecraft's own tags, so trees added in future updates work without a plugin update.
⌨️ Commands
| Command |
Description |
Permission |
/topple toggle |
Turn tree felling on or off for yourself |
topple.toggle |
/topple stats |
Trees felled and logs chopped |
topple.use |
/topple toggle <player> |
Toggle for someone else |
topple.admin |
/topple stats <player> |
Someone else's stats |
topple.admin |
/topple reload |
Reload config and messages |
topple.admin |
Felling needs topple.use (on by default). Alias: /timber. topple.notify (op) tells admins about updates.
⚙️ Configuration
Everything is switchable, and /topple reload applies changes live:
activation: standing # standing (sneak = one log), sneaking, always
require-axe: true
fall-direction: away # or random
drops: landing # landing, stump, inventory
tree:
max-logs: 256
leaves: fall # fall, break, decay
nether-trees: true
huge-mushrooms: true
animation:
enabled: true # false = classic instant timber
speed: 1.0 # 0.5 = slow motion
settle-ticks: 30
sounds:
impact:
- "minecraft:entity.zombie.break_wooden_door 0.9 0.6"
replant:
enabled: true
use-drops: true
durability:
per-log: 1
protect-axe: true
Plus per-world disabling, view range, particles, hunger cost and every sound. All messages use MiniMessage; English and Polish are included, and you can add your own lang/<name>.yml.
? PlaceholderAPI
| Placeholder |
Value |
%topple_enabled% |
true / false |
%topple_trees% |
Trees felled |
%topple_logs% |
Logs chopped while felling |
?? For developers
TreeFellEvent fires before a tree falls. Cancel it, read the logs and leaves that will fall, or change the direction:
@EventHandler
public void onFell(TreeFellEvent event) {
if (event.getLogs().size() > 100) event.setCancelled(true);
event.setDirection(new Vector(1, 0, 0)); // always fall east
}
? Compatibility
|
|
| Servers |
Paper, Folia, Purpur and other Paper forks |
| Versions |
1.20 → 26.x |
| Java |
17+ (21+ for 1.20.5 and newer, as Minecraft itself requires) |
| Dependencies |
None. PlaceholderAPI optional |
| Clients |
Vanilla. Nothing to install |
Plain Spigot is not supported: Topple uses Paper's scheduler and item APIs.
评论 0
登录后参与评分
还没有评论,来抢沙发吧