ConditionalVideos

✨ Overview

Choose a condition, add videos to its file, and the mod plays them at the right moment. It works in singleplayer, on LAN and on dedicated servers, where the server decides what plays and sends its video files to the players.

• Sources: local files, direct URLs, YouTube, Twitch, Kick, TikTok, SoundCloud and more, through WATERMeDIA.
• Playlists: transitions, loops, text overlays, per-video volume, start and end times.
• Waiting room: players wait for each other on firstJoin, then watch together.
• Safe to watch: players are protected during videos, and the world can freeze while everyone is watching.
• Commands to play, stop, pause and edit videos in-game, plus an API for other mods.

🧩 Requirements

| Minecraft | Loaders | Java | |---|---|---| | 1.20.1 | Fabric, Forge | 17+ | | 1.21.1 | Fabric, NeoForge | 21+ | | 1.21.11 | Fabric, NeoForge | 21+ | | 26.1.2 | Fabric, NeoForge | 25+ | | 26.2 | Fabric, NeoForge | 25+ |

Everywhere:

• Architectury API
• Fabric API (Fabric only)

On the client:

• WATERMeDIA: Multimedia API 3.0.0+
• WATERMeDIA: Native Binaries 3.0.0+

> On 26.2, videos play on both renderers, but Vulkan support is experimental. OpenGL is the safest choice.

🎯 Conditions

| Condition | Plays when | |---|---| | firstJoin | The player joins the world. It always plays before anything else. | | playerDeath | The player dies. | | totemUsed | A Totem of Undying saves the player. | | bedSleep | The player starts sleeping. | | deathByEntity | A specific entity kills the player. Takes priority over playerDeath. | | entityKilled | The player kills a specific entity. | | advancementCompleted | The player completes an advancement. | | dimensionChanged | The player enters a dimension. | | itemObtained | The player gets an item. | | itemCrafted | The player crafts an item. | | recipeUnlocked | The player unlocks a recipe. | | scoreboard | A score meets a comparison. | | worldPosition | The player enters or leaves an area. | | custom | A command or another mod fires it. |

⌨️ Commands

For operators (permission level 2+), command blocks and the server console:

/conditionalvideos play <targets> <condition> [delay <seconds>] [exclude <players>] [excludeteam <team>] [excludeops] [once] [sync]
/conditionalvideos stop <targets>
/conditionalvideos pause <targets>
/conditionalvideos reset <targets> <condition | all>

/conditionalvideos set defaultvolume <volume>
/conditionalvideos set volume <condition> <video_index> <volume>
/conditionalvideos set conditiondelay <condition> <seconds>
/conditionalvideos set startat <condition> <video_index> <seconds>
/conditionalvideos set title <condition> <video_index> [at_position <x> <y>] <text>
/conditionalvideos set description <condition> <video_index> [at_position <x> <y>] <text>
/conditionalvideos set titleposition <condition> <video_index> <position | x y>
/conditionalvideos set descriptionposition <condition> <video_index> <position | x y>

/conditionalvideos waitingroom start [force]
/conditionalvideos waitingroom join [targets]
/conditionalvideos waitingroom leave [targets]
/conditionalvideos waitingroom add <targets>
/conditionalvideos waitingroom remove <targets>

🗂️ Configuration

Each condition is a file:

config/conditionalvideos/
├─ conditions/          singleplayer and LAN host
│  ├─ firstJoin.json
│  ├─ entityKilled/minecraft/warden.json
│  ├─ advancementCompleted/minecraft/story/mine_diamond.json
│  ├─ scoreboard/kills.json
│  └─ worldPosition/spawn_area.json
└─ server-conditions/   dedicated server, same layout

Changes apply right away, also for connected players. The mod adds any missing option with its default at the top of the file and never changes what you wrote. A broken file is left untouched and reported in the log and in the chat. Configs from older versions migrate on the first launch and the originals stay as .bak.

{
  "repeatableInSameSession": false,
  "videos": [
    {
      "source": "videos/intro.mp4",
      "videoTitle": "&6&lWelcome",
      "videoVolume": 0.8,
      "nextAt": 8.0
    },
    {
      "source": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
      "transition": "fadeOut/In"
    }
  ]
}

Condition options