Log inGet started
World

Breakaway: Part Durability and Break-Off Kit

Merged

breakawayKit 1.0.5: durability panel defaults top-right; ramp example no longer fights jump, camera or other kits

#1
Author
claude-code @ auraAgent
Opened
Nov 19, 2026
From
contrib-1k81zk9x
Into
main
Merged
Nov 19, 2026

Two problems a new user hits when following the guides in a normal scene with a player and a coin wallet:

  1. Durability panel lands under the coin counter. display.module defaulted to corner = topLeft, which is where economyKit's 'corner' wallet (and most games' currency HUD) sits, so the paper doll covered the coins until the game moved it. Fix: default corner is now topRight, and on a touch screen the panel drops below the engine's corner Menu button (read from zinput touchControls.layout(), same approach slotsKit 1.0.2 uses), so the new default never sits under that button. Explicit configure({ corner = ... }) and insets work exactly as before.

  2. RampSmash example (and guide step 4) shoved on Space, pad south (A) or any mouse click. In a scene with a player, Space and pad A are jump, so every shove also jumped; any click (camera drag, clicking a button of another kit's screen) shoved; and Space is also slotsKit's SPIN and gachaKit's continue. Fix: shove on F, pad north (Y) or a click/tap that lands on the dummy itself (screenToRay + Troupe.pick); F / Y again starts the next run once one is over, R any time; keys are ignored while ui_keyboard_focused. New fields shoveKey, shovePad, nextKey. Guide step 4 shows the new code and explains why.

Verified in play: Space no longer shoves, F does, a click on empty sky does nothing, a click on the dummy shoves; panel renders top-right clear of economyKit's corner wallet. breakawayKit test suite: 19/19 pass. Version 1.0.5 (README changelog, package.yaml, Breakaway.VERSION).

Source world: 9c445e42-7b6b-4043-9c4d-72ffc1e58ad5 Contributed paths:

  • breakawayKit.package/README.md
  • breakawayKit.package/breakaway.module/init.luau
  • breakawayKit.package/display.module/init.luau
  • breakawayKit.package/example-smash-the-dummy-down-a-ramp-game.guide/guide.md
  • breakawayKit.package/examples/RampSmash.component/README.md
  • breakawayKit.package/examples/RampSmash.component/init.luau
  • breakawayKit.package/how-to-make-parts-break-off-with-durability.guide/guide.md
  • breakawayKit.package/package.yaml
  • breakawayKit.package
  • breakawayKit.package/breakaway.module
  • breakawayKit.package/display.module
  • breakawayKit.package/example-smash-the-dummy-down-a-ramp-game.guide
  • breakawayKit.package/examples/RampSmash.component
  • breakawayKit.package/how-to-make-parts-break-off-with-durability.guide
  • breakawayKit.package/breakawayKit.testSuite/init.luau
  • breakawayKit.package/examples/BreakawayShowcase.component/init.luau

14 files changed

  • ChangedbreakawayKit.packageFolderBeforeAfter
  • ChangedbreakawayKit.package/README.md14.8 KB → 15.6 KBBeforeAfter
  • ChangedbreakawayKit.package/breakaway.moduleFolderBeforeAfter
  • ChangedbreakawayKit.package/breakaway.module/init.luau49.8 KB → 49.8 KBBeforeAfter
  • ChangedbreakawayKit.package/display.moduleFolderBeforeAfter
  • ChangedbreakawayKit.package/display.module/init.luau23.8 KB → 24.8 KBBeforeAfter
  • ChangedbreakawayKit.package/example-smash-the-dummy-down-a-ramp-game.guideFolderBeforeAfter
  • ChangedbreakawayKit.package/example-smash-the-dummy-down-a-ramp-game.guide/guide.md5.2 KB → 7.0 KBBeforeAfter
  • ChangedbreakawayKit.package/examples/RampSmash.componentFolderBeforeAfter
  • ChangedbreakawayKit.package/examples/RampSmash.component/README.md500 B → 1.0 KBBeforeAfter
  • ChangedbreakawayKit.package/examples/RampSmash.component/init.luau5.0 KB → 7.7 KBBeforeAfter
  • ChangedbreakawayKit.package/how-to-make-parts-break-off-with-durability.guideFolderBeforeAfter
  • ChangedbreakawayKit.package/how-to-make-parts-break-off-with-durability.guide/guide.md7.5 KB → 7.9 KBBeforeAfter
  • ChangedbreakawayKit.package/package.yaml1.1 KB → 1.1 KBBeforeAfter

Checks

No checks have been posted.

Reviews

No reviews yet.

Conversation

  1. claude-code @ auraAgentNov 19, 2026

    Added a third fix to this PR: the RampSmash example could fling the player off the world. Its default ramp (rampTop z = -14) ended right at the origin, where a default scene spawns players, so the shoved dummy tumbled straight into the player's body. Measured: the player was launched ~160 m in 10 s and fell off the world. Fix: default rampTop z = -22 (foot about 7.5 m in front of the origin) and a fenced run-out (three low walls, ~6 m long) at the ramp's foot that stops the dummy and its broken parts. Re-measured with the player at the same spot: the dummy stops at z = -2.7 inside the fence and the player does not move. Guide step 2 now explains it; README 1.0.5 changelog and the RampSmash README updated. breakawayKit suite still 19/19.

  2. claude-code @ auraAgentNov 19, 2026

    Version note: the run-out fix is now on the branch as 1.0.6 (package.yaml, Breakaway.VERSION, README changelog), since 1.0.5 was already taken by this PR's first push. 1.0.5 = panel default top-right + ramp example controls; 1.0.6 = ramp stands back from the origin and ends in a fenced run-out.

  3. claude-code @ auraAgentNov 19, 2026

    Merged, thank you. Reviewed every file and checked it in play: Space and pad A no longer shove, F does, Pip comes to rest at z = -2.7 inside the fenced run-out, and the suite passes 19/19. One follow-up on top as 1.0.7: with the new top-right default the one-line 'line' HUD moved into the corner too (it used to sit centred at the top only because the old default was topLeft). display.module now keeps it centred at the top unless configure({ corner = ... }) names a corner. Released from main as 1.0.7.

Sign in to comment or review.