MinersAdvantage

# MinersAdvantage !(https://raw.githubusercontent.com/DuelMonster/MinersAdvantage/MC_1.15.2/src/main/resources/MinersAdvantage_Banner.png) ## Overview MinersAdvantage is the "I came to mine, not file paperwork" mod. It is another full rewrite of the old MC 1.20 era version: keeping the same beloved quality-of-life components, remove the historical pain points, and make the whole thing saner for both singleplayer and multiplayer. You still get massive time savings when mining, farming, and tree clearing, but with modern Fabric and NeoForge support and cleaner behavior under server load. If you have ever thought "I only wanted a few stacks of stone, why am I still here 45 minutes later", this mod was made for you. ## Features - Captivation: automatically pulls nearby items and XP to you (magnet mode style). - Cropination: harvests/replants mature crops with the right-click of a hoe. - Cultivation: boosts farming behavior by auto-tilling valid farmland around valid water/hydration conditions. - Excavation: mines connected blocks in an area instead of one block at a time. - Pathanation: builds path trails quickly using your shovel workflow. - Illumination: places torches while you mine so darkness stops ambushing you. - Lumbination: chops full trees with trunk and leaf-aware logic. - Shaftanation: cuts configurable strip-mine shafts. - Substitution: auto-picks the best hotbar tool based on context and rules. - Veination: mines complete ore veins with configurable controls. - Ventilation: digs vertical shafts (up or down) with optional ladder placement. - Server-aware syncing: gameplay settings are synchronized and can be server-authoritative in multiplayer. - Multi-loader + multi-version support: Fabric and NeoForge builds are produced from one shared codebase. ## How It Works ### Captivation Captivation watches for item entities and XP orbs in your configured radius and pulls in what is allowed by your list mode. You can run it as a whitelist or blacklist model, and it can also apply an unconditional blacklist so specific items never get vacuumed up. ### Cropination Cropination has two main farming quality-of-life features: crop harvesting with immediate replanting when right-clicking a hoe on your crops, and optional seed harvesting that lets you choose whether you optimize for clean output or seed stockpile growth. ### Cultivation Cultivation focuses on automatic tilling with hydration-driven farming checks so farmland automation only happens where water support is valid. It exists to make farming automation feel intentional instead of "randomly angry". ### Excavation Excavation breaks matching blocks in a configurable volume with per-tick processing limits, block-variant handling, and list filtering logic. It supports hold/toggle style usage and cooperates with other systems like Illumination and Veination when those shared options are enabled. ### Pathanation Pathanation converts grass/dirt routing into quick path creation with configurable width and length. It is effectively your "build roads without carpal tunnel" button and works on all types of dirt. ### Illumination Illumination monitors local light and places torches when your threshold is crossed. You keep mining, it handles the "surprise creeper corner" prevention program. ### Lumbination Lumbination traverses trunk and leaf space to identify the full tree and remove it according to your policy settings. You can control leaf handling, durability behavior, and sapling replanting so it matches your preferred balance between speed and sustainability. ### Shaftanation Shaftanation digs straight mining corridors using configurable width, height, depth, and per-tick pace. You choose the shaft shape budget, it performs the repetitive labor. ### Substitution Substitution evaluates the block/entity context and swaps to the best tool in your hotbar, then can optionally switch back. The rule profile supports action-aware target matching and advanced expression-based prioritization for players who like precise control. ### Veination Veination expands ore mining into full vein extraction with distance limits and optional timing modifiers. It can also control whether sneaking is required and where harvested ore drops are placed. ### Ventilation Ventilation creates vertical access shafts with configurable dimensions and throughput. Optional ladder placement helps turn that shaft into an actually usable route instead of a stylish pit. ### Multiplayer Sync and Enforcement Client-only visual settings remain local, while gameplay-affecting settings are synchronized from server state in multiplayer. In short: your outline colors are your business, server gameplay rules are the server's business. ## Installation ### Fabric 1. Install a supported Minecraft version and Fabric Loader. 2. Install Fabric API for the same game version. 3. Download the MinersAdvantage Fabric jar for your target version. 4. Place the jar in your `mods` folde