# **⚒️ 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** **Default recipe** ![https://imgur.com/PpnhDDo.png](https://imgur.com/PpnhDDo.png) **Quarry shaft** ![https://imgur.com/zFGZn03](https://imgur.com/zFGZn03) ![https://i.imgur.com/fPxrnXO.png](https://i.imgur.com/fPxrnXO.png) **Quarry setup** ![https://i.imgur.com/iZpIx2p.png](https://i.imgur.com/iZpIx2p.png) **Quarry GUI** ![https://i.imgur.com/g61toOW.png](https://i.imgur.com/g61toOW.png) **Skill Tree** **![https://i.imgur.com/EN2If3b.png](https://i.imgur.com/EN2If3b.png)** ## **✨ 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** [TABLE="class: grid, width: 100%, align: center"] [TR] [TD]**Command**[/TD] [TD]**Description**[/TD] [TD]**Permission**[/TD] [/TR] [TR] [TD]/quarry[/TD] [TD]Show help menu and your quarry count[/TD] [TD]quarry.user.number.#[/TD] [/TR] [TR] [TD]/quarry stats[/TD] [TD]View your personal mining statistics[/TD] [TD]quarry.user.number.#[/TD] [/TR] [TR] [TD]/quarry top[/TD] [TD]View server-wide leaderboard of top miners[/TD] [TD]quarry.user.number.#[/TD] [/TR] [TR] [TD]/qconfig[/TD] [TD]Reload plugin configuration without restart[/TD] [TD]quarry.admin[/TD] [/TR] [TR] [TD]/quarryadmin list[/TD] [TD]List all active quarries on the server[/TD] [TD]quarry.admin[/TD] [/TR] [TR] [TD]/quarryadmin remove [/TD] [TD]Remove a specific quarry by its UUID[/TD] [TD]quarry.admin[/TD] [/TR] [TR] [TD]/quarryadmin reload[/TD] [TD]Reload all quarry data and configuration[/TD] [TD]quarry.admin[/TD] [/TR] [/TABLE] ## **⚙️ Configuration**

config.yml

``` # 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 17+ **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** **1.** Download the latest QuarryPlugin.jar **2.** Place in your server's plugins folder **3.** Restart your server **4.** Configure config.yml to your preference **5.** Set up permissions for your players **6.** Enjoy automated mining! ### **Example Statistics Output** ``` =============================== Your 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 =============================== ``` ### **Planned Features** • More skills to the skill tree • Translations (messages.yml) • Sound effects • And more based on your feedback! ### **Support & Updates** **Found a bug?** Report it in this thread! **Have a suggestion?** I'd love to hear it! **Need help?** Ask questions here! **⭐ If you enjoy this plugin, please leave a review! ⭐** ##### *Version 2.0.3 | Last Updated: November 2024* ## **Need Help?** **Documentation:** Coming soon **Support Discord:** [Join Here](https://discord.gg/fn2qytydjb) **Source Code:** Currently Private ### *⚒️ QuarryPlugin — Automate the digging!*

Published on	December 16, 2025
Downloads	45

Quarry

Release 3.0.3

selfservice0 released Quarry version 3.0.3 on December 16, 2025

Information

Platforms

Release
3.0.3