MapImage 插件
MapImage 是一个 Minecraft 插件,允许服务器管理员通过 /mapimage 命令将任何在线图片 URL 转换为游戏内的地图物品。地图数据会持久化存储,并在服务器重启后使用轻量级的 YAML 配置文件重新渲染,因此服务器无需占用大量空间来存储原始图片文件。
功能特性
- 将任意图片转换为 Minecraft 地图。
- 自动将图片颜色映射到最接近的 vanilla(原版)地图调色板。
- 在
config.yml 中存储 URL 与地图 ID 的对应关系,确保跨重启持久化。
- 限制仅服务器管理员或拥有相应权限的玩家可以使用该功能。
用法
命令
/mapimage <图片URL或文件名> [大小]
-
将来自给定 URL 或本地文件的 64×64 图像转换为地图。
-
支持 PNG、JPG、GIF、BMP 和 WEBP 格式的图像。
-
如果提供 size 参数(HxW),你可以获得一个地图矩阵(例如 2x3 会生成高 2 格、宽 3 格的图像,共 6 张地图),顺序为从左上角到右下角。
-
确保你的本地图片与 config.yml(MapImage/)位于同一文件夹中。
-
玩家会在其物品栏中获得已填充的地图。
? 确保该图片可从服务器访问(每次启动和重启都需要联网),且返回的是有效的图片格式(例如 PNG 或 JPEG)。
权限
| 权限节点 |
描述 |
默认值 |
mapimage.use |
允许使用 /mapimage 命令 |
仅限 OP |
注意事项
虽然本插件在处理少量图片时运行良好,但如果您拥有大量图片,可能会导致服务器内存占用增加。目前我们计划修复此问题,但在补丁发布之前,请注意服务器的内存占用可能会高于正常水平。
MapImage Plugin
MapImage is a Minecraft plugin that lets server operators turn any online image URL into an in-game map item using the /mapimage command. Maps are persisted and re-rendered after server restarts using a lightweight YAML config, so they require no large image file storage on the server.
Features
- Convert any image to a Minecraft map.
- Automatically maps image colors to the closest vanilla map palette.
- Stores URL ↔ map ID pairs in
config.yml to persist across restarts.
- Restricts usage to server operators or players with permission.
Usage
Command
/mapimage <image-url-or-filename> [size]
- Converts a 64×64 image from the given URL or local file into a map.
- Works for PNG, JPG, GIF, BMP, and WEBP images
- If argument size (HxW) you can get a matrix of maps (2x3 would give you 2 high, 3 wide image, 6 maps) and given in order from top left to bottom right
- Make sure your local images are located in the same folder as config.yml (MapImage/)
- The player receives the filled map in their inventory.
? Make sure the image is accessible from the server (internet access required on every start and restart) and returns a valid image format (e.g., PNG or JPEG).
Permissions
| Permission Node |
Description |
Default |
mapimage.use |
Allows using /mapimage |
OP only |
Notice
While this plugin works fine with small amounts of images, if you have excessive amounts of images it may cause increased server RAM usage. This is planned on being fixed at the moment, but beware that sometimes you may have your server's RAM higher than normal until the patch is released.
评论 0
登录后参与评分
还没有评论,来抢沙发吧