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 !(https://i.imgur.com/fPxrnXO.png) Quarry setup !(https://i.imgur.com/iZpIx2p.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 /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 !(https://imgur.com/PpnhDDo.png) 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 effec