Ultimate Pickaxes

Transform your mining experience with 18 unique and powerful pickaxes!

Ultimate Pickaxes adds a collection of specialized pickaxes to Minecraft, each with unique abilities that go far beyond simple mining. From automatic ore smelting to vein mining, from item magnetism to time manipulation, from dimensional teleportation to intelligent cause-and-effect mining - there's a pickaxe for every playstyle!

---

✨ Features

18 Unique Pickaxes

🔥 Fire Pickaxe

• Automatically smelts ores as you mine them
• Grants Fire Resistance while mining
• Melts snow and ice in a radius around you
• Leaves a trail of fire behind
• Burns enemies on hit
• Extra fast on Netherrack and Magma blocks

🌀 Void Pickaxe

• Toggleable void filter (Shift + Right Click)
• Automatically destroys unwanted blocks (stone, cobblestone, etc.)
• Customizable filtered blocks via config
• Bonus XP from valuable ores
• Perfect for clean mining without inventory clutter!

💣 TNT Pickaxe

• Creates explosions when mining ores
• Automatically grants Damage Resistance and Fire Resistance
• Larger explosions for coal blocks
• Super fast mining on ores, TNT, and Obsidian
• All drops are preserved!

👤 Shadow Pickaxe

• Grants Speed, Haste, and Night Vision while mining
• Invisibility when mining ores
• Chance to teleport when mining rare ores (Diamond, Emerald, Ancient Debris)
• Brief levitation effect
• Blinds hostile mobs and removes their aggression when hit

🦴 Bone Pickaxe

• Drops bones and bone meal when mining ores
• Grants Regeneration effect
• Chance for Absorption hearts
• Perfect for skeleton farm alternatives!

⛏️ Vein Pickaxe

• Automatically mines entire ore veins in one go!
• Mines up to 64 connected ore blocks
• Shows progress message
• Crouch to disable vein mining for precise control
• Works with diagonal blocks

⚫ Coal Pickaxe

• Night Vision in dark areas
• Extra coal drops when mining coal ore
• Bonus XP for all ores
• Super fast on coal ore
• Enhanced mining speed on all ores

🌿 Natural Pickaxe

• Converts Cobblestone to Mossy Cobblestone
• Converts Stone Bricks to Mossy Stone Bricks
• Works on stairs, slabs, and walls
• Preserves Grass Blocks (drops grass block instead of dirt)
• Perfect for builders!

⏰ Time Pickaxe

• 15% chance to mine instantly without durability loss
• Self-repairs while mining (5% chance)
• Accelerates plant growth nearby
• Slows hostile mobs in radius
• Grants Speed and Haste effects

💰 Fortune Pickaxe

• Permanent Luck V effect while mining
• 30% chance for extra ore drops
• 10% JACKPOT chance for massive drops (3x items!)
• Extra XP based on ore rarity
• Ancient Debris gives 20 XP per block!

🧲 Magnet Pickaxe

• Automatically attracts items and XP in 10 block radius
• Works while holding the pickaxe
• 5% chance to self-repair while mining
• Configurable attraction range and speed

⚡ Laser Pickaxe

• Mines in a straight line through multiple blocks
• Breaks 6 blocks in the direction you're facing
• Works up, down, and sideways
• Grants Haste III and Speed II while using
• Customizable laser-compatible blocks

👁️ Enderman Pickaxe ✨NEW!

• 10 teleport charges (right-click to teleport to target block)
• Charges regenerate every 5 minutes (1 charge per 5 min)
• Grants permanent Night Vision when held
• Endermen never attack you when you have this pickaxe
• Monsters flee when you look at them
• Visual portal particle effects on teleport
• 64 block teleportation range

🧭 Pathfinder Pickaxe ✨NEW!

• Creates 3x3 navigable tunnels automatically
• Auto-places torches every 4 blocks for lighting
• Smart ladder placement on steep slopes (2+ block height changes)
• Toggle tunnel mode with Shift + Right-click
• Preserves important blocks (chests, ores, spawners)
• Perfect for cave exploration and strip mining!

🩸 Blood Pickaxe ✨NEW!

• 50% Lifesteal - converts damage dealt into healing
• 25% chance to apply Wither II to enemies (5 seconds)
• Mining speed increases as health decreases (up to 3x faster!)
• Extra drops at night (30% chance for bonus items)
• Pulsating blood particle effect when held
• High risk, high reward combat pickaxe!

❄️ Frost Pickaxe ✨NEW!

• Freezes water into packed ice in 3 block radius
• 15% chance to freeze enemies (7 seconds frozen)
• Applies Slowness III and Mining Fatigue II on hit
• Grants Resistance I while mining for defense
• 3x mining speed on ice, packed ice, and snow blocks
• Beautiful snowflake particle effects

🔍 Prospector Pickaxe ✨NEW!

• Detects rare ores within 16 blocks when mining stone/deepslate
• Shows approximate direction to nearest ore (never exact location)
• Detects: Diamond, Emerald, Ancient Debris, Gold, Lapis, Redstone
• Grants permanent Haste I when held
• 3 second cooldown between ore scans
• Visual directional pulse particles guide you to ores
• Perfect for efficient branch mining!

🧠 Causal Pickaxe ✨NEW! 🌟UNIQUE MECHANIC!

• Cause & Effect mining system - each block affects the next!
• State-based bonuses that chain together:
  • 🪨 STONE → Next block mines faster (+Speed)
  • 💎 ORE → Next block has better drops (30% bonus)
  • 🌱 NATURAL (dirt/grass) → Next block has +Fortune
  • ⚡ RARE ORE → Massive XP bonus + Haste II (100 ticks)
  • ❌ USELESS (gravel/sand) → Small mining slowdown
• Chain multiplier - mine same block types for up to 2x bonus!
• Real-time HUD showing current state and chain count
• Rewards strategic mining patterns and skill!

---

🎁 Crafting Materials

To craft the new advanced pickaxes, you'll need to collect special materials that drop from various sources:

🧿 Ender Focus

Required for: Enderman Pickaxe

Description: An unstable crystal that reacts to the player's gaze.

How to Obtain:

• Drop from Enderman: 5% chance
• Player kill: 15% chance
• In the End dimension: 100% chance (guaranteed!)

Pro Tip: Farm Endermen in the End for guaranteed drops!

---

🪜 Explorer Core

Required for: Pathfinder Pickaxe

Description: A core that understands paths and terrain.

How to Obtain:

• Stone/Deepslate mining: 0.1% chance
• Below Y=0: 0.5% chance (5x better!)
• Mossy Cobblestone: 100% chance
• Cave Vines: 100% chance

Pro Tip: Search for lush caves or create mossy cobblestone for guaranteed drops!

---

🩸 Crimson Shard

Required for: Blood Pickaxe

Description: A living fragment pulsing with vital energy.

How to Obtain:

• Hostile mob kills: 3% chance
• At night: 10% chance
• Kill mobs while below 50% HP: 100% chance (guaranteed!)

Pro Tip: Fight at night with low health for guaranteed drops - fits the Blood Pickaxe theme!

---

❄️ Frozen Core

Required for: Frost Pickaxe

Description: An eternally frozen core that drains heat.

How to Obtain:

• Stray kills: 20% chance
• Snow Golem kills: 10% chance
• Packed Ice mining: 2% chance
• Blue Ice mining: 5% chance

Pro Tip: Farm Strays in icy biomes or mine blue ice in icebergs!

---

🪙 Resonant Ore Fragment

Required for: Prospector Pickaxe

Description: A fragment that vibrates near valuable minerals.

How to Obtain:

• Any ore mining: 1% chance
• Below Y=16: 2% chance (doubled!)
• Ancient Debris: 100% chance (guaranteed!)

Note: Fortune does NOT increase drop chance!

Pro Tip: Mine at diamond level (Y=-60 to Y=16) for better chances!

---

🧬 Causality Matrix

Required for: Causal Pickaxe

Description: An artifact that records and reacts to past actions.

How to Obtain:

• Mine 5 different block types without repeating: 5% chance
• Diamond Ore immediately after Redstone Ore: 100% chance (guaranteed!)

Pro Tip: Mine strategically! Find Redstone near Diamonds for guaranteed drops.

---

⚙️ Extensive Configuration System

Every aspect of every pickaxe is fully configurable! Over 120 configuration options allow you to:

• Adjust effect durations and amplifiers
• Modify drop chances and quantities
• Configure explosion sizes and ranges
• Set mining speeds for different blocks
• Enable/disable specific features
• Customize block lists (void filter, laser blocks)
• Balance for multiplayer servers
• Optimize for performance

Configuration Examples

[firePickaxe]
    # Enable automatic ore smelting when mining with Fire Pickaxe
    enableSmeltOres = true
    # Duration in ticks for fire resistance effect (20 ticks = 1 second)
    fireResistanceDuration = 400
    # Chance to create fire on nearby blocks (0.0 = never, 1.0 = always)
    fireTrailChance = 0.15

[veinPickaxe]
    # Maximum number of blocks that can be mined in one vein
    maxVeinSize = 64
    # Whether to check diagonal blocks when searching for vein
    checkDiagonals = true
    # Whether crouching disables vein mining
    crouchToDisable = true

[fortunePickaxe]
    # Chance to trigger jackpot (massive extra drops)
    jackpotChance = 0.1
    # Number of extra items dropped during jackpot
    jackpotMultiplier = 3
    # Extra XP for diamond ore
    diamondXP = 10
    # Extra XP for ancient debris
    ancientDebrisXP = 20

See CONFIG_ANALYSIS.md for complete configuration documentation!

---

🎮 How to Use

1. Craft your pickaxe using the recipes (check JEI/REI for recipes)
2. Mine blocks to experience unique effects
3. Special Controls:
   • Void Pickaxe: Shift + Right Click to toggle the void filter
   • Pathfinder Pickaxe: Shift + Right Click to toggle tunnel mode
   • Vein Pickaxe: Crouch while mining to disable vein mining temporarily
   • Laser Pickaxe: Look in any direction (including up/down) to control laser direction
   • Enderman Pickaxe: Right Click while looking at a block to teleport (uses 1 charge)
   • Causal Pickaxe: Mine strategically - same block types create powerful chains!

---

📦 Installation

1. Install NeoForge for Minecraft 1.21.1
2. Download Ultimate Pickaxes from CurseForge or Modrinth
3. Place the .jar file in your mods folder
4. Launch Minecraft and enjoy!

Requirements

• Minecraft: 1.21.1
• Mod Loader: NeoForge
• Dependencies: None - this is a standalone mod!

---

🛠️ For Server Admins

Ultimate Pickaxes is highly configurable for multiplayer environments:

• Balance settings for competitive servers
• Disable features that may be too powerful
• Adjust ranges to reduce server load
• Customize drop rates to match your economy
• Performance optimizations available (adjust vein sizes, attraction ranges, etc.)

Configuration file location: config/ultimatepickaxes-common.toml

---

🎨 Perfect For

• ⛏️ Miners who want efficient ore collection
• 🏗️ Builders who need mossy variants (Natural Pickaxe)
• ⚡ Speed runners who value efficiency
• 🎮 Modpack creators looking for balanced mining upgrades
• 🖥️ Server owners wanting customizable content