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

Quarry setup

✨ 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 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

[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 21+

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

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

===============================

Support & Updates

Found a bug? Report it in discord! Have a suggestion? I'd love to hear it! Need help? Ask questions here!

⭐ If you enjoy this plugin, please leave a review! ⭐

Version 3.0.3 | Last Updated: December 2025

Need Help?

Documentation: Coming soon

Support Discord: https://discord.gg/G3Z92THjPh

Source Code: Currently Private

⚒️ QuarryPlugin — Automate the digging!