ConditionalVideos

<div align="center"> # 🎬 ConditionalVideos Server-aware cinematic triggers for Minecraft. Configure conditions once and let clients play synced videos — local files, URLs, or full playlists — exactly when it matters. (https://img.shields.io/modrinth/dt/conditionalvideos?style=for-the-badge&logo=modrinth&label=Modrinth&color=00AF5C&logoColor=white)](https://modrinth.com/mod/conditionalvideos) (https://img.shields.io/curseforge/dt/1521845?style=for-the-badge&logo=curseforge&label=CurseForge&color=f16a20&logoColor=white)](https://www.curseforge.com/minecraft/mc-mods/conditionalvideos) (https://img.shields.io/badge/Fabric-1.20.1%20%7C%201.21.1%20%7C%201.21.11%20%7C%2026.1.2%20%7C%2026.2-dbd0b4?style=for-the-badge)](https://fabricmc.net/) (https://img.shields.io/badge/Forge-1.20.1-e04e14?style=for-the-badge)](https://minecraftforge.net/) (https://img.shields.io/badge/NeoForge-1.21.1%20%7C%201.21.11%20%7C%2026.1.2%20%7C%2026.2-f98010?style=for-the-badge)](https://neoforged.net/) (https://img.shields.io/badge/Env-Client%20%26%20Server-4a90d9?style=for-the-badge)](https://modrinth.com/mod/conditionalvideos) (https://img.shields.io/badge/Docs-Wiki-0969da?style=for-the-badge&logo=github&logoColor=white)](https://github.com/MateoF024/conditionalvideos/wiki) (https://img.shields.io/badge/Report-Issues-red?style=for-the-badge&logo=github&logoColor=white)](https://github.com/MateoF024/conditionalvideos/issues) </div> --- ## ✨ Overview ConditionalVideos plays custom videos when specific in-game events are detected — first joins, deaths, kills, advancements, item milestones, scoreboard thresholds, and more. It runs on **both client and dedicated server**: the server detects conditions and tells the right client what to play, while the client handles the actual playback. This makes it a good fit for servers, story maps, quest packs, and roleplay setups where cinematic feedback improves immersion. **Highlights** - A dozen trigger types, from `firstJoin` to scoreboard thresholds and mod-defined custom conditions. - Per-condition **playlists** with crossfade/cut transitions, looping, text overlays, per-clip volume, and timed cuts. - Broad source support through **WATERMeDIA** — local files, direct URLs, YouTube in high quality, Twitch/Kick clips, TikTok, SoundCloud, and many more. - A **playback queue** so overlapping triggers play in sequence instead of cutting each other off. - A small **public API** for other mods (see the project Wiki). --- ## 🧩 Compatibility & 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+ | > On **26.2** the game can run with either renderer. Videos play on both, but support for the **Vulkan > renderer is experimental** — Minecraft ships it as an opt-in preview, so OpenGL remains the safest > choice if you hit trouble. **Required (client side):** - (https://modrinth.com/mod/watermedia) — **v3.0.0.23+** - (https://modrinth.com/mod/watermedia-binaries) — **v3.0.0.6+** - (https://modrinth.com/mod/fabric-api) — **any** (Fabric Only) **Config files**: - `config/conditionalvideos.json` — client / singleplayer rules - `config/conditionalvideos-server.json` — authoritative rules for a dedicated server - `config/conditionalvideos-common.json` — client playback behavior (also read by servers for the synced options) In multiplayer the dedicated server owns the config, ships any local video files to clients automatically (cached and reused on reconnect), and URLs are streamed directly by each client. Treat `conditionalvideos-server.json` as the source of truth for server content. --- ## 🎯 Supported Conditions Each condition is configured with a **playlist**. Simple conditions use a single config key; keyed conditions are a map of `id → condition`. **Simple** (single key): - `firstJoin` — plays when the player enters the world/session. **Always prioritized**: if other conditions fire during world load, `firstJoin` plays first and the rest queue behind it. - `playerDeath` — fallback cinematic for any death. - `totemUsed` — a Totem of Undying saves the player. - `bedSleep` — the player starts sleeping in a bed. **Keyed** (map of `id → condition`): - `deathByEntity` — death by a specific killer entity ID (overrides `playerDeath`). - `entityKilled` — the player defeats a configured entity ID. - `advancementCompleted` — a configured advancement is completed. - `dimensionChanged` — the player enters a configured dimension. - `itemObtained` — the player obtains a configured item (pickup, craft, or smelt result). - `itemCrafted` — a configured item is actually crafted (independent from `itemObtained`). - `recipeUnlocked` — a confi