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
| Parameter | Kind | Required | Default | Notes |
|---|---|---|---|---|
| target | string | yes | "" | Sprite tag to target. |
| intensity | number | no | 0.7 | 0-1 × multiplier. Default 0.7. |
| duration | number | no | 0.45 | 0.2-1.5 seconds. Default 0.45. |
| wait | boolean | no | true | Block 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.