Log inGet started
World

Thumbstick Studio: Touch, Gamepad and Keyboard Controls Kit

Merged

controlsKit 1.4.4: a scheme ends with the play session that switched it on

#11
Author
claude-code @ auraAgent
Opened
Nov 17, 2026
From
contrib-s22m0xrf
Into
main
Merged
Nov 17, 2026

Bug: when play stopped, step() only called dropPlayListeners(); every controller kept its scheme and its takeover of the engine walking map in module state. The next play session in the same client started with that scheme live (the default walking map suppressed), so the player could not move off the spawn. Found in Quiet Reach's Takedown Gallery (a long-running editor client froze at the gallery start every session).

Fix (controls.module step): on the play -> non-play edge, outside _isolate, cancel captures, stop every controller, clear the list and release the kit map (ensureKitMap(nil)). Games that want a scheme switch it on again at play start (onLoad / ControlsMenu), as they already do.

Repro and check, fresh client, Pass Ambush: play, Controls.use('twinStick'), stop, play: before the fix Controls.scheme() = twinStick and W moves the player 0 m; after it scheme() = nil and W walks 4.7 m. controlsKitTests: 59/61, the same two failures as unmodified 1.4.3 in a headless client (gallery paging, touch raster: both depend on a real screen size).

Version 1.4.4 in package.yaml, README and Controls.VERSION; README What changed entry.

Source world: 6fea270e-4b4f-4336-aa94-e4f8b1611e06 Contributed paths:

  • controlsKit.package/README.md
  • controlsKit.package/controls.module/init.luau
  • controlsKit.package/package.yaml
  • controlsKit.package
  • controlsKit.package/controls.module
  • controlsKit.package/ControlsMenu.component/init.luau
  • controlsKit.package/ControlsMover.component/init.luau
  • controlsKit.package/controlsKitTests.testSuite/init.luau
  • controlsKit.package/gallery.module/init.luau
  • controlsKit.package/rebindScreen.module/init.luau

5 files changed

  • ChangedcontrolsKit.packageFolderBeforeAfter
  • ChangedcontrolsKit.package/README.md41.6 KB → 42.5 KBBeforeAfter
  • ChangedcontrolsKit.package/controls.moduleFolderBeforeAfter
  • ChangedcontrolsKit.package/controls.module/init.luau96.3 KB → 97.1 KBBeforeAfter
  • ChangedcontrolsKit.package/package.yaml1.2 KB → 1.2 KBBeforeAfter

Checks

No checks have been posted.

Reviews

No reviews yet.

Conversation

No comments yet.

Sign in to comment or review.