# MapEngine Media Extension logo

[![GitHub tag (latest by date)](https://img.shields.io/github/v/tag/MinceraftMC/MapEngine-MediaExtension?style=flat-square)](#) [![AGPLv3 License](https://img.shields.io/badge/License-AGPL%20v3-yellow.svg?style=flat-square)](https://opensource.org/license/agpl-v3/) [![Status Beta](https://img.shields.io/badge/Status-Beta-orange?style=flat-square)](#) ## Description MapEngine Media Extension is an extension library for [MapEngine](https://modrinth.com/plugin/mapengine). It provides an additional API for playing video and streaming live content using MapEngine. The Extension uses [bytedeco/javacv's](https://github.com/bytedeco/javacv) FFmpeg implementation for decode media. JavaCV, JavaCPP and FFmpeg will be downloaded on server startup and loaded into the classpath. This plugin downloads only the currently needed libraries for the current operating system and architecture. ## Features - Runtime dependency downloader - FFmpeg based media decoding

Downloading native libraries

This is an example of native libraries being downloaded on server startup. ![RuntimeDependencyLoading](https://i.imgur.com/GMWH9NW.gif)

Live streaming via RTMP on maps

This is an example of a live stream on a map. The stream is played on a 7x4 map array. The Stream source is 1920x1080@20 streamed with OBS.

## Usage `MapMediaExt` has to be added as a dependency to the `plugin.yml` regardless of the build system used.

Maven

```xml minceraft https://repo.minceraft.dev/releases/ ``` ```xml de.pianoman911 mapengine-mediaext 1.1.2 provided ```

Gradle (groovy)

```groovy repositories { maven { url = 'https://repo.minceraft.dev/releases/' name = 'minceraft' } } dependencies { compileOnly 'de.pianoman911:mapengine-mediaext:1.1.2' } ```

Gradle (kotlin)

```kotlin repositories { maven("https://repo.minceraft.dev/releases/") { name = "minceraft" } } dependencies { compileOnly("de.pianoman911:mapengine-mediaext:1.1.2") } ```

### Example ```java public class Bar { public void foo(IMapDisplay display, URI streamUri) { // create a drawing space for the display IDrawingSpace space = plugin.mapEngine().pipeline().drawingSpace(display); // add all online players as receivers space.ctx().receivers().addAll(Bukkit.getOnlinePlayers()); // create a new frame source with a 10 frame buffer and rescaling enabled FFmpegFrameSource source = new FFmpegFrameSource(streamUri, 10, space, true); // start the decoding process source.start(); } } ``` More detailed examples can be found in the [MinceraftMC/MapEngineExamples](https://github.com/MinceraftMC/MapEngineExamples) repository. ## Building 1. Clone the project (`git clone https://github.com/MinceraftMC/MapEngine-MediaExtension.git`) 2. Go to the cloned directory (`cd MapEngine-MediaExtension`) 3. Build the Jar (`./gradlew build` on Linux/MacOS, `gradlew build` on Windows) The plugin jar can be found in the `build` → `libs` directory.