Tumblestep: The Endless Stair
README.md
juiceKit tests
104 tests over every public call of the kit. Run them in edit mode with tools.use("tests", "run", "juiceKit") (or zero tests run juiceKit); they need no player and no scene camera.
The Juice front door:
- Playing: play on entities, ids, names, positions and nothing, and what each play reports.
- Listing:
list,names,getandhas, with filters by kind, look, piece, tag and scope, the sort order, and copies that never change a preset. - Defining your own presets:
defineandremove, with broken specs refused, defaults worked out, redefining, presets built on presets, and player-only custom presets. - Presets built on presets: removing a base leaves its dependents exactly as they were (and the caller's own vfx list untouched), redefining a base keeps a piece it dropped, a three-preset chain survives removing its root and then its middle, and a loop or self-reference is refused with the old preset still playing.
- Looks: switching the material and shape of every effect, every effect in every look, a per-play look, and a received effect's look.
- Intensity: flash alpha, shake strength, particle count, hitstop length, zero, and a play's own intensity.
- Reduce motion: no shake at any intensity, gentle flashes, a running shake stopped, a remote blast's effect without the shake.
- Stopping a preset early:
stopAllmid-shake, mid-hitstop (the time scale always goes back to 1), mid-squash (exact base scale), mid-flash and mid-effect, delayed particles included. - Stopping one play:
Juice.stopandJuice.isPlayingby result, id and name. One shake comes off with no drift, one hitstop releases while another holds, one squash returns to base while another runs, a newer play takes an entity over, one flash and one effect (particles and light) clear while others stay, and one combo stops while another plays. Stale and unknown handles return false. A stop is sent for a play this peer sent, a peer's stop reaches only that peer's play, and stopping by name sends nothing. - Settings and the peer receive path:
stats, scope routing, and distance-scaled shake.
Each piece module:
- shake falloff and stop
- hitstop always releasing the time scale
- flash, drawn by a post-process pass that is switched off when no flash plays
- squash restoring the exact base scale
- vfx spawning and draining to zero
- net, util (including where this peer is with no player or camera, and never treating the editor camera as the gameplay camera) and the presets data
Every describe installs the same clean-up after each test, which stops everything, puts look, intensity and reduce motion back, despawns the probes and removes custom jk* presets. The suite spawns its own probes far from the origin. It leaves the scene, the camera's pose and the world settings as it found them, so it passes run after run.