MapEngine

MapEngine

Description

MapEngine is a map library plugin for paper servers. It provides a simple API to create maps with custom content.
Using lightweight and asynchronous techniques, MapEngine has a very low impact on server performance.

Features

• Pipelined API for custom pipelines
• Asynchronous rendering
• Completely packet based
• Optional dithering (Floyd-Steinberg)
• Groups as z-layer interpretation for saving immense network traffic
• Per player buffering, only the changed pixels are sent to the player
• Optional packet bundling prevents tearing
• Drawing utilities (text, components, lines, triangles, rectangles, circles, ellipses, polygons)

Javadoc

A hosted version of the javadoc can be found here.

Support

Server Version	Supported
Paper 1.21.11
Paper 1.21.10
Paper 1.21.9
Paper 1.21.8
Paper 1.21.7
Paper 1.21.6
Paper 1.21.5
Paper 1.21.4
Paper 1.21.3
Paper 1.21.2
Paper 1.21.1
Paper 1.21
Paper 1.20.x
Paper 1.19.4
Paper 1.19.3

Usage

MapEngine has to be added as a dependency to the plugin.yml regardless of the build system used.

<repositories>
    <repository>
        <id>minceraft</id>
        <url>https://repo.minceraft.dev/releases/</url>
    </repository>
</repositories>

<dependencies>
    <dependency>
        <groupId>de.pianoman911</groupId>
        <artifactId>mapengine-api</artifactId>
        <version>1.8.11</version>
        <scope>provided</scope>
    </dependency>
</dependencies>

repositories {
    maven {
        url = 'https://repo.minceraft.dev/releases/'
        name = 'minceraft'
    }
}

dependencies {
    compileOnly 'de.pianoman911:mapengine-api:1.8.11'
}

repositories {
    maven("https://repo.minceraft.dev/releases/") {
        name = "minceraft"
    }
}

dependencies {
    compileOnly("de.pianoman911:mapengine-api:1.8.11")
}

Example

public class Bar {

    // getting the api instance
    private static final MapEngineApi MAP_ENGINE = Bukkit.getServicesManager().load(MapEngineApi.class);

    public void foo(BufferedImage image, BlockVector cornerA, BlockVector cornerB, BlockFace facing, Player viewer) {
        // create a map display instance
        IMapDisplay display = MAP_ENGINE.displayProvider().createBasic(cornerA, cornerB, facing);
        display.spawn(viewer); // spawn the map display for the player

        // create an input pipeline element
        // this object can also be used to draw simple shapes and text
        IDrawingSpace input = MAP_ENGINE.pipeline().createDrawingSpace(display);

        // draw the image to the input pipeline element
        input.image(image,0,0);

        // draw a triangle
        input.triangle(0, 0, 10, 10, 20, 0, 0xff0000ff);

        // add a player to the pipeline context,
        // making the player receive the map
        input.ctx().receivers().add(viewer);

        // enable floyd-steinberg dithering
        input.ctx().converter(Converter.FLOYD_STEINBERG);

        // enable per player buffering
        input.ctx().buffering(true);

        // flush the pipeline
        // the drawing space can be reused
        input.flush();
    }
}

More detailed examples can be found in
the MinceraftMC/MapEngineExamples repository.

Building

1. Clone the project (git clone https://github.com/MinceraftMC/MapEngine.git)
2. Go to the cloned directory (cd MapEngine)
3. Build the Jar (./gradlew build on Linux/MacOS, gradlew build on Windows)

The plugin jar can be found in the build → libs directory