AeroGrapple

<div align="center"> # 🎣 AeroGrapple ### *A clean, modern, and lightweight grappling hook plugin* !(https://img.shields.io/badge/Minecraft-1.17--1.21.4+-brightgreen?style=for-the-badge) !(https://img.shields.io/badge/Platform-Spigot%20%7C%20Paper-orange?style=for-the-badge) !(https://img.shields.io/badge/License-MIT-blue?style=for-the-badge) 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 (https://www.spigotmc.org/resources/grappling-hook.22854/) by SnowGears ** </div> --- ## ✨ 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> ` | Give a grappling hook | | `/aerograpple repair ` | Repair held grappling hook | | `/aerograpple repairall ` | 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: <details> <summary><b>📋 Settings</b></summary> - `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) </details> <details> <summary><b>✨ Special Features</b></summary> - `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 </details> <details> <summary><b>🎨 Filters & Appearance</b></summary> **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 `` placeholder - Texture IDs for resource packs </details> --- ## 🔐 Permissions <details> <summary><b>Basic Permissions</b></summary> - `aerograpple.pull.self` - Pull yourself to locations - `aerograpple.pull.mobs` - Pull mobs - `aerograpple.pull.players` - Pull players - `aerograpple.pull.items` - Pull items </details> <details> <summary><b>Special Permissions</b></summary> - `aerograpple.player.nopull` - Cannot be pulled by others - `aerograpple.player.nocooldown` - Bypass cooldowns </details> <details> <summary><b>Admin Permissions</b></summary> - `aerograpple.operator` - Use commands - `aerograpple.repair` - Repair own hooks - `aerograpple.repairall` - Repair all own hooks - `aerograpple.repairothers` - Repair other players' hooks </details> --- ## 📥 Installation 1. 📦 Download the latest version from the **Versions** tab 2. 📂 Drop the jar into your server's `plugins/` folder 3. 💰 *(Optional)* Install (https://www.spigotmc.org/resources/vault.34315/) 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 | |---------|---------| | **API Version** | 1.17+ | | **Minecraft Versions** | 1.17 - 1.21.4+ | | **Platforms** | Spigot, Paper, Purpur | | **Soft Dependencies** | Vault *(optional, for economy)* | --- ## 🔗 Links & Support - 📘 **(https://github.com/m-suro/AeroGrapple)** - 🐛 **(https://github.com/m-suro/AeroGrapple/issues)** - 💬 **(https://www.spigotmc.org/resources/grappling-hook.22854/)** *(Original)* --- <div align="center"> ### Give your players a movement tool that's fun, fair, and feels great to use. 🎣 *Made with ❤️ by (https://github.com/m-suro)* </div>