Grapple Kit: Grappling Hooks, Swinging, Zip Lines and Slingshots
- Author
- claude-code @ auraAgent
- Opened
- Nov 16, 2026
- From
- surface-aim-1.0.11
- Into
- main
- Merged
- Nov 16, 2026
Reported from Skyhook: standing on the start plaza holding W and pressing E, the hook latched onto the island ground right ahead (rope ~5.6 m) and the runner stopped dead; each such latch also logged an error about an entity that does not exist. Cause: with surfaceTag on (Skyhook marks islands 'grappleable'), a shot with no anchor in the assist cone fell back to the camera ray's surface hit, wherever it was; and hasTag/isAnchorEntity called entity(hit.entityId), which logs an error for a collider id that is no entity of its own. Now: anchors are retried at twice the cone before any surface; a surface is hooked only >= surfaceMinDistance (8 m) away and >= surfaceMinRise (2 m) above the player (new fields, documented in README and how-to guide); entity lookups ask entity.exists first. Swing.surfaceAllowed holds the rule and has a test (the 5.6 m ground case is refused). 23/23 pass. Adds the build-a-grappling-hook-level workflow. VERSION 1.0.11.
18 files changed
- ChangedgrappleKit.packageFolderBeforeAfter
- ChangedgrappleKit.package/GrappleHook.componentFolderBeforeAfter
- ChangedgrappleKit.package/GrappleHook.component/init.luau32.0 KB → 33.2 KBBeforeAfter
- ChangedgrappleKit.package/README.md15.3 KB → 16.7 KBBeforeAfter
- ChangedgrappleKit.package/api.moduleFolderBeforeAfter
- ChangedgrappleKit.package/api.module/init.luau6.7 KB → 6.7 KBBeforeAfter
- AddedgrappleKit.package/build-a-grappling-hook-level.workflowFolderAfter
- AddedgrappleKit.package/build-a-grappling-hook-level.workflow/.metadata476 BAfter
- AddedgrappleKit.package/build-a-grappling-hook-level.workflow/README.md719 BAfter
- AddedgrappleKit.package/build-a-grappling-hook-level.workflow/workflow.js4.4 KBAfter
- AddedgrappleKit.package/build-a-grappling-hook-level.workflow/workflow.yaml1.5 KBAfter
- ChangedgrappleKit.package/guides/how-to-add-a-grappling-hook-to-my-game.guideFolderBeforeAfter
- ChangedgrappleKit.package/guides/how-to-add-a-grappling-hook-to-my-game.guide/guide.md13.5 KB → 14.1 KBBeforeAfter
- ChangedgrappleKit.package/package.yaml515 B → 515 BBeforeAfter
- ChangedgrappleKit.package/swing.moduleFolderBeforeAfter
- ChangedgrappleKit.package/swing.module/init.luau11.5 KB → 12.1 KBBeforeAfter
- ChangedgrappleKit.package/tests/grappleKit.testSuiteFolderBeforeAfter
- ChangedgrappleKit.package/tests/grappleKit.testSuite/init.luau17.6 KB → 18.6 KBBeforeAfter
Checks
From the author and the world's members
- Passedtests23 passed, 0 failed, 0 skipped. Suites: grappleKit
Reviews
No reviews yet.
Conversation
- claude-code @ auraAgentNov 16, 2026
Checked: 23/23 grappleKit tests on the branch, including the new surface rule test; workflow lists in workflow.list. Live check in Skyhook follows the update there.
Sign in to comment or review.