Grappling Hook Reimagined

A clean, modern, and lightweight grappling hook plugin that feels great to use. 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. Thanks for the inspiration!
- Original plugin: https://www.spigotmc.org/resources/grappling-hook.22854/

---

Highlights

• Smooth, intuitive movement using a fishing hook as the grapple
• Optional use-limit per hook with configurable “destroy on break” behavior
• Admin-friendly commands and reload support
• Fully customizable messages and a neat, minimal prefix
• Lightweight by design — drop in and play

---

How it works (player experience)

1. Cast your hook at a block to pull yourself to it.
2. Cast at entities to reel them in (if permitted).
3. Servers may give special grappling hooks via command, ranks, or kits.

---

Commands
- /grapplinghook reload
Reloads the plugin configuration.

- /grapplinghook give <hook_id>
Gives yourself a grappling hook by ID.

- /grapplinghook give <hook_id> <player>
Gives a grappling hook by ID to a specific player.

Permission required for commands: grapplinghook.operator

---

Configuration
Simple, clear options and messages for a polished experience.

Notes:
- Hooks cannot be combined/modified in certain inventories to prevent data loss/exploits.
- Keep destroy-hook-on-use-limit false if you want players to repair their hook instead of losing it.

---

Installation

1. Drop the jar into your server’s plugins/ folder.
2. Start the server to generate configuration files.
3. Grant permissions to groups/players as needed.
4. Tweak messages and options to your liking.
5. Use /gh reload to apply changes instantly.

---

Compatibility
- API Version: 1.17
- Cooldown works on 1.21.2+
- Works on modern Spigot/Paper servers matching this API

---

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