Projektbeschreibung (Deutsch)

GrapplingHook

Ein leichtgewichtiges Paper/Spigot-Plugin, das einen funktionalen Enterhaken ins Spiel bringt — inspiriert von Spielen wie Apex Legends oder Titanfall.

Was macht das Plugin?

Mit einem speziell markierten Blaze Rod kannst du per Rechtsklick einen Pfeil abschießen. Der Pfeil hinterlässt eine sichtbare Partikelspur aus End Rod-Partikeln. Trifft der Pfeil ein Ziel oder einen Block, wirst du automatisch ein Stück in Richtung des Einschlagpunkts gezogen — nicht komplett dorthin teleportiert, sondern über eine physikalische Geschwindigkeitsänderung, die sich wie ein echter Grappling-Hook-Zug anfühlt.

Warum solltest du es herunterladen?

• Bringt Bewegungsfreiheit und ein neues Traversal-Mechanik-Gefühl auf deinen Server, ganz ohne Client-Mods.
• Vollständig serverseitig — Spieler brauchen keine zusätzlichen Mods oder Ressourcenpakete.
• Über Befehle konfigurierbar, ohne den Server neu zu starten.
• Eingebauter Cooldown verhindert Spam und macht das Item balancierbar für PvP- oder Parkour-Server.

Features

• 🎯 Rechtsklick mit dem Grappling Hook schießt einen unsichtbar markierten Pfeil ab
• ✨ End Rod-Partikelspur entlang der Flugbahn
• 🪝 Zieht dich beim Einschlag automatisch in Richtung des Ziels (einstellbarer Anteil der Distanz, kein vollständiges Teleport)
• 📏 Maximale Reichweite konfigurierbar
• ⏱️ Konfigurierbarer Cooldown zwischen Schüssen
• ⚙️ Alle Werte per Befehl zur Laufzeit änderbar, ohne Neustart
• 🎨 Design frei anpassbar über Custom Model Data (z.B. mit ItemEdit) + eigenes Resource Pack

Befehle

Befehl	Beschreibung
/grapplinghook give [Spieler]	Gibt den Grappling Hook
/grapplinghook range [Wert]	Zeigt/setzt die maximale Reichweite (Blöcke)
/grapplinghook pullstrength [Wert]	Zeigt/setzt die Zugstärke (0.1–1.5)
/grapplinghook reload	Lädt die Konfiguration neu

Alias: /gh, /grapple

Berechtigungen

Permission	Beschreibung	Standard
grapplinghook.use	Erlaubt die Nutzung des Grappling Hooks	alle Spieler
grapplinghook.admin	Erlaubt die Admin-Befehle	Operatoren

Konfiguration (config.yml)

range: 30.0
pull-strength: 0.65
vertical-boost: 0.15
arrow-speed: 3.0
cooldown-seconds: 1.0

Design anpassen (Custom Model Data)

Das Grappling Hook Item ist standardmäßig ein normaler Blaze Rod. Wenn du ein eigenes Aussehen (z.B. über ein Resource Pack) möchtest, kannst du selbst eine Custom Model Data auf das Item setzen — z.B. mit dem Plugin ItemEdit:

/ie customModelData <Wert>

Halte dazu einfach den per /gh give erhaltenen Grappling Hook in der Hand und führe den Befehl aus. Anschließend kannst du über ein passendes Resource Pack ein eigenes Modell/Textur für diesen Custom-Model-Data-Wert hinterlegen. Das Plugin selbst schreibt keine Custom Model Data vor — du hast also volle Freiheit beim Design.

Wichtige Hinweise

• Das Plugin ist rein serverseitig, Spieler benötigen keine Client-Modifikation.
• Es werden keine Daten an externe Server gesendet.
• Getestet mit Paper API 1.20.4 (bitte deine tatsächlich getestete Version eintragen, bevor du veröffentlichst).

---

Project Description (English)

GrapplingHook

A lightweight Paper/Spigot plugin that adds a functional grappling hook to your server — inspired by traversal mechanics from games like Apex Legends or Titanfall.

What does this plugin do?

Using a specially marked Blaze Rod, players can right-click to fire an arrow. The arrow leaves a visible trail of End Rod particles as it flies. When the arrow hits a block or entity, the player is pulled a portion of the way toward the impact point — not teleported all the way there, but given a velocity boost that feels like a real grappling-hook pull.

Why should you download this?

• Adds a new movement mechanic to your server without requiring any client-side mods.
• Fully server-side — players don't need to install anything.
• Configurable via in-game commands, no server restart required.
• Built-in cooldown keeps the item balanced for PvP or parkour servers.

Features

• 🎯 Right-click with the Grappling Hook to fire a specially marked arrow
• ✨ End Rod particle trail along the arrow's flight path
• 🪝 Automatically pulls the player toward the impact point on hit (configurable fraction of the distance, not a full teleport)
• 📏 Configurable maximum range
• ⏱️ Configurable cooldown between shots
• ⚙️ All values adjustable at runtime via commands, no restart needed
• 🎨 Fully customizable design via Custom Model Data (e.g. with ItemEdit) + your own resource pack

Commands

Command	Description
/grapplinghook give [player]	Gives the Grappling Hook item
/grapplinghook range [value]	Shows/sets the maximum range (blocks)
/grapplinghook pullstrength [value]	Shows/sets the pull strength (0.1–1.5)
/grapplinghook reload	Reloads the configuration

Aliases: /gh, /grapple

Permissions

Permission	Description	Default
grapplinghook.use	Allows use of the grappling hook	all players
grapplinghook.admin	Allows use of admin commands	operators

Configuration (config.yml)

range: 30.0
pull-strength: 0.65
vertical-boost: 0.15
arrow-speed: 3.0
cooldown-seconds: 1.0

Customizing the design (Custom Model Data)

By default, the Grappling Hook item is a plain Blaze Rod. If you want a custom appearance (e.g. via a resource pack), you can set a Custom Model Data value on the item yourself — for example using the ItemEdit plugin:

/ie customModelData <value>

Just hold the Grappling Hook you got from /gh give and run the command. You can then provide a matching model/texture for that Custom Model Data value in your resource pack. This plugin does not enforce any Custom Model Data itself, so you have full freedom over the design.

Important notes

• This plugin is entirely server-side; players do not need any client modification.
• No data is uploaded to any external server.
• Tested with Paper API 1.20.4 (please update this to the version you actually tested before publishing).