### \u2692\ufe0f QuarryPlugin \u2014 Automated Mining, Done Right
\nAlways wanted a BuildCraft-style quarry in vanilla survival?<\/p>\n
> Automate mining, respect protections, and manage your resources effortlessly.
\n>
\n> A smart, survival-friendly quarry system that lets players build and control self-running mines \u2014 complete with storage detection, pause\/resume controls, and permission-based limits.<\/p>\n
\ufe0f Screenshots<\/p>\n
Quarry shaft
\n<\/p>\n
Quarry setup
\n<\/p>\n
### \u2728 Key Features<\/p>\n
**\u26cf\ufe0f Automated Mining**
\n– Automatically digs down in a rectangular area
\n– Mines from surface to bedrock (Y=-60)
\n– Collects all blocks and stores in nearby chests
\n– Smart chest detection (searches 5 blocks radius, 2 blocks vertical)
\n– Respects block hardness for realistic mining speed<\/p>\n
**Visual Effects**
\n– Particle Mode: Beautiful particle beams showing mining progress
\n– Fence Mode: Classic BuildCraft-style fence posts
\n– Multiple particle types supported (END_ROD, FLAME, LAVA, ELECTRIC_SPARK, etc.)
\n– Block crack animations while mining
\n– Lava particles and smoke effects at dig site
\n– Orange concrete scaffolding roof marks quarry area<\/p>\n
**Ownership & Protection**
\n– Quarries are tied to player ownership
\n– Only owners (or OPs) can break quarries
\n– Protected from griefing
\n– Quarries pause when owner logs off
\n– Survives server restarts<\/p>\n
**Statistics Tracking**
\n– Total blocks mined per player
\n– Ore-specific breakdowns (diamonds, emeralds, gold, iron)
\n– Quarries created and completed
\n– Most mined block type
\n\u2022 Server-wide leaderboards<\/p>\n
**Performance Optimized**
\n– TPS protection – automatically slows during server lag
\n– Smart chunk loading – skips unloaded chunks
\n– Chest caching – reduces lookup overhead
\n– Batch processing option for faster mining
\n– Configurable everything for your server’s needs<\/p>\n
**Highly Configurable**
\n– Adjustable mining speed
\n– Custom particle effects
\n– Size limits
\n– Hardness multipliers
\n– Silk touch mode
\n– And much more!<\/p>\n
# How to Build a Quarry<\/p>\n
Place 4 redstone torches forming a rectangular corner.
\n Craft or obtain your Quarry Furnace (has “Quarry Block” lore).
\n Place it outside the torch area but next to one torch.
\n Watch the quarry dig automatically.
\n Place chests adjacent to the furnace to collect resources.
\n Right-click the furnace to pause or resume at any time.<\/p>\n
> Quarries pause automatically when they hit bedrock, fill all chests, or when the player is offline.<\/p>\n
## Commands<\/p>\n
\/quarry
\nShow help menu and your quarry count
\nquarry.user.number.#<\/p>\n
\/quarry stats
\nView your personal mining statistics
\nquarry.user.number.#<\/p>\n
\/quarry top
\nView server-wide leaderboard of top miners
\ndefault<\/p>\n
\/quarryadmin list
\nList all active quarries on the server
\nquarry.admin<\/p>\n
\/quarryadmin remove \/quarryadmin reload # \u2699\ufe0f Configuration<\/p>\n “`<\/p>\n **Basic Settings** **Performance Settings** **Visual Settings** # TPS Protection “`<\/p>\n # Default Recipe [W] [D] [W]<\/p>\n [D] [F] [D]<\/p>\n [W] [D] [W]<\/p>\n D = Diamond Block Quarry Behavior Storage System: Visual Modes<\/p>\n Particle Mode (use-particles: true) Fence Mode (use-particles: false) Supported Particle Types: ## Statistics & Leaderboards<\/p>\n Track your mining progress with detailed statistics:<\/p>\n Personal Stats (\/quarry stats): Leaderboards (\/quarry top): ## Permissions Note: OPs have unlimited quarries and can break any quarry<\/p>\n ## Advanced Features<\/p>\n TPS Protection Smart Chunk Loading Chest Caching Batch Processing ## Technical Details<\/p>\n Requirements: Performance: Data Storage: Compatibility: ## Installation<\/p>\n 1. Download the latest QuarryPlugin.jar Example Statistics Output<\/p>\n **Quarry Statistics**<\/p>\n \u26cf\ufe0f Total Blocks Mined: 15.3K<\/p>\n \ufe0f Quarries Created: 3<\/p>\n \u2705 Quarries Completed: 1<\/p>\n Valuable Ores: 47<\/p>\n Most Mined: Stone (12.1K)<\/p>\n Ore Breakdown: Emeralds: 5<\/p>\n Gold: 18<\/p>\n Iron: 234<\/p>\n ===============================<\/p>\n ## Support & Updates<\/p>\n Found a bug? Report it in discord! \u2b50 If you enjoy this plugin, please leave a review! \u2b50<\/p>\n Version 3.0.3 | Last Updated: December 2025<\/p>\n Need Help?<\/p>\n Documentation: Coming soon<\/p>\n Support Discord: https:\/\/discord.gg\/G3Z92THjPh<\/p>\n Source Code: Currently Private<\/p>\n \u2692\ufe0f QuarryPlugin \u2014 Automate the digging!<\/p>\n","protected":false},"excerpt":{"rendered":" \u2692\ufe0f QuarryPlugin
\nRemove a specific quarry by its UUID
\nquarry.admin<\/p>\n
\nReload all quarry data and configuration
\nquarry.admin<\/p>\n
\ntickspeed: 5 # Lower = faster (ticks between mining)
\nhardness: 1.0 # Mining speed multiplier
\nsilktouch: false # Use silk touch on all blocks
\nconsumefuel: false # Require fuel (not yet implemented)<\/p>\n
\nperformance:
\n use-particles: true # Particle mode vs fence mode
\n smart-chunk-loading: true # Skip unloaded chunks
\n cache-chests: true # Cache chest locations
\n chest-cache-time: 20 # Seconds between rescans
\n particle-view-distance: 100 # Render distance
\n max-quarry-size: 64 # Maximum dimensions
\n batch-processing: false # Mine multiple blocks per tick
\n batch-size: 3 # Blocks per batch<\/p>\n
\nvisuals:
\n particle-types:
\n – END_ROD
\n – LAVA
\n show-marker-particle: true # Happy particles at dig
\n beam-duration-ticks: 40 # Guardian beam duration<\/p>\n
\ntps-protection:
\n enabled: true # Auto-adjust on lag
\n threshold: 18.0 # TPS threshold
\n slow-mode-multiplier: 4 # Slowdown amount<\/p>\n
\n<\/p>\n
\nF = Furnace
\nW = Oak Planks
\nResult: Quarry Furnace <\/p>\n
\nAuto-Pause Conditions:
\n– All nearby chests are full
\n– Owner logs off the server
\n– Reaches bedrock or Y \u2264 -60
\n– Protection plugin denies access Mining Pattern:
\n– Mines layer by layer from top to bottom
\n– Skips air and liquids efficiently
\n– Respects block hardness for realistic timing
\n– Visual indicator shows current mining position<\/p>\n
\n– Searches up to 10 blocks in each direction for chests
\n– Automatically deposits items into available chests
\n– Pauses when all storage is full (resume by emptying chests)<\/p>\n
\n– Client-side fake blocks – zero server lag
\n– Smooth particle beams from roof to dig site
\n– Multiple particle types for custom effects
\n– Block crack animations
\n– Lava and smoke effects<\/p>\n
\n– Classic BuildCraft visual style
\n– Fake client-side fence posts
\n– Orange concrete “drill bit”
\n– Still no server lag – all client-side!<\/p>\n
\nEND_ROD, FLAME, SOUL_FIRE_FLAME, LAVA, ELECTRIC_SPARK, REDSTONE, VILLAGER_HAPPY, GUARDIAN_BEAM (special), and more!<\/p>\n
\n– Total blocks mined
\n– Quarries created & completed
\n– Valuable ores found
\n– Most mined block type
\n– Detailed ore breakdown<\/p>\n
\n– Top 10 miners by total blocks
\n– Compete with other players
\n– Medal system for top 3<\/p>\n
\n– quarry.user.number.1 – Allow 1 quarry
\n– quarry.user.number.3 – Allow 3 quarries
\n– quarry.user.number.10 – Allow 10 quarries
\n– quarry.admin – Admin commands (\/quarryadmin)<\/p>\n
\nAutomatically slows quarries when server TPS drops below threshold
\n– Prevents lag during high server load
\n– Configurable threshold and slowdown multiplier
\n– Automatic recovery when TPS improves<\/p>\n
\nSkips mining in unloaded chunks to prevent force-loading
\n– Important for large quarries (64×64+)
\n– Reduces chunk load\/unload cycles
\n– Resumes when chunks load naturally<\/p>\n
\nRemembers chest locations to reduce lookups
\n– Only rescans when current chest is full
\n– Configurable cache duration
\n– Supports chest detection 5 blocks radius, 2 vertical<\/p>\n
\nMine multiple blocks per tick for faster operation
\n– Disabled by default for safety
\n– Only activates when TPS > 19
\n– Configurable batch size<\/p>\n
\n– Minecraft 1.20+ (Paper\/Spigot\/Purpur)
\n– Java 21+<\/p>\n
\n– Uses client-side visual effects (no block updates)
\n– Efficient chest detection algorithm
\n– Smart position advancement
\n– Minimal memory footprint
\n– Async-safe statistics tracking<\/p>\n
\n– quarries.yml – Active quarry data
\n– quarry-stats.yml – Player statistics
\n– Auto-saves every 5 minutes
\n– Saves on shutdown<\/p>\n
\n– Works with protection plugins (WorldGuard, GriefPrevention, etc.)
\n– Fires BlockBreakEvent for plugin compatibility
\n– Respects cancelled break events<\/p>\n
\n2. Place in your server’s plugins folder
\n3. Restart your server
\n4. Configure config.yml to your preference
\n5. Set up permissions for your players
\n6. Enjoy automated mining!<\/p>\n
\n Diamonds: 12<\/p>\n
\nHave a suggestion? I’d love to hear it!
\nNeed help? Ask questions here!<\/p>\n
\nAutomated Mining, Done Right
\nAlways wanted a BuildCraft style quarry in vanilla survival?\u200b<\/p>\n","protected":false},"featured_media":127597,"template":"","meta":{"_minecraft_slug":"quarryplugin","_minecraft_project_id":"WdAT6JK4","_minecraft_author":"selfservice0","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":172,"_minecraft_follows":4,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"quarryplugin.zip","_minecraft_size_bytes":7370197,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-16T13:10:35.091647Z","_minecraft_date_created":"2025-12-21T05:20:53.945217Z","_minecraft_date_modified":"2025-12-25T19:50:36.165708Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/quarryplugin","_minecraft_icon_attachment_id":127597,"_minecraft_imported_at":"2026-06-07T12:10:04+00:00","_minecraft_import_hash":"1768e6b1fd362c4ece97e1c9b87ded09","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,844,122,866,127,128,129,91,123,92],"mod_loader":[130,132,133,134],"minecraft_version":[51,52,53,845,846,847,848,849,59,36,60,93,94,101,102,62,37,40,41,808,809,810,811,812,813,814,815,73,74,38,78,79,80,81,82,799,807,816],"class_list":["post-127596","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-economy","mod_category-magic","mod_category-minigame","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-storage","mod_category-technology","mod_category-utility","mod_loader-bukkit","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-2-1","minecraft_version-1-2-2","minecraft_version-1-2-3","minecraft_version-1-2-4","minecraft_version-1-2-5","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-11-pre1","minecraft_version-1-21-11-pre2","minecraft_version-1-21-11-pre3","minecraft_version-1-21-11-pre4","minecraft_version-1-21-11-pre5","minecraft_version-1-21-11-rc1","minecraft_version-1-21-11-rc2","minecraft_version-1-21-11-rc3","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-1-21-9-pre4","minecraft_version-25w46a","minecraft_version-26-1-snapshot-1"],"yoast_head":"\n