Log inGet started
World

Grapple Kit: Grappling Hooks, Swinging, Zip Lines and Slingshots

Merged

grappleKit 1.0.11: anchors before surfaces, never hook the ground just ahead; no error on non-entity colliders; workflow

#3
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

Reviews

No reviews yet.

Conversation

  1. 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.