AeroGrapple

AeroGrapple
A clean, modern, and lightweight grappling hook plugin

Swing across gaps, scale cliffs, reel in mobs, nudge players, or snag items
with sensible defaults and fine-grained permissions

✨ Highlights

• Smooth, intuitive movement using a fishing hook as the grapple
• Multiple hook types with unique abilities - slow falling, sticky landing, fall damage prevention
• Customizable physics - adjust throwing and pulling speeds independently
• Hook repair system with optional Vault economy costs
• Auto-update checker - get notified of new versions in-game
• Fully customizable messages - disable any by setting to ""
• Lightweight and optimized - performance focused

⌨️ Commands

All commands support: /aerograpple, /grapplinghook, or /gh

/aerograpple reload
→ Reload plugin configuration

/aerograpple give <hook_id> [player]
→ Give a grappling hook

/aerograpple repair [player]
→ Repair held grappling hook

/aerograpple repairall [player]
→ Repair all hooks in inventory

Required Permissions: aerograpple.operator, aerograpple.repair, aerograpple.repairall, aerograpple.repairothers

⚙️ Hook Configuration

Each hook in hooks.yml is fully customizable:

Basic Settings:

• max_uses - Uses before breaking (-1 = unlimited)
• cooldown_seconds - Delay between uses
• repair_cost - Vault cost to repair (requires Vault plugin)
• throwing_speed / pulling_speed - Physics customization (x/y/z multipliers)

Special Abilities:

• prevent_fall_damage - No fall damage when using this hook
• slow_falling - Fall slowly while hook is active above you
• sticky_landing - Hook sticks to surfaces longer

Filters & Appearance:

• allowed_blocks - Control which blocks hook attaches to (ALLOW_ONLY / BLOCK_ONLY)
• allowed_entities - Control which entities can be hooked
• Custom names, lore with [uses] placeholder, and texture IDs for resource packs

Permissions

Basic Permissions:

• aerograpple.pull.self - Pull yourself to locations
• aerograpple.pull.mobs - Pull mobs
• aerograpple.pull.players - Pull players
• aerograpple.pull.items - Pull items

Special Permissions:

• aerograpple.player.nopull - Cannot be pulled by others
• aerograpple.player.nocooldown - Bypass cooldowns

Admin Permissions:

• aerograpple.operator - Use commands
• aerograpple.repair - Repair own hooks
• aerograpple.repairall - Repair all own hooks
• aerograpple.repairothers - Repair other players' hooks

Installation

1. Download the latest version from the Versions tab
2. Drop the jar into your server's plugins/ folder
3. (Optional) Install Vault for economy repair costs
4. Start/restart your server to generate configuration files
5. Grant permissions to groups/players as needed
6. Customize hooks and messages in hooks.yml and config.yml
7. Use /aerograpple reload to apply changes without restart

Compatibility

API Version: 1.17+
Minecraft Versions: 1.17 - 1.21.4+
Platforms: Spigot, Paper, Purpur
Soft Dependencies: Vault (optional, for economy)

Heavily modified fork of the original GrapplingHook by SnowGears [65000+ Downloads]
Original plugin: https://www.spigotmc.org/resources/grappling-hook.22854/

Give your players a movement tool that's fun, fair, and feels great to use. [/CENTER]