BetterExcavate

A comprehensive mining mechanics overhaul mod that introduces a realistic tool-based mining system for Minecraft 1.20.1.

🌟 Core Features

🔨 Tool Hardness System

• Realistic Mining Mechanics: Each tool has unique hardness values determining which blocks can be mined
• Intelligent Tool Matching: Automatically detects hardness attributes of vanilla and modded tools
• Configurable Hardness Values: Support for custom hardness parameters for each tool

⚖️ Three-Tier Mining Modes

1. Normal Mining (Green) - Tool hardness sufficient, normal item and experience drops
2. Slow Mining (Orange) - Tool hardness insufficient but within tolerance, slow mining with no drops
3. Cannot Mine (Red) - Tool hardness severely insufficient, completely unable to break blocks

🛠️ Tool Type Validation

• Smart Tool Detection: Automatically recognizes appropriate blocks for pickaxes, axes, shovels, hoes, and swords
• Wrong Tool Penalty: 50% mining speed reduction when using incorrect tool types
• Tool Compatibility Hints: Real-time display of tool suitability for current blocks

💎 Durability Impact System

• Progressive Hardness Decay: Tool hardness decreases as tools wear, using natural logarithmic curves
• Intelligent Damage Mechanics: Tools take continuous damage when mining overly hard blocks
• Durability Visualization: Intuitive display of remaining tool durability and wear percentage

🔍 Jade Integration

• Real-time Information Display: Hover to show block hardness, tool hardness, and mining speed
• Mining Mode Indicators: Clear indication of current mining status and possibilities
• Tool Efficiency Analysis: Display tool type correctness and speed penalty information
• Durability Monitoring: Real-time tool wear condition display

🎯 Advanced Features

• Surrounding Block Effects: Mining speed affected when identical blocks cluster together
• Precise State Tracking: Smart detection of player mining state, preventing state loss
• Multi-dimensional Support: Independent mining state management for each dimension
• Performance Optimization: Efficient event handling and state management

🎮 Gameplay Experience

Strategic Mining

• Need to select appropriate tools for different materials
• Tool wear affects mining efficiency
• Plan tool durability management strategically

Balanced Design

• Sword tools have 50% reduced mining hardness, better suited for combat
• Progressive penalty curves avoid sudden performance drops
• Three-tier mining system provides buffer mechanisms

Information Transparency

• Real-time display of all relevant information through Jade mod
• Clear status indicators and color coding
• Detailed tool efficiency analysis

🔧 Technical Features

• Minecraft Version: 1.20.1
• Forge Version: 47.4.4+
• Optional Dependencies: Jade (for information display)
• Mod Compatibility: Automatically recognizes modded tools and blocks
• Performance Optimization: Efficient event handling and caching mechanisms

📦 Installation

1. Ensure Minecraft Forge 47.4.4 or higher is installed
2. Download the BetterExcavate mod file
3. Place the mod file in .minecraft/mods folder
4. (Recommended) Install Jade mod for complete information display functionality
5. Launch the game and enjoy the new mining experience!

🛠️ Development Information

• Developer: Goldgom
• License: LGPL-3.0
• Version: 1.0.0-beta
• Repository: BetterExcavate

🤝 Contributing & Feedback

Suggestions, bug reports, and code contributions are welcome! This mod aims to bring a more balanced and strategic mining experience to Minecraft.

Make mining more strategic!