Sequence steps

The sequence of a preset is its timeline, a list of steps. One step can hold several keys (the screen effects come first, then the rest). wait makes the next step start later. presets/_guide.yml has the same list.
Screen effects
| Step | Example | |
|---|---|---|
add | add: [screenfx:vignette_3] | hold effects |
remove | remove: [screenfx:vignette_3] | release effects |
swap | swap: [screenfx:glitch_1, screenfx:glitch_2] | release one and hold another in the same tick and place (or a list of pairs) |
set | set: [screenfx:noir] | release everything of this preset, then hold these |
clear | clear: true | release everything of this preset |
fade | fade: {effect: screenfx:vignette, from: 1, to: 5, time: 2s} | goes through vignette_1 ... vignette_5 |
flash | flash: {effect: minecraft:invert, times: 3, on: 2, off: 2} | on / off in ticks; marks the preset as flashing |
update | update: true | send the changes right away (instant flashes) |
Swapping levels animates any effect: glitch_1 → glitch_2, heat_1 → heat_2...
Without the resource pack
These work for every player, also Bedrock: a vanilla version made of them reaches everyone.
| Step | Example | |
|---|---|---|
potion | potion: nausea 5s 1 | a potion effect without particles and icon, taken off when the preset ends (darkness, nausea, blindness, night_vision, slowness zooms the view...). No time = until the preset ends. Also a list. A potion of the player as strong or stronger is left alone, and the player's own potions are never lost |
red-screen | red-screen: 3 | red edges 1 - 5 (0 = off), for this player only |
frost | frost: 3 | frost on the edges like in powder snow, 1 - 5 (0 = off) |
tilt | tilt: random | the camera tilt of a hit: front, back, left, right, random or an angle |
elder-guardian | elder-guardian: true | the elder guardian face (silent = without its sound) |
camera-shake | camera-shake: 3 or {strength: 3, time: 2s} | the camera itself shakes, strength in degrees; it fades out by itself, 0 stops it. Older clients and Bedrock get a tilt |
Scenes and moments
| Step | Example | |
|---|---|---|
lock | lock: true | holds the player until the preset ends: he can look around but not walk, get hurt, use commands or use things. lock: skip = the same, and sneaking ends the preset. Or pick: {move: true, damage: true, commands: true, interact: true, skip: false}. Allowed commands: safety.locked-commands |
particle | particle: {type: dust, color: "#ff3344", size: 1.5, count: 20} | particles at the player; also spread, speed, at: feet|body|eyes, everyone: false (only the player sees them). Also a list |
lightning | lightning: true or {distance: 12} | a lightning strike that only looks and sounds real (no fire, no damage) |
explosion | explosion: small or {size: big, distance: 6, everyone: false} | an explosion to see and hear, never a broken block or a hurt player |
scene | scene: tour | starts a cutscene of scenes.yml, so reactions, items, zones and shows can start one (Cutscenes and shows) |
Sounds and texts
| Step | Example | |
|---|---|---|
sound | sound: entity.generic.explode or {sound: ..., volume: 1, pitch: 1.2} | also a list of sounds played together. The sounds of the ScreenFX pack too: sound: screenfx:heartbeat |
title | title: {title: "&cBoom", subtitle: "&7...", fade-in: 5, stay: 40, fade-out: 10} | |
actionbar | actionbar: "&7Text" | |
message | message: "&7Text" | or a list of lines |
command | command: "give {player} apple" | console command, or a list |
More options of a sound, all optional:
| Option | Example | |
|---|---|---|
pitch-random | pitch-random: 0.1 | a bit higher or lower each time |
category | category: ambient | which volume slider of the client it follows: master, music, record, weather, block, hostile, neutral, player, ambient, voice, ui |
around | around: true | played at the player's place: players nearby hear it too |
stop | stop: true | stops that sound |
- sound: {sound: screenfx:impact, volume: 1, pitch: 0.8, pitch-random: 0.1, category: hostile, around: true}
Players without the pack don't hear the screenfx: sounds: give the fallback a vanilla sound.
Time and flow
| Step | Example | |
|---|---|---|
wait | wait: 20 | wait before the next step (ticks, or 1s, 1.5s) |
hold | hold: true | stop here and keep the effects until the preset is stopped (or its duration ends) |
repeat | repeat: 5 + steps: | repeat the steps 5 times (forever = until the preset ends, needs a wait inside) |
random | random: [ {sound: a}, {sound: b} ] | one of these happens, picked each time (a choice is a step or a list of steps) |
chance | chance: 30% | in any step: the whole step happens only that often |
A fade or a flash takes time: what comes after it in the same step waits for it. Put a sound that must play first in the step before the fade.
Example
laughing:
sequence:
- add: [screenfx:tint_pink_2, screenfx:wobble_1]
- repeat: forever
steps:
- random:
- sound: {sound: entity.witch.celebrate, volume: 0.6, pitch: 1.6}
- sound: {sound: entity.villager.celebrate, volume: 0.6, pitch: 1.5}
- wait: 30
- swap: [screenfx:wobble_1, screenfx:wobble_2]
- wait: 30
- swap: [screenfx:wobble_2, screenfx:wobble_1]
fallback:
sequence:
- potion: nausea
Mistakes are shown in the console at /sfx reload with the file, the preset and the step.
Ultimo aggiornamento: