ServerMultimediaManager (Server Side)

This mod is responsible for managing and broadcasting multimedia playback (videos and audios) to connected clients on the server. It does not render visual or auditory content on its own; instead, it synchronizes the media state with players in the world.

Features

• Synchronization of videos on polygonal areas (Canvas).
• Synchronization of audio at spherical points (Speakers).
• Seamless queue and playlist systems for both canvases and speakers.
• Smart three-dimensional volume attenuation.
• Raycast support for easily spawning and manipulating screens and speakers using your crosshair.

Commands (Operator Permission Required)

Video Commands

• /playvideo canvas spawn <pos1> [pos2] [url] [volume] [loop/repetitions] [isDual] - Spawns a new canvas. Supports raycast if pos2 is omitted.
• /playvideo canvas set <url> [volume] [loop/repetitions] - Modifies the targeted canvas face.
• /playvideo canvas remove - Removes the targeted canvas.
• /playvideo canvas queue <url> - Adds a video to the targeted canvas queue.
• /playvideo canvas skip - Skips the current video on the targeted canvas.
• /playvideo canvas playlist - Displays the queue for the targeted canvas.
• /playvideo canvas clear - Clears the queue and stops playback on the targeted canvas.
• /playvideo <targets> <url> [volume] [canLeave] - Plays a video on the player's personal UI.

Audio Commands

• /playaudio speaker spawn [pos] [url] [minRadius] [maxRadius] [volume] [loop/repetitions] - Spawns an invisible audio speaker. Supports raycast if pos is omitted.
• /playaudio speaker set <url> [minRadius] [maxRadius] [volume] [loop/repetitions] - Modifies the targeted speaker.
• /playaudio speaker remove - Removes the targeted speaker.
• /playaudio speaker queue <url> - Adds an audio track to the targeted speaker queue.
• /playaudio speaker skip - Skips the current audio on the targeted speaker.
• /playaudio speaker playlist - Displays the queue for the targeted speaker.
• /playaudio speaker clear - Clears the queue and stops playback on the targeted speaker.
• /playaudio <targets> <url> [volume] - Plays audio on the player's personal UI.

Detailed Command & Feature Usage Guide

1. Crosshair Raycast Targeting

When executing spawn, set, remove, or queue commands:

• Automatic Positioning: If you omit coordinates in /playvideo canvas spawn <pos1> or /playaudio speaker spawn, the second corner or position will automatically snap to the exact block or entity you are looking at.
• Directional Targeting: When using /playvideo canvas set, queue, or skip, looking directly at the front or back face of a canvas will automatically target and modify that specific side independently!

2. Canvases (In-World Video Screens)

• Spawn a Screen: /playvideo canvas spawn ~ ~ ~ (Spawns a screen starting at your position, snapping the opposite corner to where your crosshair points).
• Set Video URL: /playvideo canvas set https://example.com/video.mp4 100 0 (Applies the video to the face you are currently looking at, set to 100% volume and infinite loop).
• Queueing Videos:
  • /playvideo canvas queue https://example.com/video2.mp4 (Adds video to the end of the queue).
  • /playvideo canvas skip (Skips to the next video in queue).
  • /playvideo canvas playlist (Displays current playing video and upcoming queue).
  • /playvideo canvas clear (Clears the queue).

3. Spherical Audio Speakers

• Spawn a Speaker at Crosshair: /playaudio speaker spawn (Creates an invisible sound speaker right where you are aiming).
• Configure Radius & Media: /playaudio speaker set https://example.com/audio.mp3 5 15 100 1 (Sets full volume up to 5 blocks, fading out smoothly to 0% at 15 blocks, playing once).
• Queueing Audios:
  • /playaudio speaker queue https://example.com/song2.mp3
  • /playaudio speaker skip
  • /playaudio speaker playlist

4. Local Media & Datapack Support

In addition to HTTP/HTTPS URLs, you can play local media without external links:

• Place audio files in world/play/audio/<filename.mp3>
• Place video files in world/play/video/<filename.mp4>
• Use the filename directly in commands: /playvideo canvas set my_video.mp4 or /playaudio speaker spawn my_song.mp3.

Requirements

• Forge for Minecraft 1.19.2.
• It is strictly required to have the companion mod ClientMultimediaPlayer installed on the Client side to actually see and hear the media.