Emage ?
专为现代 Paper 服务器打造的高性能图像与 GIF 渲染器。Emage 完全绕过了 Minecraft 沉重的默认地图 API,采用自定义数据包管道直接将媒体流式传输至玩家客户端。让你在不影响服务器性能的前提下,用流畅的动画自由装饰你的世界。
要求
- Java 22
- Paper 1.21 或更高版本
- PacketEvents(必需依赖)
安装
- 将
PacketEvents.jar和Emage-VERSION.jar放入你的plugins/文件夹。 - 启动服务器。
- 编辑
plugins/Emage/config.yml以调整各种限制或自定义消息。
用法
要显示图像,请在墙上以矩形网格放置画框。看向其中一个画框并运行 apply 命令。
命令
| 命令 | 描述 |
|---|---|
/emage apply-grid <列数> <行数> <URL> |
手动指定网格尺寸以应用图片/GIF。 |
/emage apply <url> |
自动检测帧网格并应用图像/GIF。 |
|---|---|
/emage remove |
移除网格及其相关文件。 |
/emage reload |
重新加载配置文件。 |
构建
mvn clean package
编译后的 jar 文件将输出到 target/ 目录。
Emage ?
A highly-optimized image and GIF renderer built for modern Paper servers. By completely bypassing Minecraft’s heavy default map API, Emage uses a custom packet pipeline to stream media directly to your players. You get the freedom to decorate your world with smooth animations without compromising server performance.
Requirements
- Java 22
- Paper 1.21 or higher
- PacketEvents (Required dependency)
Installation
- Place the
PacketEvents.jarandEmage-VERSION.jarinto yourplugins/folder. - Start the server.
- Edit
plugins/Emage/config.ymlto adjust various limits or customize messages.
Usage
To display an image, place Item Frames on a wall in a rectangular grid. Look at one of the frames and run the apply command.
Commands
| Command | Description |
|---|---|
/emage apply-grid <columns> <rows> <url> |
Manually specify the grid size to apply the image/GIF. |
/emage apply <url> |
Auto-detects the frame grid and applies the image/GIF. |
/emage remove |
Remove the grid and its files. |
/emage reload |
Reload the configuration. |
Building
mvn clean package
The compiled jar will be output to the target/ directory.
下载 Emage
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Emage
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Emage
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Emage
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Emage
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Emage
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Emage
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Emage
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Emage
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Emage
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
此次更新带来了全面的稳定性改进、优化的存储与网格检测,以及针对服务器管理员和玩家的重要生活质量功能。网络数据包处理与内存分配经过重度优化以支持更大的网格,同时启动时间与并发处理能力得到完善,确保在高负载下运行流畅。
性能与存储
- 平面文件帧存储: 图像帧数据现在保存到文件系统中而非数据库。这防止了数据库膨胀,并显著加快了大型 GIF 的读写操作速度。
- 单线程数据库写入器: 所有数据库写入现在在后台按顺序处理。这消除了数据库锁错误,并提高了多名玩家同时应用图像时的稳定性。
- 批量地图 ID 分配: 虚拟地图 ID 现在通过单次操作安全生成。这修复了在多名玩家同时应用图像时可能导致地图 ID 重叠的竞争条件。
- 主线程延迟减少: 动画网格的可见性检查不再在主服务器线程上执行重型计算。这消除了多名玩家靠近动画墙壁时出现的周期性延迟尖峰。
- 更流畅的大型 GIF 处理: 处理大型动态图像现在复用内部图像和内存缓冲区,而不是为每一帧分配新的缓冲区。这防止了垃圾回收卡顿,并将处理期间的内存使用量减少了高达 80%。
- 优化的网格检测: 网格自动检测现在使用高度优化的内部查找。这降低了内存使用量并加快了大型网格的检测过程。
- 数据库哈希索引: 添加了用于文件哈希查找的索引。这确保即使有大量已应用图像的历史记录,缓存检查也能保持快速。
- 修复网络流泄漏: 图像下载后网络连接现在正确关闭,防止因随时间推移耗尽文件描述符而导致的服务器崩溃。
- 修复堆外内存泄漏: 如果图像处理中途失败,内存现在会正确释放,防止静默内存耗尽和 JVM 崩溃。
- 共享全局缓存预算: 动画帧现在共享单一且严格的内存预算,而不是每张图片获得各自的分配。这防止了在放置许多 GIF 时导致服务器崩溃。
- 即时启动颜色生成: 启动时的颜色处理现在从预计算的文件加载,将启动时间缩短数秒,并消除 CPU 尖峰。
- 合并线程池: 后台任务现在使用统一的有界线程池系统。这防止了在线程爆炸和 CPU 饥饿期间进行大量并发图像处理时的问题。
- 数据库查询优化: 添加了 URL 查找所需的缺失数据库索引,消除了当玩家使用之前已渲染的 URL 时出现的延迟尖峰。
网络与连接
- 平衡的数据包节流: 调整了网络限制,允许大型网格(最大 10x10)在一个刻内平滑更新,同时将每个玩家的总带宽限制在 40 Mbps。这防止了标准连接上的网络超时。
- 智能延迟恢复: 如果玩家的网络连接落后,服务器现在会丢弃旧帧并立即同步到当前帧。这防止了在临时网络尖峰期间出现 erratic、延迟的播放。
生活质量
- 更清晰的错误消息: 网络错误(如未知主机、连接超时和 SSL 问题)现在被翻译成给玩家看的通俗英语消息。
- 安全的撤销链接: 聊天中的“撤销”按钮现在针对其生成的确切渲染。如果您在查看不同渲染时点击撤销,该操作将被阻止以防止意外删除。
- 视野检测: 网格现在基于它们是否在玩家的屏幕上可见来激活,而不是需要精确的准星瞄准。这在靠近大型墙壁时提供更自然的播放体验。
- 自动冷却清理: 玩家冷却数据现在在过期后自动移除,防止在长期运行的高人口服务器上缓慢的内存增长。
- 可变 GIF 帧计时: GIF 现在尊重每一帧的单独延迟计时。具有可变速度的动画将完全按照最初意图播放,而不是以恒定速度播放。
错误修复与稳定性
- 网络缓冲区泄漏修复: 修复了一个竞争条件,即动画数据可能在等待发送给玩家时被清除出内存。这防止了随机断开连接和视觉损坏。
- 同步可见性检查: 动画的视线检查现在在主服务器线程上运行。这修复了一个可能导致区块损坏或服务器崩溃的严重稳定性问题。
- 虚拟线程关闭: 当插件禁用时,后台进程现在正确关闭。这防止了在服务器重启时发生资源泄漏。
- 网格边界强制: 将图像应用到空框架时,如果它们物理接触,将不再渗入现有的渲染中。覆盖现有渲染也将严格限制在其原始网格边界内。
- 网格边界检测: 将图像放置在现有图像旁边时,不再因检测错误而失败。检测现在尊重填充物品框架的物理边界。
- 精确网格放置: 指定确切尺寸现在使用点击的框架作为左上角,允许在复杂的墙壁布局中进行精确放置。
- 无卡顿动画加载: GIF 在从磁盘加载帧时不再暂停其动画。缺失的帧现在异步加载,而不会阻塞渲染线程。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
自定义你的Minecraft头像!
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
评论 0
登录后参与评分
还没有评论,来抢沙发吧