MapEngine

插件

· 作者 booky10

MapEngine 是一个用于 Minecraft Paper 服务器的地图库插件,用于在地图上显示图像和视频/流媒体内容。

0 本站下载 0 关注 更新于 6 个月前

最新 1.8.12 · 26.1.2 · Paper / Purpur

一键开服(送7天)

MapEngine

描述

MapEngine 是一个面向 Paper 服务器的地图库插件。它提供了一个简单的 API,用于创建包含自定义内容的地图。 通过采用轻量级和异步技术,MapEngine 对服务器性能的影响非常小。

特性

  • 用于自定义管道的流水线 API
  • 异步渲染
  • 完全基于数据包
  • 可选抖动处理(Floyd-Steinberg)
  • 将图层组解释为 Z 层,以节省巨大的网络流量
  • 按玩家进行缓冲,仅向玩家发送更改的像素
  • 可选的数据包捆绑可防止撕裂现象
  • 绘图工具(文本、组件、线条、三角形、矩形、圆形、椭圆、多边形)
颜色转换缓存性能图表
地图上的 RTMP 实时流媒体 这是一个在地图上播放直播流的示例。该流在一个 7x4 的地图数组上播放。 流源为 1920x1080@20,使用 OBS 进行推流。
Floyd-Steinberg 抖动效果 这是一个启用了 Floyd-Steinberg 抖动效果的地图示例。该流在一个 7x4 的地图数组上播放。 流源为 1920x1080@20,使用 OBS 进行推流。

Javadoc

托管版本的 Javadoc 请参阅 此处。

支持

服务器版本 是否支持
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 ✔️

用法

无论使用何种构建系统,都必须在 plugin.yml 中将 MapEngine 添加为依赖项。

Maven
<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>
Gradle (groovy)
repositories {
    maven {
        url = 'https://repo.minceraft.dev/releases/'
        name = 'minceraft'
    }
}

dependencies {
    compileOnly 'de.pianoman911:mapengine-api:1.8.11'
}
Gradle (kotlin)
repositories {
    maven("https://repo.minceraft.dev/releases/") {
        name = "minceraft"
    }
}

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

示例

public class Bar {

    // 获取 API 实例
    private static final MapEngineApi MAP_ENGINE = Bukkit.getServicesManager().load(MapEngineApi.class);

    public void foo(BufferedImage image, BlockVector cornerA, BlockVector cornerB, BlockFace facing, Player viewer) {
        // 创建地图显示实例
        IMapDisplay display = MAP_ENGINE.displayProvider().createBasic(cornerA, cornerB, facing);
        display.spawn(viewer); // 为玩家生成地图显示

        // 创建输入管道元素
        // 此对象也可用于绘制简单的形状和文本
        IDrawingSpace input = MAP_ENGINE.pipeline().createDrawingSpace(display);

        // 将图像绘制到输入管道元素中
        input.image(image,0,0);

        // 绘制一个三角形
        input.triangle(0, 0, 10, 10, 20, 0, 0xff0000ff);

        // 将玩家添加到管道上下文中,
        // 使玩家接收地图数据
        input.ctx().receivers().add(viewer);

        // 启用 Floyd-Steinberg 抖动效果
        input.ctx().converter(Converter.FLOYD_STEINBERG);

        // 启用按玩家缓冲
        input.ctx().buffering(true);

        // 刷新管道
        // 绘图空间可以被重用
        input.flush();
    }
}

更详细的示例可以在 MinceraftMC/MapEngineExamples 仓库中找到。

构建

  1. 克隆项目 (git clone https://github.com/MinceraftMC/MapEngine.git)
  2. 进入克隆的目录 (cd MapEngine)
  3. 构建 Jar 文件 (./gradlew build on Linux/MacOS, gradlew build on Windows)

插件 jar 文件位于 build → libs 目录中

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源