CineFrame

Play real video clips on item frames (maps) with synced audio on a Minecraft Java server.

For video preview go here

Features

• Turns a wall of item frames into a video screen (20 FPS)
• Synced audio via an auto-built server resource pack that the plugin hosts
• Pause and resume, with audio re-trimmed so it stays in sync
• Optimized map updates using PacketEvents (only sends changed tiles)

Requirements

• Minecraft Java server (Paper, Purpur, Pufferfish, Leaf)
• PacketEvents installed
• Windows server (this build auto-downloads FFmpeg on Windows only)

Install

1. Drop PacketEvents and CineFrame into your plugins/ folder.
2. Restart the server.
3. Put videos in plugins/CineFrame/media/ (mp4, mov, webm, mkv, avi).
4. Set your resource pack host in config.yml so players can download the audio pack (if set up incorrectly you will not hear audio).

Config (important for audio)

These keys are used by CineFrame to host the resource pack zip:

# Port used for datapack download for users
datapack-port: 25564

# Public URL or IP (remote players)
# Do not include http:// or https://
# You can find your public ip at https://whatismyipaddress.com/
# Or use a domain if you already have one set up
datapack-public-host: "mydomain.com"
datapack-scheme: "http"
datapack-public-port: 25564

# LAN URL (players on the same network as the server)
# IMPORTANT: this should be the SERVER'S LAN IP, not localhost
# To find it on Windows:
# Press "Win + R"", type cmd and press enter, type "ipconfig" and press enter,
# scroll down to find the IPv4 for the current Ethernet adapter that you are using.
datapack-local-host: "10.0.0.420"
datapack-local-scheme: "http"
datapack-local-port: 25564

# Loopback URL (only for clients connected from 127.0.0.1 or ::1)
datapack-loopback-host: "localhost"
datapack-loopback-scheme: "http"
datapack-loopback-port: 25564

# Debug logging for pack choice (who got what URL)
datapack-debug-pack-url: false

# Debug logging for the HTTP server (shows every request and response)
datapack-http-debug: false
datapack-http-log-headers: false

Usage

1. Place a screen:

   • /media <filename>
   • Left-click 2 blocks to pick opposite corners of the rectangle
   • CineFrame spawns the item frames and shows a poster frame

2. Start or resume:

   • /play [id]

3. Pause:

   • /pause [id]

4. Remove:

   • /delmedia <id>
   • or /delmedia <x> <y> <z> (finds a display that matches those coords)

Notes:

• If you have more than one active display it might cause some issues. If you want audio for all of them it wont work, right now audio only runs on 1 display at a time.
• For simplicity sake for the alpha some other sacrafices where made like just applying the audio resource pack and play back to all players.
• Larger videos will take more time to load, each time you pause the video the audio is reproccessed so give it time to do so, audio is not done until you get the resource pack update screen.
• If you run into any issue just let me know in the discord.