VPlayer

Play videos on multi-block screens: Bilibili/HTTP links or local files, in-game controls, positional audio, any screen shape. NeoForge & Forge, MC 1.20.1-1.21.11.
# VPlayer

 

Play videos on multi-block screens in Minecraft — Bilibili/HTTP links or local files, with an in-game
control screen, positional audio, and any screen shape.

 

Supports **NeoForge and Forge** on **Minecraft 1.20.1 / 1.21.1 / 1.21.11**.

 

## Features

 

- **Video playback** — HTTP(S) links or local video files. Bilibili CDN links automatically get the
  right Referer/User-Agent.
- **Control screen** — progress bar (click or drag to seek), play / pause / stop, ±10 seconds, volume,
  playback speed (0.5x–2x) and loop toggle.
- **Multi-block screens** — screen blocks with the same facing merge into one big screen automatically;
  the video is drawn seamlessly across blocks.
- **Any screen shape** — L-shaped and notched screens work. Video only shows on real screen blocks
  (holes stay empty), and a stray extra block does not stretch the picture. Completing a full
  row/column enlarges the screen.
- **Positional audio** — each screen has its own audio range (default 40, max 64 blocks) that fades
  with distance, calculated per player.
- **Full block model** — screen on the front, bezel on the sides, slightly glowing at night; the item
  icon is a 3D block.
- **Pause / resume in place** — resuming continues from the exact frame, without reloading or jumping.
- **Structure changes** — when the big screen changes shape, playback moves to the new master block
  without interruption.
- **Crafting and drops** — smooth stone corners, redstone top-middle, redstone lamp bottom-middle,
  red/green/blue stained glass panes; yields 4. Breaking the block drops the screen item.

 

## Versions

 

| Minecraft | Loader | Java |
| --- | --- | --- |
| 1.20.1 | NeoForge 47.1.106 / Forge 47.4.28 | 17 |
| 1.21.1 | NeoForge 21.1.265 / Forge 52.1.21 | 21 |
| 1.21.11 | NeoForge 21.11.48 / Forge 61.2.5 | 21 |

 

Install the file that matches your **Minecraft version + mod loader**. The jar bundles the
FFmpeg/JavaCV native libraries (~120 MB), so no extra downloads or dependencies are needed.

 

## Multiplayer

 

Video decoding and audio happen on each client, while the screen state (URL, loop, controls) is
synced from the server. For multiplayer, install VPlayer on **both the server and the clients**.

 

## Known issues

 

- Brightness dims when the crosshair gets close to a screen (rendering quirk, not fixed yet).
- `InterruptedException: sleep interrupted` can appear in logs when stopping/switching videos —
  harmless and expected.

 

## Links

 

 

## License

 

MIT. Independent mod, not affiliated with Mojang Studios or Microsoft. Video decoding is powered by
JavaCV/FFmpeg.
```

VPlayer Team

profile avatar
  • 1
    Projects
  • 76
    Downloads