OreMiner

🎉 OreMiner v1.0.0 - Initial Release! 🎉

📅 Release Date

August 28, 2025

✨ New Features ✨

⛏️ Core Vein Mining System

• Smart Vein Detection: Automatically finds and breaks connected ores of the same type
• Efficient Processing: Uses flood-fill algorithm for accurate vein identification
• Block Type Support: Works with all vanilla ore types including deepslate variants

🍀 Fortune Enchantment Integration

• Accurate Drop Calculation: Implements exact Minecraft Fortune formulas for all ore types
• Ore-Specific Handling:
  • Diamond/Coal/Emerald: 1-4 drops with Fortune III
  • Redstone/Lapis: Base drops + Fortune bonus
  • Raw Metals: Full Fortune support (1.21+ mechanics)
• Silk Touch Priority: Correctly handles Silk Touch vs Fortune interaction

🧲 Smart Item Magnet System

• Direct Inventory Collection: Items go straight to player inventory when enabled
• Intelligent Stacking: Merges with existing stacks before using empty slots
• Full Inventory Fallback: Drops excess items on ground when inventory is full
• Configurable Toggle: Enable/disable via config file

⌛ Experience Management

• Consolidated XP Drops: All experience from vein mining drops at player location
• Accurate XP Values: Implements vanilla XP rates for each ore type
• Optimized Orbs: Splits large XP amounts into multiple orbs (max 10 XP per orb)
• Mending Integration: XP can repair tools before dropping excess

🔧 Durability & Enchantment Support

• Unbreaking Mechanics: Properly calculates durability cost with enchantment
• Mending Repair: Tools repair themselves using collected XP when enabled
• Tool Breaking: Realistic tool destruction with sound effects
• Enchantment Priority: Correctly handles multiple enchantments

⚙️ Configuration System

• Ore Blacklist: Exclude specific ores from vein mining
• Magnet Control: Turn item collection on/off

🔧 Technical Features 🔧

🏗️ Performance Optimized

• Efficient Algorithms: Flood-fill with Chebyshev distance for block detection
• Two-Pass Processing: Separates calculation from block breaking
• Memory Management: Proper cleanup and resource handling

🌐 Compatibility

• Version Support: Minecraft 1.21+ (Java Edition)
• Platform Support: Paper (wasn't tested on Paper's forks)
• Plugin Integration: Works alongside most common plugins

🚨 Known Issues 🚨

• Large Veins: Very large ore veins (>50 blocks) may cause slight server lag
• WorldGuard: May not respect region protections (planned for v1.1)

🔮 Planned for v1.1 🔮

• WorldGuard Integration: Respect region protections
• Performance Mode: Optimized handling for large servers

📥 Installation 📥

1. Download OreMiner-v1.0.0.jar
2. Place in your server's plugins folder
3. Restart server
4. Configure config.yml to your liking
5. Enjoy enhanced mining!

🐛 Reporting Issues 🐛

Found a bug? Have a suggestion?
Please report it on our GitHub Issues

❤️ Support Development ❤️

If you enjoy OreMiner, consider:

• ⭐ Starring our GitHub repository
• 🐛 Reporting bugs and suggesting features
• 💖 Pull request & contribute

Made with ❤️ by the OreMiner Team
Revolutionizing Minecraft mining, one vein at a time!