WATERMeDIAdrop

Give compatible mods the tools to bring moving pictures, sound, and images into Minecraft. WATERMeDIA handles media loading, decoding, and playback behind the scenes, while the mod using it supplies the screens, controls, and gameplay interactions.

**This is an API and library.** Installing it alone does not add televisions, radios, display blocks, recipes, or a player-facing media menu.

**Artwork disclosure:** The project icon is AI-generated branding artwork. It represents the library's identity and does not depict an in-game item, block, or interface.

## What it provides

- **Video and audio playback:** A shared media API with playback controls, seeking, volume, repeat, and playback-state reporting, backed by FFmpeg for video and audio decoding.
- **Image handling:** Codec APIs for static and animated images, with readers for formats including PNG, JPEG, GIF, WebP, and SVG.
- **Media sources:** Infrastructure for loading media links and resolving supported online sources. Source availability, access restrictions, and the integrating mod determine which links can play.
- **Rendering and sound:** Media engines that integrating mods can use to present decoded pictures and audio in their own displays and environments.
- **Synchronization tools:** A playback-session API for developers building shared viewing or listening features. The integrating mod must connect that API to its own networking and session rules.

## Installation and requirements

1. Use a mod that explicitly supports the WATERMeDIA version you are installing.
2. Select files matching your Minecraft version and loader.
3. For the standard FFmpeg playback setup, install the matching [WATERMeDIA: Binaries](https://www.curseforge.com/minecraft/mc-mods/watermedia-binaries) companion on each playback client as well.

The supplied setup uses **WATERMeDIA 3.0.0.23** with **Binaries 3.0.0.6**, and the local integration targets **Minecraft Java Edition 1.21.1 with NeoForge**. The library's JAR declares Java 17 or newer; use the Java version required by your Minecraft installation, including Java 21 for Minecraft 1.21.1.

The [3.0.0.23 file listing](https://www.curseforge.com/minecraft/mc-mods/watermedia/files/8519098) also lists Minecraft **1.18.2, 1.19.2, 1.20.1, 1.21.11, 26.1.2, and 26.2**, with **Fabric, Forge, and NeoForge** loader tags. These are file-level compatibility tags, not a promise that every loader supports every listed game version. Choose the combination supported by your game and integrating mod.

## Singleplayer and multiplayer

Media playback runs on each viewing or listening client. In multiplayer, shared playback depends on the mod providing the media feature; this library does not automatically synchronize every screen or stream when installed.

Follow that mod's instructions for server installation. In the supplied Afterfall integration, the server maintains TV and radio state without requiring these optional media dependencies; clients install both components to play linked video or audio. Those televisions and radios are Afterfall features.

Online media requires a working connection to its source, and some sources may require helper downloads. Installing the library does not grant access to restricted media or guarantee that a third-party service will continue to work.

## Configuration

The supplied build registers TOML configuration for media quality, cache limits and cleanup, FFmpeg behavior, hardware acceleration, decoder settings, and network behavior. Exact options depend on the installed version. Playback buttons, display settings, and gameplay permissions belong to the integrating mod.

## Development and compatibility

**Version 3.0.0.23 is marked Beta on CurseForge.** Version 3 is incompatible with integrations written for version 2. Use the major version your mod requires rather than upgrading a dependency independently.

This release also changes the binary signatures of `start()` and `startPaused()` compared with 3.0.0.22. Integrations compiled against those earlier signatures need recompilation for 3.0.0.23.

The features above describe the supplied build and its APIs. No additional gameplay content or future roadmap is promised here. Library APIs and online-source support may change during beta development.

## Credits and support

Created by **SrRapero720 / WaterMedia Team**, with multimedia decoding powered by **FFmpeg**. The supplied JAR identifies its license as **PolyForm Strict License 1.0.0**; bundled components retain their respective licenses.

For version-specific information and library issues, use the [original project](https://www.curseforge.com/minecraft/mc-mods/watermedia) and its [issue tracker](https://github.com/WaterMediaTeam/watermedia/issues). For problems with a particular screen, radio, or gameplay control, report them to the mod providing that feature.