🛠️ OneKeyMiner (Forge / NeoForge) – Chain Mining & Planting Mod

Loaders: Forge & NeoForge Compatible Minecraft Versions: 1.20.x & 1.21.x (including 1.21.5)

🌟 If you could make a YouTube video for this Mod—introducing the Mod and its features, while showcasing the uses and effects of commands in the video—I'd be thrilled to add a link to your YouTube video on all platforms where this Mod is released! 🎥✨

Then please contact me at my email: maixiyumc@gmail.com.

📋 Overview

OneKeyMiner offers a seamless chain-mining and farming experience on both Forge and NeoForge. Hold down your chosen key (default: ~) to auto-break adjacent identical blocks or plant seeds in bulk. Both versions deliver identical core functionality—mining, planting, tool durability protection—while NeoForge further expands interaction capabilities.

✨ Features

• Chain Mining: Break one block, and all connected matching blocks are automatically mined.
• Chain Planting: Plant seeds over multiple tilled blocks in one go.
• Tool Protection & Durability Check: Mod prevents tool breakage mid-use, ensuring smooth operation.
• Advanced Configuration: Customize limits, tools, block types, and modes for tailored play.
• NeoForge Exclusive – Chain Interactions: Beyond ore and crops, use the feature on sheep (shears), farmland, and other block-entity actions.

⚙️ Commands & Config Differences

Both versions share the /excavation command prefix, but differ slightly in subcommands:

• To ignore tool compatibility in NeoForge, use:

  /excavation common common ignoreToolCompatibility true

(This command format may not apply identically in Forge.)

• Forge users: If chain mining fails, try deleting its config and restarting; commands are simpler and may vary.

🆕 Version History & Sync Status

• Forge v3.0.0 – Released May 27, 2025; this version achieves full feature parity with NeoForge 1.5.3, differing only in command parameters（Forge 3.0.1 ==NeoForge 1.5.4）.

✅ Summary

• Forge & NeoForge both deliver complete chain-mining/planting, tool protection, and auto-durability.
• NeoForge(Forge 3.0.0++) adds extra versatility through chain interactions (e.g., sheep shearing) and more robust configuration options.
• Choosing between them depends on loader preference and your need for command precision.

❓Q&A:

Q: Why can't I vein mine stone?
A: Maybe you should check the common config file or enter the command /excavation common options nonblockmined list.

Q: How do I change the chain quantity?
A: You can check the common config file or use /excavation common options maxChainBlocks .

Q: Why does my chain mode require pressing to toggle each time instead of starting when held down?
A: You can check the client config file or…

Q: Why are some blocks missed when chain mining instead of being vine mined together?
A: Check the common config or enter /excavation common options enableDiagonalChaining true.

Q: How to make items dropped from vine mined blocks teleport to myself?
A: Check the common config file or use /excavation common options teleportDropsToPlayer <true|false>.

Q: Why do the enchantments on my tool not work when vine mining? Or why can I still vine mine when my tool is incompatible?
A: You should enter /excavation common options ignoreToolCompatibility false or set ignoreTool compatibility to false.

Q: Why does my chain mode automatically turn off after a while when set to toggle?
A: Many players reported forgetting to turn off chain mode, leading to vine mining unintended blocks, so I added a frozen feature. You can change the cooldown time in the client config or use commands.