Quarry

️ Screenshots

Default recipe


Quarry shaft



Quarry setup


Quarry GUI


Skill Tree


⛏️ 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

1. Place 4 redstone torches forming a rectangular corner.
2. Craft or obtain your Quarry Furnace (has "Quarry Block" lore).
3. Place it outside the torch area but next to one torch.
4. Watch the quarry dig automatically.
5. Place chests adjacent to the furnace to collect resources.
6. Right-click the furnace to pause or resume at any time.

[TABLE="class: grid, width: 100%, align: center"]
Command Description Permission
/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 quarry.user.number.#
/qconfig Reload plugin configuration without restart quarry.admin
/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
[/TABLE]






Default Recipe
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)


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!




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



Note: OPs have unlimited quarries and can break any quarry



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



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



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!






• More skills to the skill tree
• Translations (messages.yml)
• Sound effects
• And more based on your feedback!



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
Source Code: Currently Private