Trapwright: Dungeon Traps, Secret Rooms and Puzzles Kit
- Author
- claude-code @ auraAgent
- Opened
- Nov 15, 2026
- From
- patch-1.0.1
- Into
- main
- Merged
- Nov 15, 2026
Patch release 1.0.1.
- FIX: module state outlived a play session while its entities did not, so a piece placed again with the same id kept a dead root. place() now rebuilds a piece whose root no longer exists (forget without despawn), K.get/Dungeon.get read such a piece as nil, K.purgeDead() drops them, and an engine.onModeChange watcher clears pieces placed during play when play stops (edit pieces stay).
- PERFORMANCE: K.tick skips a piece's visual tick when it is more than 60 m from the local avatar (setVisualRange(metres, every?) sets it; every > 0 animates far pieces every Nth frame). Host logic always runs. Measured on DemoCrypt (11 pieces): 2.06 ms per tick near, 0.11 ms with the avatar 500 m away (before: 1.79 ms far). Galleries set the range to 0 so a flying camera sees everything animate.
- NEW: arena family (arena.module): shockwaveRing, fallingDebris, floorPanels, pillarCover. Dormant at phase 0, driven by Dungeon.arenaPhase(id, n) / arenaPhaseAll(n, prefix?); phases 1 to 3 tighten timing and density. Shockwaves are blocked by intact pillars and jumped; debris spots are seeded (identical on every peer) and crack pillars; one floor tile always stays safe; pillars have colliders, take hits (hitPillar), fall from phase 2 and stand again at phase 1. Rewritable (TARGET, ARMED, DMG, PHASE), all 8 looks, in the gallery.
- trapwright tests: 28 (10 new). README, both guides and module READMEs updated.
24 files changed
- ChangeddungeonKit.packageFolderBeforeAfter
- ChangeddungeonKit.package/Gallery.componentFolderBeforeAfter
- ChangeddungeonKit.package/Gallery.component/README.md275 B → 477 BBeforeAfter
- ChangeddungeonKit.package/Gallery.component/init.luau5.3 KB → 5.9 KBBeforeAfter
- ChangeddungeonKit.package/README.md8.8 KB → 11.6 KBBeforeAfter
- ChangeddungeonKit.package/api.moduleFolderBeforeAfter
- ChangeddungeonKit.package/api.module/README.md580 B → 891 BBeforeAfter
- ChangeddungeonKit.package/api.module/init.luau8.1 KB → 9.8 KBBeforeAfter
- AddeddungeonKit.package/arena.moduleFolderAfter
- AddeddungeonKit.package/arena.module/.metadata51 BAfter
- AddeddungeonKit.package/arena.module/README.md964 BAfter
- AddeddungeonKit.package/arena.module/init.luau22.8 KBAfter
- ChangeddungeonKit.package/core.moduleFolderBeforeAfter
- ChangeddungeonKit.package/core.module/README.md480 B → 883 BBeforeAfter
- ChangeddungeonKit.package/core.module/init.luau23.5 KB → 27.2 KBBeforeAfter
- ChangeddungeonKit.package/example-build-a-trapped-crypt-level-with-a-secret-room.guideFolderBeforeAfter
- ChangeddungeonKit.package/example-build-a-trapped-crypt-level-with-a-secret-room.guide/guide.md5.2 KB → 5.6 KBBeforeAfter
- ChangeddungeonKit.package/how-to-make-dungeon-traps-secret-rooms-and-puzzles.guideFolderBeforeAfter
- ChangeddungeonKit.package/how-to-make-dungeon-traps-secret-rooms-and-puzzles.guide/guide.md5.7 KB → 7.6 KBBeforeAfter
- AddeddungeonKit.package/media-arena-lava.jpg185 KBAfter
- ChangeddungeonKit.package/package.yaml1.4 KB → 1.6 KBBeforeAfter
- ChangeddungeonKit.package/trapwright.testSuiteFolderBeforeAfter
- ChangeddungeonKit.package/trapwright.testSuite/README.md533 B → 839 BBeforeAfter
- ChangeddungeonKit.package/trapwright.testSuite/init.luau16.2 KB → 24.8 KBBeforeAfter
Checks
From the author and the world's members
- Passedtests28 passed, 0 failed, 0 skipped. Suites: trapwright
Reviews
No reviews yet.
Conversation
No comments yet.
Sign in to comment or review.