# Create Grappling Hooks 🪝

A grappling hook movement add-on for **Create: Aeronautics**. Fire cables across the sky, swing between your airships like Spider-Man, ride cables on a trolley, and carry your friends along.

## ✨ Features

- **Grapple Launcher** — fire a cable between two points (terrain and moving physics ships/floors).
- **Swing Hook** — a swing-anywhere grappling hook. Fire it at any surface and swing from it. Dual-wield one in each hand. Reel the rope in/out with Shift+W / Shift+S.
- **Momentum-based release** — the faster you swing, the farther you launch when you let go (release with a click, Space, or Ctrl+Space).
- **Rope that wraps around obstacles** — your rope bends and curves around blocks and airship edges instead of clipping through, and other players see it wrap in real time.
- **Cable Trolley** — clip onto a cable and ride it, moving toward wherever you look.
- **Hand-hold chain** — grab a riding player's hand and get carried along, fully synced.
- **Three ways to dismount** — Shift to drop, Space to hop ~1 block, Ctrl+Space to launch ~3 blocks.
- **Custom model, texture & sound effects.**
- **Shaderpack compatible** (Iris / Oculus) and **Punchy** compatible.
- **Multiplayer ready** — others see you swing, hang, ride, get carried, and watch your rope wrap.

## ⚠️ Required versions — pick the matching one!

This addon hooks directly into Create: Aeronautics' physics, so the versions must match. **Download the mod version that matches your Create: Aeronautics / Sable:**

| Create Grappling Hooks | Create: Aeronautics | Sable |
|---|---|---|
| **1.2.0** (latest) | 1.3.x | 2.0.x |
| **1.1.0** | 1.2.x | 1.2.x |

- **Minecraft 1.21.1** + NeoForge, **Create** 6.0.x.
- A mismatched version is rejected with a clear message (instead of crashing).
- *1.2.0 note:* Sable 2.0.x requires **Sodium 0.8.12+** if you use Sodium.

## Game crashed / won't start?

Almost always a version mismatch of Create: Aeronautics or Sable. **Your world is NOT broken** — the mod only crashes while loading it and never touches your save. Remove it, launch, and re-add it once your versions match the table above.

## 🎮 How to use

1. Craft the Grapple Launcher, Swing Hook and Cable Trolley (recipes in JEI/EMI).
2. **Swing Hook:** right-click to fire (left-click for an off-hand second hook). **You can fire while sneaking (Shift + right-click).** Shift+W/S to reel; click or Space / Ctrl+Space to let go.
3. **Grapple Launcher:** right-click two surfaces to span a cable.
4. **Cable Trolley:** hold it and right-click the cable to ride. Move with W/S; Shift / Space / Ctrl+Space to get off.
5. Remove cables with the Create Wrench (Shift + right-click).

## ⚠️ Known issues (being worked on)

- The hook can occasionally fly off when the rope wraps around an obstacle.
- The rope only wraps around one physics platform at a time.
- On fast-rotating platforms, the rope can be dragged along with the rotation.

## ☕ Support

This mod is made in my spare time. If you enjoy it, you can support its development on Ko-fi — thank you!

👉 **[Support me on Ko-fi](https://ko-fi.com/braumav)**