Holesnap

​

Overview

​

Core Concept

• End crystal explosions
• TNT damage
• Most ranged attacks

​

Key Features

​

Intelligent Hole Detection

• Scans for holes within configurable range (1-6 blocks)
• Supports both single holes and double holes
• Distinguishes between obsidian and bedrock holes
• Validates hole safety (checks for air blocks inside)

​

Visual Feedback

• Colored line from player to target hole
• Customizable gradient colors (left/right)
• Distance display in HUD
• Clear indication of target position

​

Movement Modes

• Direct pathfinding to hole center
• Physics-based movement
• Step height handling
• Collision detection

• Advanced pathfinding algorithm
• Navigates around obstacles
• Better for complex terrain

​

Configuration

​

Basic Settings

• Range to search for holes
• Range: 1-6 blocks
• Default: 3
• Higher range = more options but slower detection

• Movement calculation mode
• Options: Normal, Pathfinding
• Default: Normal
• Normal is faster, Pathfinding is smarter

• Allow targeting 2x1 holes
• Default: false
• Useful for more hole options but less safe

• Allow swapping to holes even if you’re already in one
• Default: false
• Enable for repositioning between holes

​

Speed Optimization

• Use speed boost for faster hole snapping
• Default: false
• Faster but more detectable

• Modify game tick rate during snap
• Default: false
• Dramatically increases speed

• Tick speed multiplier when Use TickSpeed enabled
• Range: 1-10
• Default: 5
• Higher = faster but more detectable

• Ticks to apply timer boost
• Range: 10-100
• Default: 25
• Controls how long the speed boost lasts

​

Advanced Options

• Run multiple physics ticks on enable
• Default: false
• Simulates movement for instant positioning

• Number of physics ticks to run
• Range: 3-20
• Default: 3
• More ticks = further instant movement

• Apply timer after reaching hole
• Default: false
• Helps with centering in hole

​

Step Configuration

• How to handle height differences
• Options: Vanilla, NCP, NONE
• Default: Vanilla

• Vanilla: Uses standard step height increase
• NCP: NoCheatPlus bypass technique
• NONE: No step assistance (may fail on uneven terrain)

​

Visual Customization

• Starting color of the visual line
• Default: RGB(255, 0, 255, 255) - Magenta

• Ending color of the visual line
• Default: RGB(0, 255, 0) - Green

​

Movement Mechanics

​

Target Calculation

targetPos = (hole.X + 0.5, player.Y, hole.Z + 0.5)

• If toTarget exists: centers on that specific block
• Otherwise: calculates center point between both blocks

centerX = (pos1.X + 0.5 + pos2.X + 0.5) / 2
centerZ = (pos1.Z + 0.5 + pos2.Z + 0.5) / 2

​

Speed Calculation

1. Distance to target
2. Ground state (on ground vs airborne)
3. Boost setting

• With Boost: min(PlayerUtils.getDefaultBaseSpeed(true), dist/2)
• Without Boost: min(0.2805, dist/2)

• Uses PlayerUtils.getDefaultBaseSpeed(false)

​

Direction Calculation

double yawRad = Math.toRadians(getRotationTo(playerPos, targetPos).x);
motionX = -Math.sin(yawRad) * speed;
motionZ = Math.cos(yawRad) * speed;

​

Auto-Disable Conditions

1. No hole found on enable
   • Displays: “Unable to find hole. Disabling”
2. Successfully entered hole
   • Displays: “Snapped into hole, disabling.”
   • Centers player position
3. Target hole destroyed
   • Displays: “Hole no longer exists, disabling.”
   • Happens if blocks are broken during movement
4. Server disconnect
   • Prevents errors on world change

​

Integration & Compatibility

​

NoAccel Integration

• Sets NoAccel.paused = true during movement
• Restores NoAccel.paused = false when complete
• Prevents movement conflicts

​

Step Integration

• Sets step height when collision detected
• Resets to 0.6 when clear path
• Uses Step module’s configured height

​

Timer Management

• Stores original tick length on enable
• Applies custom timer during movement
• Restores original value on disable
• Handles post-timer timing separately

​

Usage Guide

​

Basic Usage

1. Bind Holesnap to a key (e.g., H)
2. During combat, press the key when you need safety
3. Module finds nearest hole and moves you there
4. Automatically disables when safe

​

Competitive PvP Setup

Range: 3
Mode: Normal
Boost: true
Use TickSpeed: false
Doubles: false
Swapping: false
Physics: false
Step Mode: Vanilla

​

Aggressive Setup (Risky)

Range: 4
Mode: Normal
Boost: true
Use TickSpeed: true
Tick Amount: 5
Boost Time: 25
Doubles: true
Swapping: true
Physics: true
Physics Ticks: 5
Step Mode: NCP

​

Conservative Setup

Range: 2
Mode: Pathfinding
Boost: false
Use TickSpeed: false
Doubles: false
Swapping: false
Physics: false
Step Mode: Vanilla

​

Advanced Techniques

​

Pre-Emptive Snapping

• Before engaging in combat
• When taking damage
• When opponent pulls out crystals
• When low on health

​

Hole Swapping

• Can reposition between holes during fight
• Useful for avoiding trapped holes
• Enables tactical repositioning
• Keep Range low (2-3) for predictable swaps

​

Timer Control

• Enable Use TickSpeed
• Set Tick Amount to 2-3 (not 5+)
• Set Boost Time to 15-20
• Disable immediately after reaching hole

​

Troubleshooting

• Increase Range setting
• Enable Doubles to consider 2x1 holes
• Verify you’re not already in a hole (enable Swapping if you are)
• Check surrounding area has valid holes

• Enable Boost option
• Enable Use TickSpeed (if server allows)
• Increase Tick Amount
• Check if NoAccel is interfering

• Change Step Mode to Vanilla or NCP
• Enable Physics with 3-5 ticks
• Increase Range to find clearer path
• Try Pathfinding mode

• May be stuck in “almost there” state
• Manually disable and re-enable
• Check Post Timer setting (try toggling)
• Verify hole is still valid (not griefed)

• Check colors are not set to transparent
• Ensure render distance is sufficient
• Verify target hole is within range
• Check if HUD is disabled

​

Technical Details

​

Hole Validation

• isObbyHole() - Checks for obsidian surround
• isBedrockHoles() - Checks for bedrock surround
• isDoubleHoleFr() - Validates double holes

​

State Tracking

• boostTime - Tracks packets sent for timer duration
• stuckTicks - Counts ticks stuck on collision
• posttimerticks - Timer ticks after reaching hole
• startPos - Original position when enabled
• lastTarget - Current target position
• targetHole - Current target hole data structure

​

Movement State

• true when moving to hole
• false when disabled or idle
• Other modules can check Holesnap.INSTANCE.cancel

​

Best Practices

​

Why It’s a Signature Feature

• Understanding PvP hole meta
• Real-time pathfinding and movement
• Visual feedback and user experience
• Integration with multiple client systems
• Balancing speed with anti-cheat evasion