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 ```toml [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