Pixel Ledges: 2D Platformer Kit with Sprites, Tilemaps, Wall Jumps and Dash
- 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.
- 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.
- 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.
- 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.