Peterwolfs Realistic Tree Felling

PeterWolf’s Realistic Tree Felling

砍下一刀，看整棵树倒下。

PeterWolf’s Realistic Tree Felling 将 Minecraft 静态的砍树方式，替换为流畅且符合物理效果的伐木动画。

用斧头砍倒天然树干后，整棵相连的树会作为一个整体，朝远离角色的方向倒下。树干、树枝和树冠会一同旋转、落在地形上，并保留在原地供你继续处理。

没有悬空的原木。没有瞬间消失的树木。也不会在一帧内连锁破坏每个方块。

功能

真实的树木倒落

用斧头砍倒有效的天然树木时：

1. 模组会检测相连的树干和树冠。
2. 整棵树会转换为一个同步倒落的实体。
3. 树木会以切口为轴旋转。
4. 树木会朝远离玩家的方向倒下。
5. 树干和未被破坏的树冠会重新放置回世界中。

动画会平滑加速，渲染方向与最终方块放置方向保持一致。

自然倒落方向

树木会朝玩家面朝方向的反方向倒下。

砍完树之前调整站位，即可控制树木倒下的位置。

服务器负责计算倒落方向、方块移除、动画状态和最终放置位置。

倒下的原木

树木倒地后，原木仍会留在世界中。

每段倒落的原木：

• 会按照实际倒落方向摆放。
• 可以用斧头砍伐。
• 需要砍两到三下。
• 会直接放入你的物品栏。
• 物品栏满时，会掉落在你身旁。

这样一来，采伐倒下的树木更像是在加工木材，而不是瞬间收获整棵树。

树冠撞击

树木撞上地面时，部分树冠会被压碎。

被压碎的树叶：

• 会掉落木棍。
• 有几率掉落对应的原版树苗。
• 支持红树胎生苗。
• 不会在树桩周围重新出现。

保留下来的树叶会放置在倒落树干远端附近，并继续遵循 Minecraft 原版树叶的自然衰败机制。

兼容原版的操作方式

无需学习新的按键组合即可使用模组。

• 手持斧头。
• 像平常一样破坏天然树干方块。
• 树木会自动倒下。
• 潜行时破坏方块，则使用原版的普通方块破坏方式。

最初砍伐方块时，斧头仍按标准速度生效，并正常应用附魔和耐久消耗。

智能树木检测

模组使用基于 Minecraft 方块标签且设有上限的树木检测机制。

支持：

• 原版原木。
• 基于标签的模组原木。
• 相连的树枝。
• 相连的树叶树冠。
• 形状不规则的天然树干。
• 可配置的高度和方块数量上限。

检测器会排除没有足够垂直树干的结构，从而降低将木墙或水平建筑误判为树木的风险。

支持多人游戏

树木检测和倒落逻辑由服务器权威控制。

服务器负责控制：

• 树木验证。
• 倒落方向。
• 方块移除。
• 倒落实体状态。
• 最终方块放置。
• 物品处理。

客户端只负责渲染同步后的动画。

这样可以防止玩家伪造树木数据，并确保多人游戏中的行为保持一致。

重启后继续倒落

倒落实体会保存：

• 锚点位置。
• 倒落方向。
• 当前年龄。
• 已捕获的原木。
• 已捕获的树叶。

倒落过程中服务器重启时，树木处理流程可以继续，而不是悄无声息地删除树木。

可配置

首次启动时会创建：

config/peterwolfs-realistic-tree-felling.json

配置包含以下选项：

• 树木检测范围。
• 树木最大高度。
• 捕获方块数量上限。
• 伤害规则。
• 着陆行为。
• 撞击设置。
• 预览选项。
• 原版潜行行为。
• 模组原木支持。
• 坠落实体存续时间。

命令

所有命令都需要游戏管理员权限。

/treefelling reload
/treefelling config
/treefelling debug on
/treefelling debug off
/treefelling inspect
/treefelling preview
/treefelling cancel
/treefelling forcefall

使用 /treefelling inspect 查看：

• 检测到的树木高度。
• 树木质量。
• 捕获的方块数量。
• 预测的倒下方向。

安装

要求：

• Minecraft Java 版 26.2
• Fabric Loader 0.19.3 或更高版本
• Fabric API 0.153.0+26.2 或更高版本
• Java 25

请在客户端和专用服务器上都安装此模组。

将模组文件放入：

.minecraft/mods

对于专用服务器，请将相同文件放入服务器的 mods 目录。

当前版本

此版本包含首个可游玩的伐木系统。

目前已实现：

• 自然树木检测。
• 单次砍伐触发。
• 倒下的树木实体。
• 树木平滑旋转。
• 定向倒下。
• 倒下原木的处理。
• 树冠撞击掉落物。
• 多人游戏同步。
• 服务器重启后保留状态。
• 配置和调试命令。

计划改进内容包括：

• 改进地形碰撞。
• 撞击伤害。
• 脆弱方块破坏。
• 与保护类模组集成。
• 改进树木模型。
• 着陆区域预览。
• 更高级的定向砍伐。

重要提示

当前版本不使用三角形缺口、背切或铰链模拟。

树木会在一次普通斧头破坏后倒下，并根据玩家面朝的方向确定着陆位置。

标语

巧妙砍伐，真实倒下。