Biome Transition

Changes the biome a player sees over the course of a cinematic. Each segment shows one biome to that player alone, through the per-player overlay, so the world is never touched and other players see nothing. When the cinematic ends the overlay is dropped and the real world comes back.

Fields

Field	Type	Description
chunkRadius	Int	Chunk radius around the player each segment covers
segments	List<Segment>	The biomes to show, in order

Each segment carries a biome key alongside its start and end frames.

What it does, and does not, do

This sequences biomes; it does not interpolate between them. Minecraft resolves biome colours from the registry, so a genuine fade would require registering one biome per intermediate step.

To approximate a fade, chain several short segments through intermediate definitions — three or four steps between two moods read as a transition at normal cinematic speed. A preset makes those intermediate biomes cheap to author, since they differ only in the values being faded.

Requirements

PacketEvents must be installed. Without it the cinematic runs but no biome changes, and a warning is logged at setup rather than silently doing nothing.

Example

Slide from a healthy forest into a corrupted one over 200 frames:

chunkRadius: 6
segments:
  0   → 80   typewriter:forest_pale
  80  → 140  typewriter:forest_tainted
  140 → 200  typewriter:corrupted_forest