Chain Mining, Interaction & Planting - All in One!
๐จ๐ณ ไธญๆๆๆกฃ | ๐ User Guide | ๐ง API Documentation
- โ๏ธ Chain Mining - Break connected blocks of the same type at once
- โ๏ธ Chain Interaction - Batch shearing, hoeing, stripping, path making
- ๐ฑ Chain Planting - Auto-plant crops on adjacent farmland
- ๐ฎ Multi-Platform - Supports Fabric, NeoForge, and Forge
- โ๏ธ Highly Configurable - Customize max blocks, distance, activation mode
- ๐ท๏ธ Tag Support - Use tags like
#minecraft:logs,#c:ores - ๐ก๏ธ Protection - Auto-stop when tool durability or hunger is low
- ๐ API Available - Easy integration for other mods
| Component | Version |
|---|---|
| Minecraft | 1.21.9 |
| Java | 21+ |
| Fabric Loader | 0.15.0+ |
| NeoForge | 21.0+ |
| Forge | 59.0+ |
Download the latest release from GitHub Releases.
Choose the correct version for your platform:
onekeyminer-fabric-x.x.x-1.21.9.jarfor Fabriconekeyminer-neoforge-x.x.x-1.21.9.jarfor NeoForgeonekeyminer-forge-x.x.x-1.21.9.jarfor Forgeonekeyminer-x.x.x-1.21.9.jarfor universal (auto-detect)
- Hold a pickaxe or axe
- Hold the activation key (default:
`backtick) - Break an ore or log
- Watch connected blocks break automatically!
- Hold a hoe, axe, shovel, or shears
- Hold the activation key
- Right-click to interact with blocks
- Adjacent interactable blocks are also processed!
- Hold seeds or crops
- Hold the activation key
- Right-click on farmland
- Adjacent empty farmland is planted automatically!
Configuration file location: config/onekeyminer.json
| Option | Default | Description |
|---|---|---|
enabled |
true |
Enable/disable the mod |
maxBlocks |
64 |
Maximum blocks per chain operation |
maxDistance |
16 |
Maximum search distance |
allowDiagonal |
true |
Allow diagonal block connections |
consumeDurability |
true |
Consume tool durability |
preserveDurability |
1 |
Stop when durability reaches this value |
consumeHunger |
true |
Consume hunger for each block |
minHungerLevel |
1 |
Stop when hunger reaches this value |
allowBareHand |
true |
Allow chain mining without tools |
teleportDrops |
false |
Teleport drops to player inventory |
teleportExp |
false |
Teleport experience to player |
{
"customWhitelist": ["mymod:custom_ore"],
"blacklist": ["minecraft:bedrock"],
"toolWhitelist": [],
"toolBlacklist": ["minecraft:wooden_pickaxe"]
}OneKeyMiner provides a comprehensive API for mod developers.
// Fabric
modImplementation "org.xiyu:onekeyminer-fabric:2.0.0"
// NeoForge/Forge
implementation "org.xiyu:onekeyminer-neoforge:2.0.0"import org.xiyu.onekeyminer.api.OneKeyMinerAPI;
// Register custom blocks
OneKeyMinerAPI.registerBlock("mymod:custom_ore");
OneKeyMinerAPI.registerBlockTag("#mymod:ores");
// Register custom tools
OneKeyMinerAPI.registerTool("mymod:super_pickaxe");
// Listen to events
ChainEvents.registerPreActionListener(event -> {
// Custom logic before chain operation
});See API Documentation for complete API reference.
Want to build addon mods or integrations? You can use our API to register blocks/tools and listen to chain events.
- โ Fabric (with Fabric API)
- โ NeoForge
- โ Forge
- Mod Menu (Fabric)
- Most ore/tool mods
Uses ServerPlayerGameMode#destroyBlock() for proper integration with:
- FTB Chunks
- Claim plugins
- Other protection mods
- Branching: Each Minecraft version uses its own branch (e.g.,
1.21.9). - Latest: The latest Minecraft version is maintained on
master. - Tag format:
<branch>-<mod_version>(example:1.21.9-1.6.0).
Found a bug or have a suggestion?
This project is licensed under All Rights Reserved (ARR). You may not copy, modify, or distribute the code without permission from the author.
- Author: Mai_xiyu
- Project Origin: The original OneKeyMiner had separate projects and branches for each mod loader and Minecraft version. This unified version was created to consolidate all platforms into a single codebase with completely refactored code.
- Special Thanks: All contributors and testers
Made with โค๏ธ for the Minecraft community