AeroGrapple

A clean, modern, and lightweight grappling hook plugin that feels great to use.

415
Download

AeroGrapple

<div align="center">

🎣 AeroGrapple

*A clean, modern, and lightweight grappling hook plugin*

Minecraft

Platform

License

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]

</div>

---

✨ 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)*

---

<div align="center">

Give your players a movement tool that's fun, fair, and feels great to use. 🎣

*Made with ❤️ by m-suro*

</div>

ADS