MinersAdvantage

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 folder.
5. Launch the game.

NeoForge

1. Install a supported Minecraft version and NeoForge.
2. Download the MinersAdvantage NeoForge jar for your target version.
3. Place the jar in your mods folder.
4. Launch the game.

Multiplayer Note

For feature parity and consistent behavior, install MinersAdvantage on both client and server.

Configuration

MinersAdvantage stores configuration as TOML in split roots:

• Client file: minersadvantage-client-config.toml
• Server gameplay file: minersadvantage-server-config.toml

Client options stay local. Gameplay options are server-authoritative in multiplayer.

Client Config (minersadvantage-client-config.toml)

Option Type Default Description disable_particle_effects boolean false Disables feature particle effects when true. outline_foreground_color_argb color 0xFF40D9C0 ARGB color used for foreground outlines. outline_see_through_color_argb color 0x4B40D9C0 ARGB color used for see-through outlines.

Common Gameplay (minersadvantage-server-config.toml)

Option Type Default Range Description common.tps_guard boolean true - Reduces aggressive behavior under low TPS conditions. common.gather_drops boolean false - Enables drop gathering helpers where applicable. common.auto_illuminate boolean true - Allows compatible features to trigger Illumination behavior. common.mine_veins boolean true - Allows compatible features to trigger Veination behavior. common.blocks_per_tick int 1 1 to 1024 Shared per-tick processing budget baseline. common.enable_tick_delay boolean true - Enables tick-delay pacing. common.tick_delay int 5 0 to 200 Delay between processing cycles when enabled. common.block_radius int 3 1 to 128 Shared search radius for relevant feature operations. common.block_limit int 64 1 to 8192 Shared cap for blocks processed in one operation.

Captivation (minersadvantage-server-config.toml)

Option Type Default Range Description captivation.enabled boolean true - Enables or disables Captivation. captivation.allow_in_gui boolean false - Allows capture behavior while GUI screens are open. captivation.radius_horizontal int 16 1 to 128 Horizontal pickup radius. captivation.radius_vertical int 16 1 to 128 Vertical pickup radius. captivation.is_whitelist boolean false - Treats blacklist as a whitelist when true. captivation.unconditional_blacklist boolean false - Always excludes listed entries, even under whitelist logic. captivation.blacklist list ["minecraft:rotten_flesh", "minecraft:egg"] - Item IDs used for whitelist/blacklist filtering.

Cropination (minersadvantage-server-config.toml)

Option Type Default Description cropination.enabled boolean true Enables or disables Cropination. cropination.harvest_seeds boolean true Drops seeds during auto-harvest when true.

Cultivation (minersadvantage-server-config.toml)

Option Type Default Range Description cultivation.enabled boolean true - Enables or disables Cultivation. cultivation.hydration_distance int 4 1 to 16 Water-distance check used by hydration logic.

Excavation (minersadvantage-server-config.toml)

Option Type Default Range Description excavation.enabled boolean true - Enables or disables Excavation. excavation.width int 3 1 to 127 Excavation width. excavation.height int 3 1 to 127 Excavation height. excavation.depth int 3 1 to 64 Excavation depth. excavation.processes_per_tick int 10 1 to 512 Processing throughput per tick. excavation.toggle_mode boolean false - Uses toggle behavior instead of hold behavior when true. excavation.ignore_block_variants boolean false - Treats block variants as equivalent for match logic. excavation.is_block_whitelist boolean false - Treats block_blacklist as a whitelist when true. excavation.block_blacklist list [] - Block IDs used for blacklist/whitelist filtering.

Pathanation (minersadvantage-server-config.toml)

Option Type Default Range Description pathanation.enabled boolean true - Enables or disables Pathanation. pathanation.path_length int 6 1 to 64 Length of generated path segments. pathanation.path_width int 3 1 to 9 Width of generated path segments.

Illumination (minersadvantage-server-config.toml)

Option Type Default Range Description illumination.enabled boolean true - Enables or disables Illumination. illumination.radius_horizontal int 8 1 to 64 Horizontal search radius for placement checks. illumination.radius_vertical int 4 1 to 64 Vertical search radius for placement checks. illumination.lowest_light_level int 1 0 to 15 Placement threshold for low-light detection. illumination.use_block_light boolean true - Uses block-light evaluation path when true.

Lumbination (minersadvantage-server-config.toml)

Option Type Default Range Description lumbination.enabled boolean true - Enables or disables Lumbination. lumbination.max_trunk_range int 32 1 to 128 Maximum trunk search range. lumbination.max_leaf_range int 6 1 to 32 Maximum leaf search range. lumbination.processes_per_tick int 8 1 to 512 Processing throughput per tick. lumbination.chop_tree_below boolean true - Continues chopping blocks below starting point when true. lumbination.destroy_leaves boolean true - Removes leaves during tree processing when true. lumbination.leaves_affect_durability boolean false - Applies tool durability costs for leaves when true. lumbination.replant_saplings boolean true - Attempts sapling replanting where possible. lumbination.use_canopy_tool boolean true - Uses canopy detection/handling logic for broader tree shapes. lumbination.ignore_player_placed_leaves boolean true - Ignores player-placed leaves when identifying natural trees. lumbination.logs list [] - Additional trunk/log block IDs. lumbination.leaves list [] - Additional leaf block IDs. lumbination.axes list [] - Allowed tools list for lumbination behavior.

Shaftanation (minersadvantage-server-config.toml)

Option Type Default Range Description shaftanation.enabled boolean true - Enables or disables Shaftanation. shaftanation.depth int 16 1 to 256 Shaft length/depth. shaftanation.processes_per_tick int 10 1 to 512 Processing throughput per tick. shaftanation.width int 1 1 to 7 Shaft width. shaftanation.height int 2 1 to 5 Shaft height. shaftanation.torch_placement enum FLOOR enum value Torch placement mode (FLOOR and other enum values).

Substitution (minersadvantage-server-config.toml)

Option Type Default Description substitution.enabled boolean true Enables or disables Substitution. substitution.allow_mending boolean false Allows mending tools in candidate selection when true. substitution.prioritize_silk_touch boolean false Prioritizes silk-touch style outcomes when true. substitution.switch_back boolean true Switches back to previous slot after action when true. substitution.favour_fortune boolean true Prefers fortune outcomes where appropriate. substitution.ignore_if_valid_tool boolean true Skips substitution if currently held tool is already valid. substitution.ignore_passive_mobs boolean true Prevents passive-mob attack swapping behavior when true. substitution.blacklist list [] Item IDs excluded from substitution consideration.

Veination (minersadvantage-server-config.toml)

Option Type Default Range Description veination.enabled boolean true - Enables or disables Veination. veination.max_vein_distance int 12 1 to 64 Maximum connected vein distance. veination.ores list [] - Explicit ore block allowlist/targets. veination.ore_harvest_without_sneak boolean true - Allows ore harvesting without sneak requirement. veination.drop_ores_at_first_block boolean true - Drops output near the first broken ore block. veination.increase_harvest_time_per_ore boolean true - Scales mining time with vein size when true. veination.harvest_time_modifier double 0.2 0.01 to 10.0 Modifier applied to scaled harvest time. veination.pickaxe_blacklist list [] - Disallowed pickaxes for veination behavior.

Ventilation (minersadvantage-server-config.toml)

Option Type Default Range Description ventilation.enabled boolean true - Enables or disables Ventilation. ventilation.width int 1 1 to 32 Vent width. ventilation.height int 16 1 to 64 Vent height envelope. ventilation.depth int 1 1 to 64 Vent depth/length. ventilation.processes_per_tick int 8 1 to 512 Processing throughput per tick. ventilation.place_ladders boolean true - Places ladders during vent carving when enabled.

Advanced Substitution Rule Profile (Runtime Data)

Substitution includes an advanced selectionRules profile in runtime config defaults. It is action-aware and expression-aware, and each rule can include the fields below.

Field Type Description action enum BREAK, INTERACT, ATTACK, STAT_CHANGE, or ANY. targetKind enum BLOCK_TAG, ENTITY_TYPE, or ANY. targetId string Tag/entity identifier for the selected target kind. requiredToolKind string Tool family hint (for example pickaxe, axe, shovel, hoe). targetPriority int Priority for choosing among target matches. toolPriority int Priority for choosing among tool candidates. preferSilkTouch boolean Prefer silk-touch style outcomes for the rule. preferFortune boolean Prefer fortune style outcomes for the rule. targetExpression string Optional target expression with AND/OR/NOT and parentheses. toolExpression string Optional tool expression with AND/OR/NOT and parentheses. minSilkTouch int Minimum Silk Touch level required. minFortune int Minimum Fortune level required. requireMending boolean Requires mending on selected tool when true. denyMending boolean Denies mending tools when true (requireMending wins if both are true).

Compatibility

Topic Status Minecraft versions 1.21.11 and 26.1.2 nodes are maintained. Loaders Fabric and NeoForge are both first-class targets. Known conflicts No hard conflicts are currently documented. If you find one, open an issue.

Technical Documentation

For full technical details, see TECHNICAL.md.

License

MIT - see LICENSE.md for the full text.

Credits

• DuelMonster for the original mod and modern rewrite.
• Stonecutter, Modstitch, Fabric, NeoForge, Cloth Config, and ModMenu maintainers.