HereLoggy
一款高端 Paper Minecraft 插件,用于全自动伐木和树木砍伐——系统性地发现树木、执行递归式整树清理、动态管理库存存储、切换并补充斧头、自动进食、抵御敌对生物、重新种植树苗,并通过 AuraSkills 集成提升升级速度!
功能特性
-
双斧选择与路径映射:
- 选择快捷简单:手持任意一把斧头,潜行 + 右键点击即可设置 A点 和 B点 的边界坐标。
- 插件会自动触发对该区域的异步扫描以映射可通行方块并发现树木位置,从而避免服务器卡顿。
-
动态自动砍伐模式:
- 整树模式 (BFS):使用带有径向邻接度为2的智能递归广度优先搜索(BFS),从单次基础劈砍开始遍历并破坏整个树木结构(最高512个方块的的安全限制)。
- 可达模式:仅砍伐玩家标准攻击高度范围内的木材方块(最高眼睛高度+3个方块),尊重传统生存机制。
-
自动清除树叶与障碍物:
- 定期扫描玩家周围局部半径内的区域,以自动破坏树叶、藤蔓和下界植被。
- 保持行走路径完全畅通,防止玩家被卡住或困住。
- 紧急被困与窒息救援:主动监控玩家是否因窒息或被困在实心方块内(例如由于树木生长导致的原木/树叶,或被推入地下)。立即在一个 5x5x5 的立方体区域内砍伐任何原木和树叶,并将玩家传送到最近的安全路径节点或相邻的安全地面坐标。
-
智能工具保护与补给:
- 实时监控斧头的耐久度。自动交换快捷栏中的活跃状态斧头到背包中的另一把斧头,以防止工具损坏。
- 工具供应补给:链接一个装有备用斧头的工具供应箱。如果耐久度降至用户定义阈值以下且手头没有备用件,玩家将传送到箱子处,存入磨损的斧头,取出一把新的,然后传送回原位以立即恢复伐木工作!
-
高级存储路由与保留/丢弃箱:
- 使用设置向导链接一个保留箱(用于珍贵原木)和一个丢弃箱(用于树苗、树叶、额外掉落物)。
- 当玩家库存满时,插件会自动将物品路由至存放箱。如果箱子已满或未配置,会话会安全暂停而不是丢弃物品。
- 允许针对每种木材类型配置路由目标(保留、丢弃或随身携带)。
-
集成敌对生物防御与自动进食:
- 监控周围实体并积极为玩家防御敌对生物,在武器冷却期间暂停砍伐木材。
- 智能全库存进食:当饥饿值低于饱和度限制时,自动消耗任何库存槽位(不仅仅是快捷栏)中的食物。
- 智能食物保护:在进行自动化库存转储至保留/丢弃箱时,机器人会自动识别并保留库存中最大的食物堆叠(熟食或生食),以确保连续操作。
-
真空掉落吸引与共享经验修补:
- 自动真空吸引破碎方块周围6格半径内的所有掉落物和经验球。
- 将收集到的方块破坏经验直接导向修复附魔了 Mending(经验修补)的快捷栏工具(优先处理受损最严重的斧头),将剩余的经验值分配给玩家。
-
自动树苗重新种植:
- 如果启用,在树木被砍伐后立即在土壤、泥土、菌岩或灵魂土上放置匹配的树苗,只要玩家的库存或副手中有树苗可用。
-
AuraSkills 集成:
- 完全支持 AuraSkills(前身为 Aurelium Skills)。
- 为破碎的原木方块和吸引的经验球授予获奖的采集经验。
- 玩家移动速度倍率根据其当前的采集等级 (
1.0 + 采集等级 * 0.01) 动态缩放。
-
HereRolePlay 集成:
- 为每个破碎的原木和木材方块直接向玩家授予收集经验点数,帮助矿工和管理员职业升级。
-
交互式配置 GUI:
- 一个美观的全功能图形界面,用于切换活动状态、重新种植偏好以及10种树木类型的库存路由目标:橡树、云杉、白桦、丛林、金合欢、深色橡木、红树林、樱花、绯红菌和诡异菌。
命令
所有命令都可以用 /hl 代替 /hereloggy 运行。
| 命令 |
描述 |
权限 |
/hereloggy start (或 /hl start) |
开始自动砍伐(如果存在选择但尚未扫描,则先触发区域扫描) |
hereloggy.use |
/hereloggy stop (或 /hl stop) |
停止活动砍伐会话并显示统计数据 |
hereloggy.use |
/hereloggy restart (或 /hl restart) |
从上次暂停的方块索引处恢复自动砍伐 |
hereloggy.use |
/hereloggy config (或 /hl config) |
打开交互式 GUI 以配置单个树木设置 |
hereloggy.config |
/hereloggy setup (或 /hl setup) |
启动用于箱子和阈值的交互式聊天设置向导 |
hereloggy.setup |
/hereloggy clear (或 /hl clear) |
清除点选择、扫描和玩家设置 |
hereloggy.use |
权限
| 权限 |
描述 |
默认值 |
hereloggy.use |
允许使用 /hereloggy 命令 |
true |
hereloggy.setup |
允许使用设置向导 |
true |
hereloggy.config |
允许使用树木配置 GUI |
true |
使用方法
1. 选择边界区域
- 在主手持有任意斧头。
- 潜行 + 右键点击一个方块以标记 A点。
- 潜行 + 右键点击另一个方块以标记 B点(定义伐木范围)。
- 插件将绘制可通行路径并提示已就绪。
2. 交互式设置向导
- 运行
/hl setup。
- 步骤 1:手持斧头,潜行 + 右键点击一个用于存放 废弃物品(树苗、树叶等)的箱子。
- 步骤 2:潜行 + 右键点击一个用于存放 珍贵原木(保留箱)的箱子。
- 步骤 3:潜行 + 右键点击一个存放 备用斧头(工具补给)的箱子,或在聊天栏输入
skip。
- 步骤 4:输入斧头耐久度阈值(例如
12),或输入 skip(默认为 10)。
- 设置完成!你的配置将保存在
plugins/HereLoggy/setup-configs/{playerId}.yml 中。
3. 树木配置 GUI
- 运行
/hl config 打开主菜单。
- 在主菜单下:
- 点击底部中央的 砍伐方式 图标,在 整树模式(BFS 递归砍伐)和 可达模式(高度限制砍伐)之间切换。
- 点击支持的 10 种 原木 中的任意一种(橡树、云杉、白桦、丛林、金合欢、深色橡木、红树、樱桃、绯红、诡异),进入其选项页面。
- 在树木选项菜单下:
- 砍伐状态:启用或禁用该树种自动砍伐。
- 重新种植树苗:切换自动重新种植树苗功能。
- 路线目的地:切换将原木输送到 废弃箱、保留箱,还是保留在你的 物品栏 中。
- 设置将立即保存到
plugins/HereLoggy/player-configs/{playerId}.yml 中。
4. 启动机器人
- 站在所选边界区域附近。
- 运行
/hl start 开始自动砍伐!
- 插件将逐层沿生成的安全路径行走,清理植被,砍伐发现的树木,修复具有经验修补的工具,重新种植树苗,喂食,抵御敌对生物,并自动将满仓物品存入箱子。
- 如需停止,请运行
/hl stop。系统将显示详细的活动摘要,包括收集的原木数量、清理的植被、重新种植的树苗以及更换的斧头数量。
- 使用
/hl restart 从中断处继续运行。
支持的树木类型
HereLoggy 原生识别并支持以下树木:
- 主世界:橡树、云杉、白桦、丛林、金合欢、深色橡木、红树、樱桃
- 下界:绯红菌核、诡异菌核
从源代码构建
使用 Gradle 构建插件 JAR 文件:
./gradlew build
编译后的 JAR 文件将保存在 build/libs/ 目录中。
许可证
本项目遵循 GNU General Public License v3.0 许可协议。
HereLoggy
A premium Paper Minecraft plugin for fully automated lumberjacking and tree felling — systematically discover trees, execute recursive whole-tree clearing, dynamically manage inventory storage, swap and restock axes, auto-feed, defend against hostiles, replant saplings, and boost leveling with AuraSkills integration!
Features
-
Double-Axe Selection & Path Mapping:
- Selection is quick and simple: hold any Axe, Sneak + Right-Click to set Point A and Point B bounding coordinates.
- The plugin automatically triggers an asynchronous scan of the area to map walkable blocks and discover tree locations, avoiding server lag.
-
Dynamic Auto-Chopping Methods:
- Whole Tree Mode (BFS): Uses a smart recursive Breadth-First Search (BFS) with a radial adjacency of 2 to traverse and break the entire tree structure (up to a 512-block safety limit) from a single base chop.
- Reachable Mode: Only chops wood blocks within standard player reach height (up to eye-height + 3 blocks), respecting traditional survival mechanics.
-
Automatic Foliage & Obstacle Clearing:
- Periodically scans a local radius around the player to break leaves, vines, and nether foliage automatically.
- Keeps walking paths fully clear to prevent the player from getting stuck or trapped.
- Emergency Trapped & Suffocation Rescue: Actively monitors if the player is suffocating or trapped inside solid blocks (e.g., logs/leaves due to tree growth, or pushed underground). Instantly fells any logs and foliage in a 5x5x5 cubic area and teleports the player to the nearest safe path node or adjacent safe ground coordinate.
-
Smart Tool Preservation & Restocking:
- Monitors axe durability in real-time. Automatically swaps active quickslots to another axe in the inventory to prevent tool breakage.
- Tool Supply Restocking: Link a Tool Supply Chest with spare axes. If durability drops below a user-defined threshold and no spares exist on hand, the player teleports to the chest, deposits the worn axe, withdraws a fresh one, and teleports back to resume lumberjacking instantly!
-
Advanced Storage Routing & Keep/Trash Chests:
- Link a Keep Chest (for valuable logs) and a Trash Chest (for saplings, leaves, extra drops) using the setup wizard.
- When the player's inventory becomes full, the plugin automatically routes items to deposit chests. If chests are full or unconfigured, the session pauses safely rather than dropping items.
- Allows configuring routing destinations (Keep, Trash, or Keep on Person) per wood type.
-
Integrated Hostile Mob Defense & Auto-Feeding:
- Monitors surrounding entities and actively defends the player from hostile mobs, pausing wood-cutting for weapon cooldown ticks.
- Smart Whole-Inventory Feeding: Automatically consumes food from any inventory slot (not just the hotbar) when hunger drops below saturation limits.
- Smart Food Preservation: During automated inventory dumps to Keep/Trash chests, the bot automatically identifies and preserves the largest food stack (cooked or raw) in the inventory to ensure continuous operations.
-
Vacuum Drop Attraction & Shared Mending Repair:
- Automatically vacuum-attracts all dropped items and experience orbs within a 6-block radius around broken blocks.
- Directs collected block-break experience straight to repairing hotbar tools enchanted with Mending (prioritizing the most damaged axe), allocating leftover XP to the player.
-
Automatic Sapling Replanting:
- If enabled, automatically places matching saplings on soil, dirt, nylium, or soul blocks immediately after a tree is felled, as long as saplings are available in the player's inventory or off-hand.
-
AuraSkills Integration:
- Fully supports AuraSkills (formerly Aurelium Skills).
- Award-winning Foraging XP is granted for broken log blocks and attracted experience orbs.
- Player movement velocity multiplier scales dynamically based on their current Foraging Level (
1.0 + Foraging Level * 0.01).
-
HereRolePlay Integration:
- Automatically awards Collect experience points directly to the player for each log and wood block broken, helping level up Miner and Admin classes.
-
Interactive Configuration GUI:
- A beautiful, full-featured GUI to toggle active states, replanting preferences, and inventory routing destinations for 10 tree types: Oak, Spruce, Birch, Jungle, Acacia, Dark Oak, Mangrove, Cherry, Crimson, and Warped.
Commands
All commands can be run with /hl instead of /hereloggy.
| Command |
Description |
Permission |
/hereloggy start (or /hl start) |
Start auto-chopping (triggers area scan first if selection exists but has not been scanned) |
hereloggy.use |
/hereloggy stop (or /hl stop) |
Stop active chopping session and display statistics |
hereloggy.use |
/hereloggy restart (or /hl restart) |
Resume auto-chopping from the last paused block index |
hereloggy.use |
/hereloggy config (or /hl config) |
Open interactive GUI to configure individual tree settings |
hereloggy.config |
/hereloggy setup (or /hl setup) |
Start interactive chat setup wizard for chests and thresholds |
hereloggy.setup |
/hereloggy clear (or /hl clear) |
Clear point selections, scans, and player setups |
hereloggy.use |
Permissions
| Permission |
Description |
Default |
hereloggy.use |
Allows use of /hereloggy command |
true |
hereloggy.setup |
Allows use of the setup wizard |
true |
hereloggy.config |
Allows use of the tree configuration GUI |
true |
How to Use
1. Bounding Area Selection
- Hold any Axe in your main hand.
- Sneak + Right-Click a block to mark Point A.
- Sneak + Right-Click another block to mark Point B (defining the logging boundaries).
- The plugin will map out walkable paths and announce that it is ready.
2. Interactive Setup Wizard
- Run
/hl setup.
- Step 1: Hold an Axe and Sneak + Right-Click a chest where you want to deposit Trash (saplings, leaves, etc.).
- Step 2: Sneak + Right-Click a chest where you want to deposit Valuable Logs (Keep Chest).
- Step 3: Sneak + Right-Click a chest where you store Spare Axes (Tool Supply), or type
skip in chat.
- Step 4: Enter an axe durability threshold (e.g.
12) or type skip (defaults to 10).
- Setup is complete! Your configuration will be saved in
plugins/HereLoggy/setup-configs/{playerId}.yml.
3. Tree Configuration GUI
- Run
/hl config to open the main menu.
- Under the main menu:
- Click the Chopping Method icon at the bottom center to toggle between Whole Tree (BFS recursive felling) and Reachable (reach-height felling).
- Click on any of the 10 supported Logs (Oak, Spruce, Birch, Jungle, Acacia, Dark Oak, Mangrove, Cherry, Crimson, Warped) to access their options.
- Under the tree options menu:
- Chopping Status: Enable or disable felling for this tree type.
- Replant Saplings: Toggle automatic sapling replanting.
- Route Destination: Toggle between routing logs to the Trash Chest, Keep Chest, or keeping them in your Inventory.
- Settings are immediately saved to
plugins/HereLoggy/player-configs/{playerId}.yml.
4. Running the Bot
- Stand near the selected bounding area.
- Run
/hl start to begin auto-chopping!
- The plugin will walk the safe generated path layer-by-layer, clear foliage, fell discovered trees, repair mending tools, replant saplings, feed, defend against hostiles, and dump full inventories into chests automatically.
- If you need to stop, run
/hl stop. A detailed activity summary will show logs collected, foliage cleared, saplings replanted, and axes replaced.
- Use
/hl restart to resume from where you left off.
Supported Tree Types
HereLoggy natively recognizes and supports:
- Overworld: Oak, Spruce, Birch, Jungle, Acacia, Dark Oak, Mangrove, Cherry
- Nether: Crimson Stem, Warped Stem
Building from Source
Build the plugin jar using Gradle:
./gradlew build
The compiled JAR will be saved in the build/libs/ directory.
License
This project is licensed under the GNU General Public License v3.0.
评论 0
登录后参与评分
还没有评论,来抢沙发吧