Visual Novel › Authoring

Visual transitions and screen effects

A visual transition decides how the stage changes from one line to the next: a dissolve, a fade through black, a wipe. A screen effect colors or moves the whole stage: a white flash, a shake, a sepia memory, a slow camera zoom. Both are blocks in the Effects category of the palette, and both leave the dialogue box on top and readable.

This page is about what the player sees. For the blocks that hand control from the novel to free roam or another scene, see Transitions: leaving the novel.

The Effects blocks

The Effects category of the Add blocks palette

BlockWhat it does
Transition (with)Decides how the next line’s scene change is presented.
Screen effectAdds a flash, shake, tint, color screen, color filter, vignette, blur or camera move.
Clear effectsRemoves every screen effect, or only one kind.
Fade, DissolveShortcuts: a Transition block already set to that preset.
Flash, Punch (vpunch)Shortcuts: a Screen effect block already set to that preset.

The block editor shows only the fields of the mode or effect you picked. A tint never shows camera fields.

Transitions

Put a Transition (with) block before a line. Every scene change of that line — backdrop, characters, props, a video backdrop — is presented with it. The idea comes from Ren’Py’s with statement.

Transition (with)   dissolve
Backdrop            Kitchen, night
Show character      Mia
Dialogue            Mia: "You are back late."

The backdrop and Mia dissolve in together, then the line appears.

  • A line with no transition block cuts instantly, as it always has.
  • If a line has several transition blocks, the last one wins. The validator warns about it.

Transition modes

ModeWhat the player seesIts own fields
cutAn instant change.—
dissolveThe new scene fades in over the old one.—
fadeThe old scene fades to a color, then the new one fades in.Color, hold time, cover the dialogue box
wipeA line sweeps across the screen.Direction (left, right, up, down), soft edge
slideThe new scene slides in over the old one.Direction
pushThe new scene pushes the old one off screen.Direction
irisA circle opens (in) or closes (out) around a point.In or out, center point, soft edge
pixellateThe old scene breaks into blocks that resolve into the new one.Largest block size
zoomZooms into the old scene (in) or out of the new one (out).In or out, center point
maskA grayscale texture decides which parts of the screen change first.Texture, soft edge, invert

Every mode also takes:

  • Duration — seconds the transition takes.
  • Easing — the speed curve: linear, in (starts slow), out (ends slow), inout.
  • Wait for completion — on by default: the line appears once the transition finishes. Turn it off and the line appears while the transition plays.

A mask transition works like Ren’Py’s ImageDissolve. Dark pixels of the texture change first and light ones last, or the other way round with Invert. Any grayscale image works: a heart, a horizontal gradient, noise.

Screen effects

A Screen effect block adds one effect, by kind:

KindWhat it doesIts own fields
flashA burst of color that fades out.Color, intensity, cover the dialogue box
shakeShakes the stage. A punch is one hit; continuous keeps shaking.Axis (horizontal, vertical, both), amplitude, frequency, punch or continuous
tintLays a color over the stage.Color with transparency
color screenCovers the stage with a solid color, for a held black screen.Color, cover the dialogue box
color filterTurns the stage grayscale, sepia or inverted.Filter, intensity
vignetteDarkens the edges of the screen.Color, intensity, smoothness
blurBlurs the stage.Radius
cameraZooms toward a point and pans.Zoom, pan, focus point

One effect per kind at a time. A new effect replaces an active one of the same kind; effects of different kinds stack. A sepia filter plus a vignette plus a blur is one look made of three effects.

A line in Play mode under the flashback preset: sepia, vignette and a soft blur, with the dialogue box untouched

How long an effect lasts

Each Screen effect block chooses its duration:

OptionThe effect ends
Until the stage changes (default)At the first later line where the backdrop, characters, props or effects change.
Until the next lineWhen the next line appears.
Until clearedWhen a Clear effects block removes it.
SecondsAfter that many seconds. It plays once, as a pulse.

Flashes and punch shakes always play once, whatever you pick. Each effect also has Fade in and Fade out times, under Advanced.

Clearing effects

Clear effects removes every screen effect on stage, or only the kind you pick (for example, only the shake). Use it to end an effect you set to Until cleared: the flashback is over, the color comes back.

Presets

A preset is a named, ready-made transition or effect. Pick one on a block and you are done; or change any of its fields on that block alone with the small toggle next to the field.

A Screen effect block using the flashback preset, with the vignette layer's intensity overridden

Built-in transitionsBuilt-in effects
dissolve, fade, fadewhite, blackoutflash, vpunch, hpunch, shake
wipeleft, wiperight, wipeup, wipedownflashback — sepia, vignette and a soft blur
slideleft, slideright, slideup, slidedowndream — blur, a lavender tint and a white vignette
pushleft, pushright, pushup, pushdownblackscreen
irisin, irisout, pixellate, zoomin, zoomout

flashback and dream have several layers. A block that uses them lists the layers and can adjust one of them, such as only the vignette.

Your own presets: the Effect Library

Your presets live in an Effect Library asset:

  1. Create one with Create > Beasty VN > Config > Effect Library.
  2. Assign it in VN Settings > Screen effects > Effect Library.
  3. Add transitions and effects to it, each with an id.

A preset whose id matches a built-in one replaces the built-in. Transition presets and effect presets are separate lists: a transition called soft and an effect called soft never collide.

Renaming a preset updates every block that uses it, and rewrites the linked .vnbeasty scripts. When blocks use the preset, the editor asks first: “The transition preset ‘x’ is used by N block(s). Rename it to ‘y’ and update every block and linked script?”. Ids cannot be empty or contain spaces.

Skip, auto-forward and rewind

  • Advance during a transition finishes it; it does not skip the line.
  • Skip finishes transitions and one-shot effects at once.
  • Auto-forward starts counting when the transition ends.
  • Stepping back cuts straight to the earlier scene. Transitions and one-shot effects never replay on rewind, and the effects that last are worked out for every line, so a rewound line looks exactly as it did.

Saves and leaving the novel

A save remembers the effects that last, and loading rebuilds them. Leaving the novel for free roam or a menu switches the effects off and gives the camera back untouched. They come back when the story resumes.

Reduce flashes and motion

Players can turn on Reduce flashes and motion in the Preferences screen. With it on:

  • flashes are capped at 30% opacity and fade more slowly;
  • shakes move a quarter as far;
  • camera moves are instant.

Transitions do not change. The default for new players comes from VN Settings > Screen effects > Reduce Flashes By Default. Menu prefabs built before this option existed show the toggle after you run Tools > Beasty VN > Setup > Build Default Menu Prefabs again; until then the preference keeps its default.

Trying effects in the Dialogue Preview

The Dialogue Preview shows lasting effects — sepia, tint, vignette, blur, camera zoom — as you step through lines. Click ▶ Play effects to play the current line’s transition and one-shot effects as the game would, starting from the previous line’s scene.

In the text script

Every Effects block has a one-line form in .vnbeasty scripts:

with dissolve
with fade 2s color ffffff hold 0.3s coverui
effect vpunch
effect filter sepia 0.8 until cleared
clear effects

What the validator checks

Tools > Beasty VN > Maintenance > Validate Selected Project reports these as errors:

  • a preset that does not exist;
  • a mask transition without a texture.

And warns about:

  • two transitions before the same line;
  • Until the next line in a node with no line;
  • a shake amplitude above 2;
  • an effect or fade that covers the dialogue box for more than 3 seconds.

How it renders

The effects need no setup. The BeastyManager creates the compositor it needs at runtime, and it only works while a transition or a color effect plays; the rest of the time the stage camera draws straight to the screen. It works on the Built-in render pipeline and on URP. Shakes and camera moves move the stage camera and put it back.

To add your own transition mode or effect kind from code, see Gameplay APIs.

See also