⛏️ Simple Quarries Plus

A feature-rich Fabric quarry mod that automates vertical mining using fuel and pickaxes. Mine entire shafts automatically with configurable area sizes, speed upgrades, item filters, chunk loading, and full Fortune/Silk Touch support.

✨ Features

Core Functionality

• Automated Mining: Place a quarry and watch it excavate a vertical shaft straight down
• Tool-Based Mining: Insert any pickaxe — the quarry uses its mining speed, enchantments, and durability
• Fuel System: Power your quarry with any standard furnace fuel (coal, lava buckets, wood, etc.)
• Smart Block Selection: Automatically skips air, bedrock, and other quarries
• Large Inventory: 24-slot output storage with automatic item collection
• Enchantment Support: Full compatibility with Fortune, Silk Touch, Efficiency, and Unbreaking
• Completion Sound: Plays a level-up sound when the quarry finishes mining its area

🔧 Upgrade System

• Area Upgrades: Start at 5×5, upgrade up to 15×15 (5 levels, +2 per upgrade)
• Speed Upgrades: Up to 5 levels — each reduces mining delay by 20%, maxing out at instant mining
• Quarry Upgrade Templates: Found in dungeon chests, bastions, end cities, and more
• Speed Upgrade Templates: Found in loot chests alongside area upgrades
• Persistent Upgrades: Upgraded quarries keep their level when broken and replaced
• Simple Upgrading: Craft quarry + upgrade template in a crafting grid

🔍 Filter System (NEW in v0.2.0)

• 9-slot filter grid: Place items to define what the quarry should collect
• Three modes: Disabled (collect everything), Whitelist (only matching items), Blacklist (skip matching items)
• Filters match drops, not blocks: e.g. put Diamond in the filter to collect only diamond drops from Diamond Ore
• Cycle with one click: Toggle between Disabled → Whitelist → Blacklist in the quarry UI

⚡ Redstone Control (NEW in v0.2.0)

• Redstone-pausable: Apply a redstone signal to pause mining — remove the signal to resume
• Fully automatable: Use redstone clocks, daylight sensors, or logic gates to control when the quarry runs

🌐 Chunk Loading (NEW in v0.2.0)

• Automatic chunk loading: The quarry force-loads its chunk while actively mining
• No extra mods needed: Works out of the box — no need for chunk loader mods
• Auto-unloads: When the quarry stops (out of fuel, finished, or paused by redstone), the chunk is released

⚙️ Automation Support

• Hopper Compatible: Extract items from bottom, insert fuel from top, insert pickaxes from sides
• Comparator Support: Outputs redstone signal based on inventory fullness
• Item Overflow Protection: Extra items drop above the quarry if inventory is full

📖 How to Use

Basic Setup

1. Craft a Quarry block and place it where you want to mine
2. Right-click to open the quarry interface
3. Insert a pickaxe in the top-left slot
4. Add fuel to the slot below the pickaxe
5. The quarry will begin mining and storing blocks in the output grid

Quarry Crafting

Mining Mechanics

• The quarry mines in a square area centered on itself, going straight down
• Mining speed depends on pickaxe type:
  • Golden pickaxes are fastest
  • Netherite and diamond are very efficient
  • Efficiency enchantment significantly increases speed
• Durability is consumed per block mined (reduced by Unbreaking)
• Fuel is consumed per block mined — different fuels mine different amounts of blocks

⚡ Fuel Efficiency

Here's how many blocks different fuels can mine:

• Lava Bucket: 100 blocks
• Coal Block: 80 blocks
• Dried Kelp Block: 20 blocks
• Blaze Rod: 12 blocks
• Coal/Charcoal: 8 blocks each
• Wood/Planks: 2 blocks per item
• Sticks/Bamboo: 1 block each

📦 Upgrading Your Quarry

Area Upgrades

Find Quarry Upgrade Templates in loot chests:

• Bastions (30% chance — best source)
• Stronghold libraries and corridors (20% chance)
• Abandoned mineshafts (10% chance)
• End cities (8% chance)
• Desert pyramids (5% chance)
• Dungeons and ruined portals (3% chance)

Place your Quarry + Upgrade Template in a crafting grid (shapeless). Each upgrade increases mining width by 2 blocks.

Area Progression:

Level	Area	Blocks/Layer
0	5×5	25
1	7×7	49
2	9×9	81
3	11×11	121
4	13×13	169
5 (Max)	15×15	225

Speed Upgrades

Find Speed Upgrade Templates in the same loot chests. Craft with your quarry to apply.

Speed Progression:

Level	Speed Bonus	Effect
0	Base	Normal mining speed
1	-20% delay	Noticeably faster
2	-40% delay	Fast
3	-60% delay	Very fast
4	-80% delay	Extremely fast
5 (Max)	Instant	Mines blocks instantly

🔍 Using Filters

1. Open the quarry GUI — the filter grid is on the right side
2. Place items in the 9 filter slots to define your filter
3. Click the filter mode button to cycle: Disabled → Whitelist → Blacklist
   • Whitelist: Only collects items that match the filter (everything else is skipped)
   • Blacklist: Skips items that match the filter (everything else is collected)
4. Filters check against dropped items, not blocks — put Diamond (not Diamond Ore) to filter diamonds

⚙️ Automation Tips

• Input fuel automatically: Place a hopper on top pointing into the quarry
• Extract items automatically: Place a hopper underneath or use item pipes/ducts
• Insert pickaxes: Use hoppers on the sides for automatic pickaxe feeding
• Monitor fullness: Connect a comparator to detect when output inventory is full
• Pause with redstone: Wire a lever or redstone torch to stop/start mining on demand

💡 Tips

• Use Unbreaking III pickaxes to significantly reduce pickaxe consumption
• Fortune III works perfectly — get extra diamonds, coal, redstone, etc.
• Silk Touch is supported — collect grass blocks, stone, ores as-is
• Efficiency V dramatically increases mining speed
• Stack speed upgrades with an Efficiency V netherite pick for absurd mining rates
• Use filters to skip cobblestone/dirt and only keep valuables
• The quarry auto-loads its chunk — no need for external chunk loaders
• Upgrade to 15×15 for maximum efficiency — 9x more blocks per layer than base
• Apply redstone to pause the quarry when your storage is full