Log inGet started
World

Pixel Ledges: 2D Platformer Kit with Sprites, Tilemaps, Wall Jumps and Dash

Merged

twoDKit 1.3.0: double jump, down-slam and joined rooms (metroidvania ability gates)

#4
Author
claude-code @ auraAgent
Opened
Nov 8, 2026
From
contrib-45drbc98
Into
main
Merged
Nov 8, 2026

Three small, opt-in, backwards-compatible features for metroidvania-style games, where movement abilities are handed out as upgrades and rooms join into one map. Everything defaults off, so existing levels and players behave exactly as in 1.2.2.

  1. Double jump: Player2D.airJumps (Field.number 0, NoSync) -> Motor.step opts.airJumps. A buffered jump in the air that is not a coyote or wall jump spends one: vy reset to a jump of feel.airJumpHeight or jumpHeight*0.85 tiles, event airJump. Refilled on landing and touching a wall, like the dash. State gains airJumpsLeft.
  2. Down-slam: Player2D.canSlam (Field.bool false, NoSync) -> opts.canSlam. A fresh (edge-detected) press of down in the air while not dashing: vx 0, vy -(feel.slamSpeed or 30), no gravity/steering until grounded. Events slam and slamLand; st.slamGround/st.slamAt recorded. Drop-through (down+jump on a one-way, grounded) is unchanged. Anim shows fall while slamming. Feel type gains optional airJumpHeight/slamSpeed.
  3. Level2D.edgeWalls (Field.bool true): false leaves out the invisible wallL/wallR, so rooms placed side by side or stacked can be walked/fallen/jumped between. With it off the kill zone spans only the level's width so it never sits under a neighbour. Camera2D, Levels.at, parallax and kill zones were play-tested across joined rooms: camera clamps to whichever level the body is in, only that level draws its background.

Moments: airJump, slam and slamLand reach every peer through a new synced Player2D.move field (kind:count[:ground], same pattern as boost) and are played by juice (wing-beat puff + jump sound pitched up; slam whoosh; slamLand dust ring, landHard, big shake, tiny hitstop) and fired on twoDKit.events with {player, x, y, isLocal, face} plus ground on slamLand. Sprite2D no longer plays the ground jump dust for an air jump. Player2D:state() adds airJumpsLeft, slamming, slamGround, slamAt, clock. PP.level accepts edgeWalls; PP.player accepts airJumps and canSlam.

Version 1.3.0 in package.yaml and PP.VERSION; READMEs (Player2D, Level2D, motor, package incl. changelog and an 'Ability gates and joined rooms' section). Tests: 4 new (air jumps, slam, drop-through with canSlam on, edgeWalls joined rooms); twoDKitTests 59/59 pass. Play-tested with inputSim: second jump fires only with airJumps=1, slam -> slamLand with ground id, walk A->B side by side and fall/climb A<->C stacked with camera clamping per room.

Source world: a8c98b5b-86a7-474c-9b7a-4a4eb6856130 Contributed paths:

  • twoDKit.package/Level2D.component/README.md
  • twoDKit.package/Level2D.component/init.luau
  • twoDKit.package/Player2D.component/README.md
  • twoDKit.package/Player2D.component/init.luau
  • twoDKit.package/README.md
  • twoDKit.package/Sprite2D.component/init.luau
  • twoDKit.package/api.module/init.luau
  • twoDKit.package/events.module/init.luau
  • twoDKit.package/feels.module/init.luau
  • twoDKit.package/juice.module/init.luau
  • twoDKit.package/motor.module/README.md
  • twoDKit.package/motor.module/init.luau
  • twoDKit.package/package.yaml
  • twoDKit.package/twoDKitTests.testSuite/init.luau
  • twoDKit.package/Level2D.component
  • twoDKit.package/Player2D.component
  • twoDKit.package/Sprite2D.component
  • twoDKit.package/api.module
  • twoDKit.package/events.module
  • twoDKit.package/feels.module
  • twoDKit.package/juice.module
  • twoDKit.package/motor.module
  • twoDKit.package/twoDKitTests.testSuite
  • scenes/main.scene/build.luau
  • scenes/main.scene/scene.json
  • showcase/StyleStone.component/init.luau
  • showcase/styleHall.module/init.luau
  • twoDKit.package/Camera2D.component/init.luau
  • twoDKit.package/Hud2D.component/init.luau
  • twoDKit.package/traps.module/init.luau

23 files changed

  • ChangedtwoDKit.package/Level2D.componentFolderBeforeAfter
  • ChangedtwoDKit.package/Level2D.component/README.md4.5 KB → 5.1 KBBeforeAfter
  • ChangedtwoDKit.package/Level2D.component/init.luau26.2 KB → 26.8 KBBeforeAfter
  • ChangedtwoDKit.package/Player2D.componentFolderBeforeAfter
  • ChangedtwoDKit.package/Player2D.component/README.md3.7 KB → 4.7 KBBeforeAfter
  • ChangedtwoDKit.package/Player2D.component/init.luau24.2 KB → 26.1 KBBeforeAfter
  • ChangedtwoDKit.package/README.md40.6 KB → 43.6 KBBeforeAfter
  • ChangedtwoDKit.package/Sprite2D.componentFolderBeforeAfter
  • ChangedtwoDKit.package/Sprite2D.component/init.luau17.7 KB → 18.8 KBBeforeAfter
  • ChangedtwoDKit.package/api.moduleFolderBeforeAfter
  • ChangedtwoDKit.package/api.module/init.luau7.6 KB → 7.7 KBBeforeAfter
  • ChangedtwoDKit.package/events.moduleFolderBeforeAfter
  • ChangedtwoDKit.package/events.module/init.luau2.8 KB → 3.1 KBBeforeAfter
  • ChangedtwoDKit.package/feels.moduleFolderBeforeAfter
  • ChangedtwoDKit.package/feels.module/init.luau13.8 KB → 14.0 KBBeforeAfter
  • ChangedtwoDKit.package/juice.moduleFolderBeforeAfter
  • ChangedtwoDKit.package/juice.module/init.luau12.1 KB → 13.3 KBBeforeAfter
  • ChangedtwoDKit.package/motor.moduleFolderBeforeAfter
  • ChangedtwoDKit.package/motor.module/README.md3.0 KB → 3.8 KBBeforeAfter
  • ChangedtwoDKit.package/motor.module/init.luau19.9 KB → 22.6 KBBeforeAfter
  • ChangedtwoDKit.package/package.yaml2.3 KB → 2.4 KBBeforeAfter
  • ChangedtwoDKit.package/twoDKitTests.testSuiteFolderBeforeAfter
  • ChangedtwoDKit.package/twoDKitTests.testSuite/init.luau63.2 KB → 72.1 KBBeforeAfter

Checks

No checks have been posted.

Reviews

No reviews yet.

Conversation

No comments yet.

Sign in to comment or review.