Quarry

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

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

• 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

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

⚒️ QuarryPlugin — Automate the digging!