AntiBranchMining: Eliminating Branch Mining in Minecraft UHC
Branch mining is one of the oldest and most reliable techniques in Minecraft. By digging organized tunnels at low Y-levels, players maximize their exposure to valuable ores like diamonds, gold, and lapis lazuli. It is a safe, methodical way to gear up without facing the dangers of dark caves or hostile mobs. However, in the competitive world of Ultra-Hardcore (UHC) tournaments, this very safety and efficiency creates a major problem. Hosts often ban branch mining because it bypasses the risk-reward balance that makes UHC exciting, but policing such a rule is a nightmare. Accusations fly, players misunderstand the boundaries, and hosts spend hours reviewing tunnel patterns. AntiBranchMining is a Bukkit plugin designed to solve this conflict once and for all, by making branch mining completely pointless while preserving every ore that can be discovered through genuine caving.
How AntiBranchMining Works
The plugin takes a clever approach: instead of simply deleting all ores, it analyzes chunk generation and removes only those ore veins that are not exposed to air or natural cave systems. Any ore that touches a cave wall, ravine, mineshaft, or dungeon remains untouched. Ores buried deep within solid stone, which would only ever be found by digging long, straight tunnels, are replaced with stone. The result is a world where caving remains just as rewarding as in vanilla Minecraft, but every form of systematic tunneling yields nothing. Players who stick to exploring natural underground structures will never notice a difference, while those who try to branch mine will quickly realize their efforts are futile.
Key Features of AntiBranchMining
Simple Setup and Lightweight Performance
Installation is as straightforward as dropping the plugin JAR into your server’s plugins folder before generating a new world. No configuration is required for basic functionality, and the performance impact is minimal. Chunk loading takes only 15–20% longer on average, a difference of just a few milliseconds per chunk. If you pre-generate your UHC arena with the plugin active, it does nothing during gameplay, so there is zero lag when it matters most.
Effective Ore Removal Without Hurting Caving
In a 1600×1600 map, AntiBranchMining leaves approximately 14,000 gold ore and 5,000 diamond ore available purely through caving. That is more than enough to keep the game competitive and engaging. All ores that could be spotted from a cave entrance or while traversing an underground ravine remain exactly where they should be. The plugin effectively erases the incentive to dig repetitive 1×2 tunnels at diamond level.
Deep Customization Options
From version 0.2 onward, AntiBranchMining supports multi-world configurations via a config.yml file. You can disable the plugin for specific worlds, exclude certain ore types from removal, or limit the maximum Y-level the plugin checks. Version 0.3 introduced the ore removal factor, allowing you to keep a percentage of branch-mining-only ores. For example, setting the factor to 90 removes 90% of those veins, leaving a small chance for stubborn miners. This works per vein, not per block, so the remaining ore clusters still feel natural.
For servers using custom terrain generation or modded dimensions like the Nether, you can define which block IDs count as ores and what material replaces them. This means AntiBranchMining can handle nether quartz in a Nether-only UHC scenario by setting the replacement material to netherrack and listing quartz ore as a recognized ore.
Multi-World and Advanced Settings
The config.yml allows per-world overrides, so your main survival world can stay untouched while a UHC arena uses aggressive removal. You can also record ore compositions and view detailed statistics with the /orestats command, giving hosts transparency into how the world was altered. This data is invaluable for balancing and rule enforcement.
Installation and the Foxygame.net Launcher Advantage
Setting up AntiBranchMining manually is a breeze, but if you are managing a UHC server and want to keep your entire modpack organized, the foxygame.net launcher offers a seamless way to handle plugin downloads. This modern Minecraft launcher lets you browse and install mods and plugins directly from its menu, so you can add AntiBranchMining to your server setup without hunting for JAR files. It is a convenient, flexible tool that streamlines the process for both hosts and players who want to jump into custom game modes quickly.
Commands and Permissions
The plugin adds a single command to help hosts verify ore distribution:
- /OreStats – Displays the remaining ore composition per chunk and the average time taken to process each chunk. To see full details, set debugstats to true in config.yml before world generation.
The permission node antibranchmining.commands.orestats defaults to operators, so only trusted staff can access this data.
Troubleshooting and Compatibility
AntiBranchMining requires Java 7. If you encounter an “Unsupported major.minor version 51.0” error, your server is running an older Java version. Contact your hosting provider to upgrade, or on Mac OS X, install JDK 7 instead of just the JRE. The plugin is built against the Bukkit API, ensuring broad compatibility with other plugins and future CraftBukkit versions. It will not break unless a very rare, deliberate API change occurs.
Why AntiBranchMining Is a Game-Changer for UHC
The drama surrounding branch mining accusations has plagued UHC communities for years. Hosts spend hours spectating players, examining tunnel shapes, and making judgment calls that often feel arbitrary. Players, in turn, grow frustrated when they are penalized for digging a straight path to a cave sound or for creating a staircase that accidentally resembles a mining branch. AntiBranchMining removes the entire debate by removing the possibility of gaining ores through systematic tunneling. Everyone plays by the same mechanical rules, and the focus shifts back to exploration, combat, and survival skill.
Because the plugin preserves every cave-accessible ore, the vanilla caving experience remains intact. You can still stumble upon a massive diamond vein behind a gravel patch in a ravine, or spot gold glittering on the ceiling of an abandoned mineshaft. The only thing that changes is that mindlessly clearing out a 2-high tunnel at Y=11 becomes a waste of time and pickaxes. This encourages players to engage with Minecraft’s underground generation the way it was meant to be enjoyed: by venturing into the dark, torch in hand, ready for anything.
Conclusion
AntiBranchMining is an elegant, server-side solution to one of UHC’s most persistent headaches. It requires no client-side mods, imposes negligible performance overhead, and gives hosts complete control over how ore generation behaves. By eliminating the profitability of branch mining while keeping caving fully rewarding, it restores the risk-versus-reward balance that defines Ultra-Hardcore. Whether you run a small private tournament or a large public network, this plugin can save you hours of moderation and endless disputes. Simply drop it into your plugins folder, generate a fresh world, and let the caves do the talking.