⚒️ QuarryPlugin — 自动化采矿,恰到好处
是否一直想在原版生存模式中获得类似 BuildCraft 的采石场?
自动化采矿,尊重保护机制,轻松管理你的资源。
一个智能且适合生存模式的采石场系统,允许玩家建造并控制自动运行的矿洞——具备存储检测、暂停/恢复控制以及基于权限的限制功能。
️ 截图
采石场竖井
采石场设置
✨ 主要特性
⛏️ 自动化采矿
- 自动在矩形区域内向下挖掘
- 从地表挖掘至基岩层(Y=-60)
- 收集所有方块并存入附近的箱子中
- 智能箱子检测(搜索半径5格,垂直高度2格)
- 尊重方块硬度以实现真实的挖掘速度
视觉效果
- 粒子模式:展示挖掘进度的精美粒子光束
- 栅栏模式:经典的 BuildCraft 风格栅栏柱
- 支持多种粒子类型(END_ROD, FLAME, LAVA, ELECTRIC_SPARK 等)
- 挖掘时的方块碎裂动画
- 挖掘点的岩浆粒子与烟雾效果
- 橙色混凝土脚手架标记采石场区域
所有权与保护
- 采石场绑定于玩家所有权
- 仅所有者(或 OP)可以破坏采石场
- 防止恶意破坏
- 所有者离线时采石场暂停
- 服务器重启后数据保留
统计追踪
- 每位玩家的总挖掘方块数
- 按矿石分类的详细统计(钻石、绿宝石、金、铁)
- 创建和完成的采石场数量
- 挖掘最多的方块类型
• 全服排行榜
性能优化
- TPS 保护 - 服务器卡顿时无自动减速
- 智能区块加载 - 跳过未加载的区块
- 箱子缓存 - 减少查找开销
- 批处理选项以实现更快的挖掘
- 完全可配置以满足你服务器的需求
高度可配置
- 可调整挖掘速度
- 自定义粒子效果
- 尺寸限制
- 硬度倍数
- 精准采集模式
- 以及更多!
如何建造采石场
放置4个红石火把形成矩形角落。
制作或获取你的采石场熔炉(具有 "Quarry Block" 的描述)。
将其放置在火把区域之外,但紧邻其中一个火把。
观察采石场自动挖掘。
在熔炉旁边放置箱子以收集资源。
右键点击熔炉可随时暂停或恢复。
当采石场触及基岩、填满所有箱子或玩家离线时,会自动暂停。
命令
/quarry
显示帮助菜单和你的采石场数量
quarry.user.number.#
/quarry stats
查看你的个人采矿统计信息
quarry.user.number.#
/quarry top
查看全服顶级矿工排行榜
default
/quarryadmin list
列出服务器上所有活跃的采石场
quarry.admin
/quarryadmin remove <uuid>
通过 UUID 移除特定的采石场
quarry.admin
/quarryadmin reload
重新加载所有采石场数据和配置
quarry.admin
⚙️ 配置
**基本设置**
tickspeed: 5 # 数值越低 = 越快(两次挖掘之间的刻数)
hardness: 1.0 # 挖掘速度倍数
silktouch: false # 对所有方块使用精准采集
consumefuel: false # 需要燃料(尚未实现)
**性能设置**
performance:
use-particles: true # 粒子模式 vs 栅栏模式
smart-chunk-loading: true # 跳过未加载的区块
cache-chests: true # 缓存箱子位置
chest-cache-time: 20 # 重新扫描的时间间隔(秒)
particle-view-distance: 100 # 渲染距离
max-quarry-size: 64 # 最大尺寸
batch-processing: false # 每次刻挖掘多个方块
batch-size: 3 # 每批处理的方块数
**视觉设置**
visuals:
particle-types:
- END_ROD
- LAVA
show-marker-particle: true # 挖掘点显示快乐粒子
beam-duration-ticks: 40 # 守卫者光束持续时间
# TPS 保护
tps-protection:
enabled: true # 卡顿时自动调整
threshold: 18.0 # TPS 阈值
slow-mode-multiplier: 4 # 减速幅度
默认合成配方
[W] [D] [W]
[D] [F] [D]
[W] [D] [W]
D = 钻石块
F = 熔炉
W = 橡木木板
结果:采石场熔炉
采石场行为
自动暂停条件:
- 附近的所有箱子已满
- 所有者离开服务器
- 到达基岩层或 Y ≤ -60
- 保护插件拒绝访问
挖掘模式:
- 从上到下逐层挖掘
- 高效跳过空气和液体
- 尊重方块硬度以实现真实的时间间隔
- 视觉指示器显示当前挖掘位置
存储系统:
- 向每个方向搜索最多10格范围内的箱子
- 自动将物品存入可用的箱子中
- 当所有存储空间满时暂停(清空箱子后可恢复)
视觉模式
粒子模式 (use-particles: true)
- 客户端假方块 - 零服务器延迟
- 从顶部到挖掘点的平滑粒子光束
- 多种粒子类型用于自定义效果
- 方块碎裂动画
- 岩浆和烟雾效果
栅栏模式 (use-particles: false)
- 经典的 BuildCraft 视觉风格
- 客户端假栅栏柱
- 橙色混凝土“钻头”
- 同样没有服务器延迟 - 全部在客户端处理!
支持的粒子类型:
END_ROD, FLAME, SOUL_FIRE_FLAME, LAVA, ELECTRIC_SPARK, REDSTONE, VILLAGER_HAPPY, GUARDIAN_BEAM (特殊), 以及更多!
统计信息与排行榜
通过详细的统计信息追踪你的采矿进度:
个人统计 (/quarry stats):
- 总挖掘方块数
- 创建及完成的采石场数量
- 发现的珍贵矿石
- 挖掘最多的方块类型
- 详细的矿石分解
排行榜 (/quarry top):
- 按总挖掘方块数排名的前10名矿工
- 与其他玩家竞争
- 前3名拥有奖牌系统
权限
- quarry.user.number.1 - 允许1个采石场
- quarry.user.number.3 - 允许3个采石场
- quarry.user.number.10 - 允许10个采石场
- quarry.admin - 管理员命令 (/quarryadmin)
注意:OP 拥有无限数量的采石场,并且可以破坏任何采石场
高级特性
TPS 保护
当服务器 TPS 低于阈值时自动降低采石场速度
- 防止高负载时的卡顿
- 可配置的阈值和减速倍率
- TPS 改善后自动恢复
智能区块加载
在未加载的区块中跳过挖掘以防止强制加载
- 对大型采石场(64x64+)尤为重要
- 减少区块加载/卸载循环
- 在区块自然加载时恢复工作
箱子缓存
记住箱子位置以减少查找次数
- 仅在当前箱子已满时重新扫描
- 可配置的缓存持续时间
- 支持半径 5 格、垂直高度 2 格的箱子检测
批量处理
每刻开采多个方块以提高效率
- 默认禁用以确保安全
- 仅在 TPS > 19 时激活
- 可配置的批次大小
技术细节
要求:
- Minecraft 1.20+ (Paper/Spigot/Purpur)
- Java 21+
性能:
- 使用客户端视觉效果(无方块更新)
- 高效的箱子检测算法
- 智能位置推进
- 极低的内存占用
- 异步安全的统计跟踪
数据存储:
- quarries.yml - 活动采石场数据
- quarry-stats.yml - 玩家统计数据
- 每 5 分钟自动保存
- 关闭服务器时保存
兼容性:
- 与保护插件兼容(WorldGuard, GriefPrevention 等)
- 触发 BlockBreakEvent 以兼容其他插件
- 尊重被取消的破坏事件
安装
- 下载最新的 QuarryPlugin.jar
- 放入服务器的 plugins 文件夹
- 重启服务器
- 根据需要配置 config.yml
- 为玩家设置权限
- 享受自动化采矿!
示例统计输出
采石场统计
⛏️ 总开采方块数:15.3K
? 创建的采石场:3
✅ 已完成的采石场:1
? 珍贵矿石:47
最多开采:石头 (12.1K)
矿石明细:
钻石:12
绿宝石:5
金:18
铁:234
===============================
支持与更新
发现 bug?请在 Discord 中报告!
有建议?欢迎反馈!
需要帮助?在此提问!
⭐ 如果你喜欢这个插件,请留下评论! ⭐
版本 3.0.3 | 最后更新:2025 年 12 月
需要帮助?
文档:即将推出
支持 Discord:
源代码:目前私有
⚒️ QuarryPlugin — 自动化挖掘!
⚒️ QuarryPlugin — Automated Mining, Done Right
Always wanted a BuildCraft-style quarry in vanilla survival?
Automate mining, respect protections, and manage your resources effortlessly.
A smart, survival-friendly quarry system that lets players build and control self-running mines — complete with storage detection, pause/resume controls, and permission-based limits.
️ Screenshots
Quarry shaft
Quarry setup
✨ Key Features
⛏️ Automated Mining
- Automatically digs down in a rectangular area
- Mines from surface to bedrock (Y=-60)
- Collects all blocks and stores in nearby chests
- Smart chest detection (searches 5 blocks radius, 2 blocks vertical)
- Respects block hardness for realistic mining speed
Visual Effects
- Particle Mode: Beautiful particle beams showing mining progress
- Fence Mode: Classic BuildCraft-style fence posts
- Multiple particle types supported (END_ROD, FLAME, LAVA, ELECTRIC_SPARK, etc.)
- Block crack animations while mining
- Lava particles and smoke effects at dig site
- Orange concrete scaffolding roof marks quarry area
Ownership & Protection
- Quarries are tied to player ownership
- Only owners (or OPs) can break quarries
- Protected from griefing
- Quarries pause when owner logs off
- Survives server restarts
Statistics Tracking
- Total blocks mined per player
- Ore-specific breakdowns (diamonds, emeralds, gold, iron)
- Quarries created and completed
- Most mined block type
• Server-wide leaderboards
Performance Optimized
- TPS protection - automatically slows during server lag
- Smart chunk loading - skips unloaded chunks
- Chest caching - reduces lookup overhead
- Batch processing option for faster mining
- Configurable everything for your server's needs
Highly Configurable
- Adjustable mining speed
- Custom particle effects
- Size limits
- Hardness multipliers
- Silk touch mode
- And much more!
How to Build a Quarry
Place 4 redstone torches forming a rectangular corner.
Craft or obtain your Quarry Furnace (has "Quarry Block" lore).
Place it outside the torch area but next to one torch.
Watch the quarry dig automatically.
Place chests adjacent to the furnace to collect resources.
Right-click the furnace to pause or resume at any time.
Quarries pause automatically when they hit bedrock, fill all chests, or when the player is offline.
Commands
/quarry
Show help menu and your quarry count
quarry.user.number.#
/quarry stats
View your personal mining statistics
quarry.user.number.#
/quarry top
View server-wide leaderboard of top miners
default
/quarryadmin list
List all active quarries on the server
quarry.admin
/quarryadmin remove <uuid>
Remove a specific quarry by its UUID
quarry.admin
/quarryadmin reload
Reload all quarry data and configuration
quarry.admin
⚙️ Configuration
**Basic Settings**
tickspeed: 5 # Lower = faster (ticks between mining)
hardness: 1.0 # Mining speed multiplier
silktouch: false # Use silk touch on all blocks
consumefuel: false # Require fuel (not yet implemented)
**Performance Settings**
performance:
use-particles: true # Particle mode vs fence mode
smart-chunk-loading: true # Skip unloaded chunks
cache-chests: true # Cache chest locations
chest-cache-time: 20 # Seconds between rescans
particle-view-distance: 100 # Render distance
max-quarry-size: 64 # Maximum dimensions
batch-processing: false # Mine multiple blocks per tick
batch-size: 3 # Blocks per batch
**Visual Settings**
visuals:
particle-types:
- END_ROD
- LAVA
show-marker-particle: true # Happy particles at dig
beam-duration-ticks: 40 # Guardian beam duration
# TPS Protection
tps-protection:
enabled: true # Auto-adjust on lag
threshold: 18.0 # TPS threshold
slow-mode-multiplier: 4 # Slowdown amount
Default Recipe
[W] [D] [W]
[D] [F] [D]
[W] [D] [W]
D = Diamond Block
F = Furnace
W = Oak Planks
Result: Quarry Furnace
Quarry Behavior
Auto-Pause Conditions:
- All nearby chests are full
- Owner logs off the server
- Reaches bedrock or Y ≤ -60
- Protection plugin denies access Mining Pattern:
- Mines layer by layer from top to bottom
- Skips air and liquids efficiently
- Respects block hardness for realistic timing
- Visual indicator shows current mining position
Storage System:
- Searches up to 10 blocks in each direction for chests
- Automatically deposits items into available chests
- Pauses when all storage is full (resume by emptying chests)
Visual Modes
Particle Mode (use-particles: true)
- Client-side fake blocks - zero server lag
- Smooth particle beams from roof to dig site
- Multiple particle types for custom effects
- Block crack animations
- Lava and smoke effects
Fence Mode (use-particles: false)
- Classic BuildCraft visual style
- Fake client-side fence posts
- Orange concrete "drill bit"
- Still no server lag - all client-side!
Supported Particle Types:
END_ROD, FLAME, SOUL_FIRE_FLAME, LAVA, ELECTRIC_SPARK, REDSTONE, VILLAGER_HAPPY, GUARDIAN_BEAM (special), and more!
Statistics & Leaderboards
Track your mining progress with detailed statistics:
Personal Stats (/quarry stats):
- Total blocks mined
- Quarries created & completed
- Valuable ores found
- Most mined block type
- Detailed ore breakdown
Leaderboards (/quarry top):
- Top 10 miners by total blocks
- Compete with other players
- Medal system for top 3
Permissions
- quarry.user.number.1 - Allow 1 quarry
- quarry.user.number.3 - Allow 3 quarries
- quarry.user.number.10 - Allow 10 quarries
- quarry.admin - Admin commands (/quarryadmin)
Note: OPs have unlimited quarries and can break any quarry
Advanced Features
TPS Protection
Automatically slows quarries when server TPS drops below threshold
- Prevents lag during high server load
- Configurable threshold and slowdown multiplier
- Automatic recovery when TPS improves
Smart Chunk Loading
Skips mining in unloaded chunks to prevent force-loading
- Important for large quarries (64x64+)
- Reduces chunk load/unload cycles
- Resumes when chunks load naturally
Chest Caching
Remembers chest locations to reduce lookups
- Only rescans when current chest is full
- Configurable cache duration
- Supports chest detection 5 blocks radius, 2 vertical
Batch Processing
Mine multiple blocks per tick for faster operation
- Disabled by default for safety
- Only activates when TPS > 19
- Configurable batch size
Technical Details
Requirements:
- Minecraft 1.20+ (Paper/Spigot/Purpur)
- Java 21+
Performance:
- Uses client-side visual effects (no block updates)
- Efficient chest detection algorithm
- Smart position advancement
- Minimal memory footprint
- Async-safe statistics tracking
Data Storage:
- quarries.yml - Active quarry data
- quarry-stats.yml - Player statistics
- Auto-saves every 5 minutes
- Saves on shutdown
Compatibility:
- Works with protection plugins (WorldGuard, GriefPrevention, etc.)
- Fires BlockBreakEvent for plugin compatibility
- Respects cancelled break events
Installation
- Download the latest QuarryPlugin.jar
- Place in your server's plugins folder
- Restart your server
- Configure config.yml to your preference
- Set up permissions for your players
- Enjoy automated mining!
Example Statistics Output
Quarry Statistics
⛏️ Total Blocks Mined: 15.3K
️ Quarries Created: 3
✅ Quarries Completed: 1
Valuable Ores: 47
Most Mined: Stone (12.1K)
Ore Breakdown:
Diamonds: 12
Emeralds: 5
Gold: 18
Iron: 234
===============================
Support & Updates
Found a bug? Report it in discord!
Have a suggestion? I'd love to hear it!
Need help? Ask questions here!
⭐ If you enjoy this plugin, please leave a review! ⭐
Version 3.0.3 | Last Updated: December 2025
Need Help?
Documentation: Coming soon
Support Discord:
Source Code: Currently Private
⚒️ QuarryPlugin — Automate the digging!
评论 0
登录后参与评分
还没有评论,来抢沙发吧