TMDevelopmentTinulica & Maiky

Sequence steps

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

StepExample
addadd: [screenfx:vignette_3]hold effects
removeremove: [screenfx:vignette_3]release effects
swapswap: [screenfx:glitch_1, screenfx:glitch_2]release one and hold another in the same tick and place (or a list of pairs)
setset: [screenfx:noir]release everything of this preset, then hold these
clearclear: truerelease everything of this preset
fadefade: {effect: screenfx:vignette, from: 1, to: 5, time: 2s}goes through vignette_1 ... vignette_5
flashflash: {effect: minecraft:invert, times: 3, on: 2, off: 2}on / off in ticks; marks the preset as flashing
updateupdate: truesend 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.

StepExample
potionpotion: nausea 5s 1a 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-screenred-screen: 3red edges 1 - 5 (0 = off), for this player only
frostfrost: 3frost on the edges like in powder snow, 1 - 5 (0 = off)
tilttilt: randomthe camera tilt of a hit: front, back, left, right, random or an angle
elder-guardianelder-guardian: truethe elder guardian face (silent = without its sound)
camera-shakecamera-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

StepExample
locklock: trueholds 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
particleparticle: {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
lightninglightning: true or {distance: 12}a lightning strike that only looks and sounds real (no fire, no damage)
explosionexplosion: small or {size: big, distance: 6, everyone: false}an explosion to see and hear, never a broken block or a hurt player
scenescene: tourstarts a cutscene of scenes.yml, so reactions, items, zones and shows can start one (Cutscenes and shows)

Sounds and texts

StepExample
soundsound: 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
titletitle: {title: "&cBoom", subtitle: "&7...", fade-in: 5, stay: 40, fade-out: 10}
actionbaractionbar: "&7Text"
messagemessage: "&7Text"or a list of lines
commandcommand: "give {player} apple"console command, or a list

More options of a sound, all optional:

OptionExample
pitch-randompitch-random: 0.1a bit higher or lower each time
categorycategory: ambientwhich volume slider of the client it follows: master, music, record, weather, block, hostile, neutral, player, ambient, voice, ui
aroundaround: trueplayed at the player's place: players nearby hear it too
stopstop: truestops 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

StepExample
waitwait: 20wait before the next step (ticks, or 1s, 1.5s)
holdhold: truestop here and keep the effects until the preset is stopped (or its duration ends)
repeatrepeat: 5 + steps:repeat the steps 5 times (forever = until the preset ends, needs a wait inside)
randomrandom: [ {sound: a}, {sound: b} ]one of these happens, picked each time (a choice is a step or a list of steps)
chancechance: 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.

Last updated

Sign in

New here? Just enter your email: the account is created when you click the link. No password needed.

or

We send you a link that signs you in with one click. It works for new and existing accounts.

Sign in with a password instead

By continuing you accept the Terms & Conditions and the Privacy policy.

Staff: open “Sign in with a password instead” and type your username instead of the email. After the password we ask for your 2FA code.