AeroGrapple

---

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

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)

---