🌳 AdventureTreeGrowth

一、简介

AdventureTreeGrowth —— 树木生长控制与一键砍树系统

控制服务器中树木的自然生长速率，提供一键砍树功能（砍底部原木自动砍倒整棵树），以及树叶群系着色系统（CraftEngine 集成）。

支持 Paper 1.21.4+ 服务器（Java 21）。

核心特性

  • 生长速率控制 — 按树种独立配置生长速度倍率
  • 一键砍树 — 砍底部原木自动连锁砍倒整棵树（含树叶）
  • 工具耐久消耗 — 一键砍树按方块数扣除耐久
  • 树叶群系着色 — CraftEngine 自定义树叶颜色贴图
  • 世界白名单 — 可指定只在特定世界启用

二、插件前置说明

  • CraftEngine — 可选，树叶群系着色功能
下一篇安装与配置 →

📥 安装与配置

环境要求

项目要求
服务端Paper 1.21.4+
Java21+
可选依赖CraftEngine

安装步骤

  1. 放入 AdventureTreeGrowth-1.1.0.jar
  2. 启动服务器自动生成配置
  3. 编辑 config.yml
  4. /atree reload
上一篇← 概览
下一篇生长控制 →

🌱 生长控制

通过拦截 StructureGrowEvent 控制树木自然生长速率：

growth:
  enabled: true
  rates:
    OAK: 1.0           # 正常速度
    SPRUCE: 0.5         # 50% 速度
    BIRCH: 0.8
    JUNGLE: 0.3         # 30% 速度（丛林树太大）
    ACACIA: 0.6
    DARK_OAK: 0.4
    CHERRY: 1.0
    MANGROVE: 0.5

设为 0 完全禁止该树种自然生长，设为 2.0 则双倍速度。

上一篇← 安装与配置
下一篇一键砍树 →

🪓 一键砍树

玩家使用斧头砍树底部原木时，自动连锁砍倒整棵树（包括树叶）。

配置

timber:
  enabled: true
  require-axe: true       # 必须使用斧头
  consume-durability: true # 按方块数扣耐久
  max-blocks: 256          # 单棵树最大方块数
  sneak-to-toggle: true    # 潜行时禁用（正常砍）
上一篇← 生长控制
下一篇树叶着色 →

🍃 树叶群系着色

与 CraftEngine 集成，为不同群系的树叶提供自定义颜色贴图，让树叶颜色更加丰富自然。

着色数据通过 bake_leaf_tints.py 工具生成，烘焙到资源包中。

上一篇← 一键砍树
下一篇命令列表 →

⌨️ 命令列表

命令说明权限
/atree reload重载配置atree.admin
/atree toggle切换一键砍树atree.use
上一篇← 树叶着色
下一篇配置文件 →

⚙️ 配置文件

所有配置均在 config.yml 中，详见「生长控制」和「一键砍树」章节的示例。

上一篇← 命令列表
下一篇更新日志 →

📝 更新日志

v1.1.0 最新

  • NEW 树叶群系着色 — CraftEngine 集成，自定义树叶颜色
  • NEW bake_leaf_tints.py — 着色数据烘焙工具

v1.0.0

  • NEW 初始发布 — 树木生长速率控制、一键砍树、工具耐久消耗、世界白名单
上一篇← 配置文件
© 2024-2026 Feiiy · AdventureTreeGrowth 树木生长控制 · QQ: 823959438