HereBlingy
一款面向 Paper 的高品质 Minecraft 插件,用于实现自动化分支挖矿——系统性地剥离采矿、挖掘矿石、动态切换工具(镐/铲)、封堵流体泄漏、通过共享经验值修复“经验修补”工具,并将掉落物分类存入宝藏箱和废料箱!
功能特性
-
双模式自动化:
- 剥离采矿(无限分支挖矿):
- 完全无需选择区域、无限延伸的分支挖矿自动化。
- 进度会沿着玩家面朝的方向(北、南、东或西),在当前 Y 层向前挖掘一条中央 2x2 主隧道,直到手动停止为止。
- 每隔 3 个方块生成 2x1 垂直侧支(间隔为 3 个实心方块),向左右两侧延伸至可配置的宽度(默认值:16 方块,例如
/hb start [width])。
- 地形改造(受限土地平整):
- 由 A 点和 B 点选择引导的受限 3D 清地模式。
- 自上而下安全地逐层挖掘整个长方体区域(以 2 方块高的水平切片进行)。
- 忽略树木与树叶:自动完全绕过原木、木头、树叶、茎干或根块(即“hubris”),从而保留自然森林完整,同时将标准的石头、泥土、沙子、泥巴和砾石方块整平至地面高度。
-
动态双工具切换:
- 将方块分类为适合镐子挖掘(石头、深板岩、矿石、下界岩、凝灰岩、方解石、流纹岩、安山岩、花岗岩、黑曜石)和适合铲子挖掘(泥土、沙子、砾石、黏土、灵魂沙、雪、泥巴)。
- 在挥动工具前,自动切换到快捷栏中对应的合适工具。
-
VeinMiner 集成与掉落吸引:
- 自动扫描被破坏矿石周围 6 格半径范围内的所有掉落物并吸入(完美支持 VeinMiner 连锁破坏效果)。
- 掉落物会被立即收集并路由至 Keep(宝藏)或 Trash(废料)箱子。
-
主动流体泄漏封堵:
- 扫描相邻方块中可能导致玩家淹没的流体源方块(水/熔岩)。
- 在源位置放置一个封堵方块,使用玩家当前库存中数量最多的允许材料(
COBBLESTONE、COBBLED_DEEPSLATE、TUFF、NETHERRACK)。
-
蛛网规避与导航:
- 在进入路径前自动检测
Material.COBWEB 坐标。
- 即时绕过并跳过这些坐标,防止玩家被困或减速,使其能够无缝穿越蛛网区域而不浪费工具耐久度。
-
共享经验修补 (Mending) 修复:
- 拦截 6 格半径内的方块破坏经验球。
- 如果快捷栏中的两个工具(镐/铲)任一或两者都附魔了经验修补 (Mending),则直接使用经验值修复其耐久度,优先修复损坏更严重的工具。多余的经验值交给玩家。
-
HereRolePlay 集成:
- 为每挖掘一个方块和矿石直接向玩家发放采集经验值,帮助提升矿工和管理员职业等级。
-
智能工具补给加油站:
- 通过设置向导指导玩家配置工具补给箱。
- 当任一工具的耐久度低于 10 时,玩家会自动前往箱子,存入磨损的工具,取出一把新的镐/铲,并返回继续挖矿!
-
可配置的宝藏与废料投放:
- 宝藏 (Treasures):红石、青金石、铜(原矿/锭)、铁(原矿/锭)、金(原矿/锭)、钻石、绿宝石、石英、煤炭、远古残骸、燧石。
- 废料 (Debris):沙子、砾石、泥土、圆石、石头、深板岩、下界岩、凝灰岩、流纹岩、安山岩、方解石、黏土、泥巴。
- 当背包满时,自动将物品倒入指定的投放箱。
命令
所有命令均可使用 /hb 代替 /hereblingy。
| 命令 |
描述 |
权限节点 |
/hereblingy start [width] (或 /hb start [width]) |
开始自动挖矿(剥离采矿模式启动无区域选择的无限隧道及侧支宽度;地形改造模式整平选定的 3D 边界) |
hereblingy.use |
/hereblingy stop (或 /hb stop) |
停止正在进行的挖矿运行并显示统计信息 |
hereblingy.use |
/hereblingy restart (或 /hb restart) |
在因箱子/工具暂停后恢复挖矿 |
hereblingy.use |
/hereblingy config (或 /hb config) |
打开交互式箱子挖矿配置 GUI |
hereblingy.config |
/hereblingy setup (或 /hb setup) |
运行箱子投放及工具补给设置向导 |
hereblingy.setup |
/hereblingy clear (或 /hb clear) |
清除坐标选择器 |
hereblingy.use |
权限节点
| 权限节点 |
描述 |
默认值 |
hereblingy.use |
允许使用 /hereblingy 命令 |
true |
hereblingy.setup |
允许使用设置向导 |
true |
hereblingy.config |
允许使用挖矿配置 GUI |
true |
使用方法
切换作业模式
- 输入
/hb config 并点击底部中心(第 22 槽位)的 Active Job 图标以切换以下模式:
- 剥离采矿 (Strip Mining):无限 2x2 分支挖矿,沿前方直线进行。
- 地形改造 (Terraforming):整平选定的 3D 长方体区域的地面(忽略树木)。
1. 剥离采矿设置(无限模式)
- 确保在
/hb config 中将活跃作业设置为 剥离采矿 (Strip Mining)。
- 站在你想挖矿方向(北、南、东或西)的实心墙壁前。
- 确保你的快捷栏中有镐子和铲子。
- 运行
/hb start [width](例如 /hb start 16 以挖掘向左右各延伸 16 方块的侧支)。
- 插件将向前无限挖掘一条中央 2x2 主隧道,每隔 3 个方块生成 2x1 分支,并在过程中自动切换工具和封堵流体泄漏。
2. 地形改造设置(有界区域)
- 确保在
/hb config 中将你的活跃作业设置为 Terraforming(地形改造)。
- 在主手中拿着一把镐子。
- 按住 Shift 并右键点击一个方块以设置 A点。
- 按住 Shift 并右键点击另一个方块以设置 B点(这将形成要平整的土地/山丘的边界)。
- 站在该区域附近并运行
/hb start。
- 插件将从上到下逐层切割所选的长方体区域,清除石头、土壤和泥土,并忽略所有树干和树叶(即“傲慢”部分)。
高级宝箱存放与工具补给设置
- 运行
/hb setup 启动向导。
- 按住 Shift 并右键点击你想要存放 碎屑(石头、沙子、砾石)的箱子。
- 按住 Shift 并右键点击你想要存放 宝藏(矿石、生锭、钻石)的箱子。
- 按住 Shift 并右键点击存放 备用工具(镐子/铲子)的箱子,或在聊天栏中输入
skip。
- 在聊天栏中输入耐久度阈值(例如
12),或输入 skip(默认为 10)。
- 设置完成!你的配置已保存在
setup-configs/{playerId}.yml 中。
采矿配置 GUI
- 运行
/hb config 打开主类别选择器。
- 点击 Treasures(宝藏)、Standard Blocks(标准方块)或 Debris & Soils(碎屑与土壤)以查看物品库存。
- 悬停在任意方块上可查看其状态:
- 左键点击 切换破坏状态(
Enabled / Disabled)。
- 右键点击 循环切换其去向(
Treasures (Keep Chest) ➔ Debris (Trash Chest) ➔ Inventory (Keep on Person))。
- 配置存储在
player-configs/{playerId}.yml 中。
从源代码构建
使用 Gradle 进行构建:
./gradlew build
打包后的 JAR 文件将位于 build/libs/HereBlingy-1.2.2.jar。
许可证
本项目遵循 GNU General Public License v3.0 许可协议。
HereBlingy
A premium Paper Minecraft plugin for automated branch mining — systematically strip-mine, excavate ores, dynamically swap tools (pickaxes/shovels), plug fluid leaks, repair Mending tools via shared XP, and sort item drops into Treasures and Debris chests!
Features
-
Dual Automation Modes:
- Strip Mining (Infinite branch mining):
- A completely selection-free, infinite branch-mining automation.
- progression digs a central 2x2 main tunnel straight ahead in the direction the player is facing (North, South, East, or West) at their current Y level forever until manually stopped.
- Off-shoots 2x1 perpendicular side branches every 3 blocks (spacing of 3 solid blocks) extending left and right to a configurable width (default: 16 blocks, e.g.,
/hb start [width]).
- Terraforming (Bounded land leveling):
- Bounded 3D land-clearing mode guided by Point A & Point B selections.
- Excavates the entire cuboid layer-by-layer (2-block-high horizontal slices) safely from the top down.
- Ignores Trees & Leaves: Automatically bypasses log, wood, leaves, stems, or root blocks ("hubris") entirely so that natural forests are left intact while standard stone, dirt, sand, mud, and gravel blocks are leveled to the ground.
-
Dynamic Dual-Tool Swapping:
- Classifies blocks into Pickaxe-Worthy (stone, deepslate, ores, netherrack, tuff, calcite, diorite, andesite, granite, obsidian) and Shovel-Worthy (dirt, sand, gravel, clay, soul soil, snow, mud).
- Automatically swaps active hotbar quickslots to the appropriate tool before swing execution.
-
VeinMiner Integration & Drop Attraction:
- Automatically scans a 6-block radius around broken ores to vacuum all dropped items (perfectly supporting VeinMiner chain breaks).
- Drops are instantly collected and routed to Keep (Treasures) or Trash (Debris) chests.
-
Active Fluid Leak Plugging:
- Scans adjacent blocks for fluid source blocks (Water/Lava) that could flood the player.
- Places a plug block at the source location using whichever allowed material (
COBBLESTONE, COBBLED_DEEPSLATE, TUFF, NETHERRACK) the player currently has the largest quantity of in their inventory.
-
Cobweb Avoidance & Navigation:
- Automatically detects
Material.COBWEB coordinates along the path before entering them.
- Instantly bypasses and skips these coordinates to prevent the player from getting trapped or slowed down, allowing seamless movement around cobweb zones without wasting tool durability.
-
Shared Mending XP Repair:
- Intercepts block-breaking experience orbs in a 6-block radius.
- If either or both of the hotbar tools (Pickaxe/Shovel) have the Mending enchantment, directly uses the XP to repair their durability, prioritizing the more damaged tool first. Excess XP is given to the player.
-
HereRolePlay Integration:
- Automatically awards Collect experience points directly to the player for each block and ore mined, helping level up Miner and Admin classes.
-
Smart Tool Supply Refueling Station:
- Guides player via setup wizard to configure a Tool Supply Chest.
- When either tool drops below 10 durability, the player will head to the chest, deposit the worn tool, withdraw a fresh pickaxe/shovel, and return to mining automatically!
-
Configurable Treasures vs. Debris deposit:
- Treasures: Redstone, Lapis, Copper (raw/ingot), Iron (raw/ingot), Gold (raw/ingot), Diamonds, Emeralds, Quartz, Coal, Ancient Debris, Flint.
- Debris: Sand, gravel, dirt, cobblestone, stone, deepslate, netherrack, tuff, diorite, granite, andesite, calcite, clay, mud.
- Automatically dumps inventory items into assigned deposit chests when full.
Commands
All commands can be run with /hb instead of /hereblingy.
| Command |
Description |
Permission |
/hereblingy start [width] (or /hb start [width]) |
Start auto-mining (Strip Mining mode starts selection-free infinite tunnel with side branch width; Terraforming mode levels selected 3D bounds) |
hereblingy.use |
/hereblingy stop (or /hb stop) |
Stop active mining run and display stats |
hereblingy.use |
/hereblingy restart (or /hb restart) |
Resume mining after chest/tool paused stops |
hereblingy.use |
/hereblingy config (or /hb config) |
Open interactive chest mining configuration GUI |
hereblingy.config |
/hereblingy setup (or /hb setup) |
Run chest deposit & tool supply setup wizard |
hereblingy.setup |
/hereblingy clear (or /hb clear) |
Clear coordinate selectors |
hereblingy.use |
Permissions
| Permission |
Description |
Default |
hereblingy.use |
Allows use of /hereblingy commands |
true |
hereblingy.setup |
Allows use of the setup wizard |
true |
hereblingy.config |
Allows use of the mining config GUI |
true |
How to Use
Toggling Job Modes
- Type
/hb config and click the Active Job icon at the bottom center (slot 22) to toggle between:
- Strip Mining: Infinite 2x2 branch-mining straight ahead.
- Terraforming: Ground-clearing of a selected 3D cuboid area (ignoring trees).
1. Strip Mining Setup (Infinite)
- Ensure your active job is set to Strip Mining in
/hb config.
- Stand facing a solid wall in the direction you want to mine (North, South, East, or West).
- Ensure you have a Pickaxe and Shovel in your hotbar quickslots.
- Run
/hb start [width] (e.g., /hb start 16 to dig branches extending 16 blocks left and right).
- The plugin will mine a central 2x2 main tunnel straight ahead infinitely, off-shooting 2x1 branches every 3 blocks, swapping tools and plugging fluid leaks as it goes.
2. Terraforming Setup (Bounded)
- Ensure your active job is set to Terraforming in
/hb config.
- Hold a Pickaxe in your main hand.
- Shift-right-click a block to set Point A.
- Shift-right-click another block to set Point B (forms the boundaries of the land/hill to level).
- Stand near the area and run
/hb start.
- The plugin will slice the selected cuboid layer-by-layer from the top down, clearing stone/soils/dirt and ignoring all tree trunks and leaves ("hubris").
Advanced Chest Deposit & Tool Supply Setup
- Run
/hb setup to start the wizard.
- Shift-right-click a chest where you want to deposit Debris (stone, sand, gravel).
- Shift-right-click a chest where you want to deposit Treasures (ores, raw ingots, diamonds).
- Shift-right-click a chest where you store Spare Tools (pickaxes/shovels), or type
skip in chat.
- Type a durability threshold in chat (e.g.
12) or type skip (defaults to 10).
- Setup is complete! Your configurations are saved in
setup-configs/{playerId}.yml.
Mining Configuration GUI
- Run
/hb config to open the main category selector.
- Click Treasures, Standard Blocks, or Debris & Soils to view the item inventory.
- Hover over any block to see its status:
- Left-Click to toggle breaking (
Enabled / Disabled).
- Right-Click to cycle its destination (
Treasures (Keep Chest) ➔ Debris (Trash Chest) ➔ Inventory (Keep on Person)).
- Configs are stored in
player-configs/{playerId}.yml.
Building from Source
Build using Gradle:
./gradlew build
The packaged JAR will be located at build/libs/HereBlingy-1.2.2.jar.
License
This project is licensed under the GNU General Public License v3.0.
评论 0
登录后参与评分
还没有评论,来抢沙发吧