SpeedMine

Overview

SpeedMine (implemented as Nuker) allows you to break blocks much faster than normal mining. It features multiple modes for different scenarios: mass block breaking, terrain flattening, selective mining, farming, and even a special pearl mode for end portal frames.

Features

Five mining modes for different purposes
Automatic rotation towards blocks
Configurable range (1-6 blocks)
Automatic closest block selection
Strict mode for anti-cheat compatibility
Special pearl mode for item frame attacks
Works with AutoTool for automatic tool selection

Settings

Mode

enum

default:"All"

Mining behavior mode

All: Breaks any mineable block within range
Flatten: Only breaks blocks at or above your Y level (creates flat surface)
Selective: Only breaks shulker boxes
Farm: Only breaks fully grown crops
Pearl: Attacks item frames (for pearl teleportation)

Range

number

default:"5.0"

Maximum mining distance in blocks (1.0-6.0)Higher range is more efficient but more detectable

Rotate

boolean

default:"true"

Automatically rotates your head towards the block being minedRecommended for anti-cheat compatibility

Strict

boolean

default:"true"

Only mines blocks you can directly see (no mining through walls)More anti-cheat safe but may miss some blocks

Predict

boolean

default:"true"

(Pearl mode only) Predicts and breaks item frames before they fully spawn

How It Works

Block Scanning

Scans all blocks within range to find valid mining targets:

// Located at: player/Nuker.java:154-183
for (float x = range; x >= -range; x--) {
    for (float y = range; y >= (mode.equals("Flatten") ? 0 : -range); y--) {
        for (float z = range; z >= -range; z--) {
            BlockPos pos = mc.player.getBlockPos().add(x, y, z);
            double distance = mc.player.squaredDistanceTo(pos.toCenterPos());
            
            if (canMine(pos) && distance < bestDistance) {
                bestDistance = distance;
                nukerBlock = pos;
            }
        }
    }
}

Mode Filtering

Applies mode-specific filters to determine if block should be mined

Rotation (Optional)

If enabled, rotates towards the selected block

Mining

Continuously attacks the block until broken:

Direction side = BlockUtils.getMineableSide(current, strict.getValue());
mc.interactionManager.updateBlockBreakingProgress(current, side);
mc.player.swingHand(Hand.MAIN_HAND);

Mining Modes

All Mode
Flatten Mode
Selective Mode
Farm Mode
Pearl Mode

Universal Mining

Breaks any mineable block within range:Use Cases:

Clearing areas quickly
Breaking through barriers in PvP
General resource gathering
Mining tunnels

Behavior:

Scans full sphere around player (range)
Selects closest valid block
Breaks continuously
Moves to next block automatically

Best Settings:

Mode: All
Range: 5.0
Rotate: true
Strict: true

Terrain Flattening

Only breaks blocks at or above your feet level:

// Located at: player/Nuker.java:162
for (float y = range; y >= (mode.getValue().equals("Flatten") ? 0 : -range); y--)

Use Cases:

Creating flat platforms
Clearing surface terrain
Building site preparation
Removing trees/structures

Behavior:

Only scans Y >= player’s Y level
Never digs below you
Creates level surface

Example:

Before:      After:
  █ █          
 ███         ─────  (flat surface)
█████   →     P
  █          ███
  █          ███

Shulker Box Mining

Only breaks shulker boxes:

// Located at: player/Nuker.java:192-211
if (mode.getValue().equals("Selective")) {
    if (state.getBlock() instanceof ShulkerBoxBlock) {
        // Valid target
    } else {
        return false;  // Skip non-shulker blocks
    }
}

Use Cases:

Griefing enemy shulker stashes
Breaking opponent’s storage in PvP
Selective base breaking

Features:

Tracks placed shulkers to avoid breaking your own
Monitors block updates
Blacklist system

Best Paired With:

AutoTool (pickaxe for obsidian-surrounded shulkers)
ESP to see shulker boxes through walls

Automatic Farming

Only breaks fully grown crops:

// Located at: player/Nuker.java:192-201
if (mode.getValue().equals("Farm")) {
    if (state.getBlock() instanceof CropBlock crop) {
        int age = crop.getAge(state);
        if (age != crop.getMaxAge()) return false;  // Skip immature crops
    } else {
        return false;  // Skip non-crop blocks
    }
}

Compatible Crops:

Wheat
Carrots
Potatoes
Beetroot
Nether wart

Use Cases:

Automated crop harvesting
Large farm management
Quick harvest before replanting

Best Settings:

Mode: Farm
Range: 6.0  (max range for large farms)
Rotate: false  (not needed for crops)
Strict: false  (can break through crops)

Item Frame Breaker

Attacks item frames for pearl teleportation:

// Located at: player/Nuker.java:108-126
for (Entity entity : mc.world.getOtherEntities(null, mc.player.getBoundingBox())) {
    if (entity instanceof ItemFrameEntity) {
        // Break held item first if present
        if (!((ItemFrameEntity) entity).getHeldItemStack().isEmpty()) {
            PacketManager.INSTANCE.sendPacket(
                PlayerInteractEntityC2SPacket.attack(entity, mc.player.isSneaking()));
            PacketManager.INSTANCE.sendPacket(new HandSwingC2SPacket(Hand.MAIN_HAND));
        }
        // Break frame itself
        PacketManager.INSTANCE.sendPacket(
            PlayerInteractEntityC2SPacket.attack(entity, mc.player.isSneaking()));
        PacketManager.INSTANCE.sendPacket(new HandSwingC2SPacket(Hand.MAIN_HAND));
    }
}

Pearl Teleportation:

Throw ender pearl
Place item frame at destination
Enable Pearl mode
Pearl teleports when frame breaks

Predict Setting: When enabled, breaks frames as they spawn:

@SubscribeEvent
public void onEntityAdd(EntityEvent.Add event) {
    if (event.getEntity() instanceof ItemFrameEntity entity) {
        if (new Box(mc.player.getBlockPos()).expand(0, 0.2, 0)
            .intersects(entity.getBoundingBox())) {
            // Immediately break the frame
        }
    }
}

Block Filtering

SpeedMine validates blocks before mining:

// Located at: player/Nuker.java:185-215
public boolean canMine(BlockPos pos) {
    BlockState state = mc.world.getBlockState(pos);
    double distance = mc.player.squaredDistanceTo(pos.toCenterPos());
    
    // Mode-specific checks (Farm, Selective, etc.)
    // ...
    
    return !state.isAir() 
        && !(state.getBlock() instanceof FluidBlock)
        && !(distance > MathUtil.square(breakRange.getValue().floatValue()))
        && BlockUtils.isMineable(state);
}

Invalid Blocks

Air blocks
Fluids (water, lava)
Out of range blocks
Unmineable blocks (bedrock, barriers)
Mode-specific exclusions

HUD Info

Shows current mining mode:

@Override
public String getHudInfo() {
    return mode.getValue();  // "All", "Flatten", etc.
}

Configuration Presets

Mode: All
Range: 5.0
Rotate: true
Strict: false

→ Breaks everything nearby
→ Maximum efficiency
→ Good for vanilla servers

Advanced Techniques

Closest Block Algorithm

SpeedMine always mines the closest valid block:

double bestDistance = 9999;
for (each block in range) {
    double distance = mc.player.squaredDistanceTo(pos.toCenterPos());
    if (distance >= bestDistance) continue;
    if (canMine(pos)) {
        bestDistance = distance;
        nukerBlock = pos;
    }
}

This ensures:

Efficient mining pattern (inside-out)
No wasted movement
Continuous operation

Strict Mode

Strict mode ensures you can see the block’s side:

Direction side = BlockUtils.getMineableSide(current, strict.getValue());
if (side == null) return;  // Can't see any side

Why Use Strict:

Prevents X-ray-like behavior
More natural mining pattern
Less likely to trigger anti-cheat

When to Disable:

Vanilla servers
Farm mode (crops block each other)
Maximum efficiency needed

Shulker Blacklist System

Selective mode tracks your own shulker placements:

@SubscribeEvent
public void onPacketSend(PacketEvent.Send event) {
    if (event.getPacket() instanceof PlayerInteractBlockC2SPacket packet) {
        if (BlockUtils.SHULKER_BLOCKS.contains(
            mc.player.getStackInHand(packet.getHand()).getItem())) {
            shulkerBlackList.add(packet.getBlockHitResult().getBlockPos()
                .offset(packet.getBlockHitResult().getSide()));
        }
    }
}

This prevents breaking your own shulkers while breaking others’

Usage Examples

Set Mode to "All"
Set Range to 5.0
Stand in center of area
Enable SpeedMine
Blocks break in expanding sphere
AutoTool switches tools automatically

Best Practices

Use AutoTool

Enable AutoTool for automatic tool selection when breaking different block types

Adjust Range

Lower range (3-4) is safer for anti-cheat, higher (5-6) is more efficient

Enable Rotate

Always enable Rotate on servers with anti-cheat for more natural appearance

Use Strict Mode

Enable Strict on strict servers to avoid X-ray detection

Performance Tips

Optimize Range

Range 3-4: Fastest scanning, good for dense areas
Range 5: Balanced performance and coverage
Range 6: Slower scanning but max coverage

Higher range requires more block checks per tick

Disable Unnecessary Features

Disable Rotate if not needed (vanilla servers)
Disable Strict for maximum speed (farm mode)
Use specific modes instead of All when possible

Compatibility

Compatible Modules
Anti-Cheat

AutoTool - Automatically selects best tool

FastBreak - Breaks blocks even faster

NoBreakDelay - Removes break delay

Reach - Mine from further away

Safe Configuration:

Range: 4.5 or lower
Rotate: true
Strict: true

Detection Risk:

Range > 5: High risk
Rotate disabled: Medium risk
Strict disabled: Medium risk
Very fast breaking: High risk

Mining with large range and disabled rotation/strict mode will likely trigger anti-cheat on most servers. Start conservative and adjust.

Troubleshooting

Not Mining Any Blocks

Check:

Range is high enough to reach blocks
Mode matches block type (e.g., Farm mode only breaks crops)
Blocks are actually mineable (not bedrock/barriers)
You have a tool to break them (use AutoTool)

Mining Too Slow

Solutions:

Disable Rotate for slightly faster operation
Decrease Range to reduce scan time
Enable FastBreak module
Use efficiency enchanted tools
Check server TPS (lag affects break speed)

Getting Kicked by Anti-Cheat

Reduce detection:

Lower Range to 4.0 or less
Enable Rotate
Enable Strict
Add delay between breaks (use other modules)

Farm Mode Not Working

Verify:

Crops are actually fully grown
You’re breaking vanilla crops (not modded)
Range includes the crops
Mode is set to “Farm” not “All”

Selective Mode Breaking Own Shulkers

The blacklist system should prevent this, but if it happens:

Disable and re-enable the module
Place your shulkers with the module enabled
Check if you’re using the correct hand for placement

AutoTool: Automatically switches to the best tool for each block type
FastBreak: Further speeds up block breaking
NoBreakDelay: Removes the break animation delay
Reach: Extend mining range beyond 6 blocks
Scaffold: Builds while Nuker breaks

Combat

Movement

Render

Misc

Player

Overview

Features

Settings

How It Works

Mining Modes

Universal Mining

Terrain Flattening

Shulker Box Mining

Automatic Farming

Item Frame Breaker

Block Filtering

Invalid Blocks

HUD Info

Configuration Presets

Advanced Techniques

Usage Examples

Best Practices

Use AutoTool

Adjust Range

Enable Rotate

Use Strict Mode

Performance Tips

Compatibility

Troubleshooting

Build docs developers (and LLMs) love

Combat

Movement

Render

Misc

Player

​Overview

​Features

​Settings

​How It Works

​Mining Modes

​Universal Mining

​Terrain Flattening

​Shulker Box Mining

​Automatic Farming

​Item Frame Breaker

​Block Filtering

​Invalid Blocks

​HUD Info

​Configuration Presets

​Advanced Techniques

​Usage Examples

​Best Practices

Use AutoTool

Adjust Range

Enable Rotate

Use Strict Mode

​Performance Tips

​Compatibility

​Troubleshooting

​Related Modules

Build docs developers (and LLMs) love

Overview

Features

Settings

How It Works

Mining Modes

Universal Mining

Terrain Flattening

Shulker Box Mining

Automatic Farming

Item Frame Breaker

Block Filtering

Invalid Blocks

HUD Info

Configuration Presets

Advanced Techniques

Usage Examples

Best Practices

Performance Tips

Compatibility

Troubleshooting

Related Modules