Grapple Kit: Grappling Hooks, Swinging, Zip Lines and Slingshots
README.md
GrappleHook
The player's grappling hook. Add it to the player prototype's body (the entity with the CharacterController, e.g. the body under your PlayerPrototype), one per player. Needs airMotor (installed with grappleKit).
On the owner's peer it aims from the camera with aim assist (snaps to the best GrapplePoint / ZipLine / Slingshot in a cone, or a collider tagged grappleable), fires a head that travels, latches, then swings the body as a real pendulum through airMotor at priority 3: gravity, air drag, pumping with the move stick, reel in, release with momentum and a boost for a well-timed release. Zip lines are ridden, slingshots launch. Every peer draws every player's rope, head and style from the synced state.
Fields: style (hook head, sound and default rope: classic, harpoon, ninja, vine, energy, frost, steampunk, plunger, magnet, pixel), rope (any rope look on any head; "" = the style's own: hemp, steel, vine, energy, brass, candy, ninja, pixel, bungee, laser, frost, gold), feel (arcade by default, floaty, heavy, acrobatic; 1.0.x names classic, realistic, zippy still resolve), hookEnabled, holdToSwing, range, assist, surfaceTag, anySurface, useInput, inputMap, handBone, sounds, volume, reticle; read-only synced state phase, hookPoint, fireFrom, firedAt, ropeLength, anchorId, chain, and speed.
Methods: fire(target?), release(), setReel(on), isLocalPlayer(), velocity(), aimTarget(). Events go through grappleKit.api (Grapple.on("latched", fn) returns a stop function).