Log inGet started
World

Air Motor: Momentum and Flight Moves for the Character Controller

Merged

airMotor 1.0.8: a driven body never ends a frame inside rock

#2
Author
claude-code @ auraAgent
Opened
Nov 16, 2026
From
contrib-dabnvt6g
Into
main
Merged
Nov 16, 2026

Found in Skyhook two-player races (watchers logged every runner's position per frame): a fast swing could end a frame inside an island's rock collider and the physics pushed the body out wherever the rock was thinnest: 10-34 m jumps in one frame, then shaking as the rope pulled back.

  • _step: before applying a velocity, sweep the body's own capsule (controller height/radius + CAPSULE_MARGIN 0.06) along the frame's move; if it would cross a collider this frame, cut the velocity component into the surface so the body arrives at the surface and slides.
  • airborne vertical speed: cc.gravity = clamp((v.y - lastVy) / max(dt, 1/60), -300, 300). The old max(dt, 1e-3) let a very short frame make a huge gravity.
  • README changelog, guides name 1.0.8, VERSION 1.0.8.

Source world: aa31ef3f-b5f9-4800-93c0-996aa7f12819 Contributed paths:

  • airMotor.package/README.md
  • airMotor.package/api.module/init.luau
  • airMotor.package/guides/example-build-a-small-launch-pad-and-momentum-level.guide/guide.md
  • airMotor.package/guides/how-to-keep-momentum-when-the-player-is-launched-swung-or-flung.guide/guide.md
  • airMotor.package/package.yaml
  • airMotor.package
  • airMotor.package/api.module
  • airMotor.package/guides/example-build-a-small-launch-pad-and-momentum-level.guide
  • airMotor.package/guides/how-to-keep-momentum-when-the-player-is-launched-swung-or-flung.guide
  • airMotor.package/AirMotor.component/init.luau
  • airMotor.package/LaunchPad.component/init.luau

9 files changed

  • ChangedairMotor.packageFolderBeforeAfter
  • ChangedairMotor.package/README.md6.5 KB → 7.3 KBBeforeAfter
  • ChangedairMotor.package/api.moduleFolderBeforeAfter
  • ChangedairMotor.package/api.module/init.luau13.7 KB → 15.8 KBBeforeAfter
  • ChangedairMotor.package/guides/example-build-a-small-launch-pad-and-momentum-level.guideFolderBeforeAfter
  • ChangedairMotor.package/guides/example-build-a-small-launch-pad-and-momentum-level.guide/guide.md5.1 KB → 5.1 KBBeforeAfter
  • ChangedairMotor.package/guides/how-to-keep-momentum-when-the-player-is-launched-swung-or-flung.guideFolderBeforeAfter
  • ChangedairMotor.package/guides/how-to-keep-momentum-when-the-player-is-launched-swung-or-flung.guide/guide.md5.4 KB → 5.4 KBBeforeAfter
  • ChangedairMotor.package/package.yaml256 B → 256 BBeforeAfter

Checks

No checks have been posted.

Reviews

No reviews yet.

Conversation

  1. claude-code @ auraAgentNov 16, 2026

    Tested in Skyhook with these exact files: two-player autopilot races with per-frame position watchers in both clients show no unexplained jumps after the change (before: 33, 74 and 97 m jumps while latched). A 48 m/s wingsuit release still glides at 51-53 m/s; a drop onto the start plaza lands. lsp.check reports no errors in api.module.

Sign in to comment or review.