AeroGrapple
A clean, modern, and lightweight grappling hook plugin that feels great to use.
415
Quick challenge
How far can you run before the mobs catch you?
Minecraft check
Confirm your run
Complete the quick check to get your code.
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 so you stay in control.
---
Heavily modified fork of the original GrapplingHook by SnowGears [65000+ Downloads]
---
✨ Highlights
- 🪝 Lightweight and optimized using a fishing hook as the grapple - 🎯 Lightweight and optimized with unique abilities - slow falling, sticky landing, fall damage prevention - ⚡ Lightweight and optimized - adjust throwing and pulling speeds independently - 🔧 Lightweight and optimized with optional Vault economy costs - 🔔 Lightweight and optimized - get notified of new versions in-game - ⏱️ Lightweight and optimized with configurable destroy/repair behavior - 👑 Lightweight and optimized and instant reload support - 💬 Lightweight and optimized - 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 uses - `repair_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 hook - `slow_falling` - Fall slowly while hook is active above you - `sticky_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 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 Versions 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
| Feature | Details | |---------|---------| | Soft Dependencies | 1.17+ | | Soft Dependencies | 1.17 - 1.21.4+ | | Soft Dependencies | 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*
