Video Api Nicktale

# Video API Nicktale

A standalone media engine that lets mods play **video and audio from a URL** inside Minecraft. It is the engine behind **Video Frame Nicktale** and **Nightclub & Party Mod**.

## Features
- **Video + audio** from direct links (MP4, WebM, MP3, OGG, images)
- **Live streams and radios** (HLS `.m3u8`) with automatic reconnect
- **YouTube, Twitch, Kick, TikTok, X and more** through yt-dlp
- **Positional 3D sound** with OpenAL: it gets louder as you walk closer
- **Audio-synced video**: the sound sets the clock, so lips match the voice
- **Fast seeking** and looping
- **Audio-only mode** for jukeboxes and radios, with live PCM data for visualizers and equalizers
- Clear chat messages when a link can't be opened

## Installation
Drop the jar into your `mods` folder **on the client**. Servers don't need it.
Nothing else to install: FFmpeg is included.

The first time you open a YouTube/Twitch/Kick link, the official **yt-dlp** (~23 MB) is downloaded automatically from its GitHub release, checked against its official SHA-256 checksum, and saved in `config/nicktale_video/`. Direct links and radios don't need it.

## For developers
```java
MediaHandle media = NicktaleVideo.open(url);       // video + audio
MediaHandle music = NicktaleVideo.openAudio(url);  // audio only
// every tick: media.tick(); then draw media.texture()