🎣 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 so you stay in control.
Heavily modified fork of the original GrapplingHook by SnowGears [65000+ Downloads]
✨ 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
- ⏱️ Optional use-limit per hook with configurable destroy/repair behavior
- 👑 Admin-friendly commands and instant reload support
- 💬 Fully customizable messages - disable any by setting to ""
- 🚀 Lightweight and optimized - performance focused
⌨️ Commands
All commands support:
/aerograpple,/grapplinghook, or/gh
| Command | Description |
|---|---|
/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:
📋 Settings
max_uses- Uses before breaking (-1 = unlimited)cooldown_seconds- Delay between usesrepair_cost- Vault cost to repair (requires Vault plugin)throwing_speed/pulling_speed- Physics customization (x/y/z multipliers)
✨ Special Features
prevent_fall_damage- No fall damage when using this hookslow_falling- Fall slowly while hook is active above yousticky_landing- Hook sticks to surfaces longer
🎨 Filters & Appearance
Filters:
allowed_blocks- Control which blocks hook attaches to (ALLOW_ONLY / BLOCK_ONLY)allowed_entities- Control which entities can be hooked
Appearance:
- Custom names with color codes
- Lore with
[uses]placeholder - Texture IDs for resource packs
🔐 Permissions
Basic Permissions
aerograpple.pull.self- Pull yourself to locationsaerograpple.pull.mobs- Pull mobsaerograpple.pull.players- Pull playersaerograpple.pull.items- Pull items
Special Permissions
aerograpple.player.nopull- Cannot be pulled by othersaerograpple.player.nocooldown- Bypass cooldowns
Admin Permissions
aerograpple.operator- Use commandsaerograpple.repair- Repair own hooksaerograpple.repairall- Repair all own hooksaerograpple.repairothers- Repair other players' hooks
📥 Installation
- 📦 Download the latest version from the Versions tab
- 📂 Drop the jar into your server's
plugins/folder - 💰 (Optional) Install Vault for economy repair costs
- 🔄 Start/restart your server to generate configuration files
- 🔑 Grant permissions to groups/players as needed
- ✏️ Customize hooks and messages in
hooks.ymlandconfig.yml - ⚡ Use
/aerograpple reloadto apply changes without restart
🔧 Compatibility
| Feature | Details |
|---|---|
| API Version | 1.17+ |
| Minecraft Versions | 1.17 - 1.21.4+ |
| Platforms | Spigot, Paper, Purpur |
| Soft Dependencies | Vault (optional, for economy) |
🔗 Links & Support
- 📘 GitHub Repository
- 🐛 Report Issues
- 💬 Spigot Page (Original)
Give your players a movement tool that's fun, fair, and feels great to use. 🎣
Made with ❤️ by m-suro
