Grappling Hook Mod Wiki

The Grappling Hook Mod is a physics-focused utility mod designed to revolutionize movement within Minecraft. Unlike simple teleportation or 'pull-to-point' mechanics, this mod implements a realistic physics engine that allows players to swing, maintain momentum, and scale massive structures with fluid motion. It is particularly effective in urban maps, mountainous biomes, and large-scale builds where traditional traversal is slow.

Key features include multiple hook variants (Motorized, Magnetic, Ender), a deep customization system via the Modifier block, and specialized equipment like Long Fall Boots to mitigate the risks of high-speed traversal.

The mod features several tiers of grappling hooks, each with unique properties. Since version V11, many of these functions can be merged into a single 'Custom Grappling Hook' using the Modifier system.

Standard Grappling Hook

The base tool for all traversal. It allows for classic swinging and manual climbing.

• Behavior: Attaches to any solid block. Conserves momentum for swinging.
• Climbing: Hold Shift + W to pull yourself up the rope or Shift + S to rappel down.

Motorized Grappling Hook

Equipped with a mechanical winch to provide vertical and horizontal thrust.

• Behavior: Automatically pulls the player toward the hook point upon attachment.
• Usage: Ideal for rapid vertical ascent and maintaining speed across flat terrain.

Magnetic Grappling Hook

Designed for advanced maneuverability, allowing the player to 'stick' and repel with magnetic force.

• Behavior: Can repel the player from surfaces to maintain a specific distance, effectively allowing for 'Spider-Man' style swinging where the player never hits the ground.

Ender Staff & Ender Hook

Utilizes ender pearl technology for instantaneous or high-velocity movement.

• Ender Staff: Launches the player in the direction they are facing when right-clicked. Does not use a rope.
• Ender Grappling Hook: Combines the staff's propulsion with a hook. Left-clicking while hooked provides a massive speed boost.

High-speed grappling often leads to dangerous falls. The mod provides specialized gear to ensure survival.

Grappling Hook Modifier

The central hub for mod progression. This block is used to install upgrades and change the physical parameters of your hooks.

• Function: Right-click to open the GUI. You must 'feed' the block specific Upgrade items to unlock their corresponding configuration options.
• Customization: Once an upgrade is unlocked, you can adjust rope length, pull speed, swing friction, and more.

Grapple Anchor

A specialized block that provides a guaranteed attachment point for grappling hooks. Useful for creating parkour courses or designated 'fast travel' lanes in bases.

Mastering the mod requires understanding the physics-based control scheme.

• Firing: Right-click to throw the hook. The hook follows a projectile arc.
• Releasing: Right-click again to detach. Alternatively, press Space to release and perform a 'jump' boost using your current momentum.
• Swinging: Use W/A/S/D while in mid-air to influence your swing direction.
• Climbing/Rappelling: Hold Shift + W to retract the rope (climb up) or Shift + S to extend the rope (descend).
• Rocket Boost: If the 'Rocket' upgrade is installed, Left-click while grappling to activate a forward thruster (uses fuel that regenerates over time).

Parkour Abilities

In newer versions (1.16.5+), the mod adds innate movement abilities that can be toggled or enchanted:

• Wall-running: Sprint toward a wall at an angle to run along its surface.
• Sliding: Press the crouch key while sprinting to perform a low-profile slide, maintaining momentum.
• Double Jump: Press jump again while in the air.

Most items require a mix of vanilla materials and mod-specific 'Upgrades'.

Note: To apply an upgrade, right-click the Grappling Hook Modifier block with the upgrade item in hand to unlock that category permanently for that block.

The mod introduces several enchantments for boots to enhance the parkour experience:

• Wallrunning: Allows the wearer to run along vertical surfaces. Higher levels increase duration.
• Sliding: Increases the distance and speed of the slide mechanic.
• Double Jump: Grants additional mid-air jumps. Each level adds one extra jump.
• Long Fall: A specialized version of Feather Falling that can be upgraded into the Long Fall Boots effect.

The mod is highly configurable via the grapplinghook.cfg file or the Cloth Config API menu. Key parameters include:

• Max Rope Length: Default is 30 blocks, but can be increased to 999,999 for 'infinite' range.
• Swing Speed: Adjusts how much influence WASD keys have on momentum.
• Fall Damage: Can be toggled globally or set to be mitigated only when using specific hooks.
• Rocket Fuel: Adjusts the capacity and regeneration rate of the rocket upgrade.
• Phasing: Allows the rope to pass through blocks (useful for preventing the rope from getting 'stuck' on corners).