Studio

FolioTier 2

@flinch

Recoil a sprite back with a quick shrink - a startled or hurt reaction.

@flinch pulls a sprite inward for a split second then snaps it back, selling the physical jolt of a sudden shock or a blow landing. Reach for it whenever a character needs to register surprise, pain, or alarm without cutting away - it keeps focus on the sprite while communicating impact in a single beat.

The default values read as a believable human flinch. Nudge intensity up for a harder hit or a more theatrical reaction, and pull it down for a subtle startle - a noise in another room rather than a scream in their face.

When wait is false the next line of script runs immediately, so you can layer a sound cue or a second effect on top of the flinch without pausing the scene. If you fire multiple effects on the same sprite simultaneously the transforms compound, which can produce unintended results at high intensity values - test overlapping combinations at your chosen extremes. At intensity values close to 1 the shrink becomes pronounced enough to read as a character vanishing rather than recoiling; keep it below 0.8 for most dramatic beats unless you are deliberately going for a comedic or exaggerated tone.

Parameters

ParameterKindRequiredDefaultNotes
targetstringyes""Sprite tag to target.
intensitynumberno0.70-1 × multiplier. Default 0.7.
durationnumberno0.450.2-1.5 seconds. Default 0.45.
waitbooleannotrueBlock for the effect's duration when true; false fires and continues so effects can overlap.

Canonical example

sprite show ada
say "Ada": "What?!"
@flinch(target=ada)

@flinch snaps the sprite that target matches back with a small lean and shrink, then eases home. It reads as a startled or hurt reaction - a jolt at bad news, a blow, a shock - without swapping the sprite's state image.

intensity scales how hard the recoil hits (0.7 is the everyday default); duration is how long it runs. Keep both modest so the beat reads as body language, not a glitch.

Notes

@flinch is a Pixi-stage gesture effect - a one-shot reaction that returns the sprite exactly where it started.

See also

  • @slump - defeat, the slower cousin
  • @perk - the upward, positive counterpart
  • sprite - mounts the sprite that target matches