ReColorfulMap
描述
ReColorfulMap 是一个将图片转换为图像地图的插件,可以挂在物品展示框上用于装饰。
这是对原版 ColorfulMap 插件的重制。原版插件会在 plugins 文件夹中留下大量图片缓存,并且每次服务器启动时都需要重新加载这些缓存。这不仅增加了服务器的启动时间,也提高了管理难度。
ColorfulMap 和 ReColorfulMap 的灵感来源于 ImageFrame 与 ImageMaps。你可以将其视为 ImageFrame 的精简版,以及 ImageMaps 的高配重制版。感谢他们出色的工作。
功能
- 将图片转换为图像地图;
- 图片缩放;
- 自动放置到物品框矩阵中;
- 支持消耗货币生成地图画作(需要 Vault 依赖);
- 从物品框矩阵自动取回地图 (新功能);
版本支持
使用方法
-
首先,你需要将想要转换的图片上传到 图床,以便该插件能够从网络读取图片内容。上传完成后,你会获得一个图片链接,复制这个地址即可。
-
在游戏中,输入命令:/tomap <你刚获取的url> 来生成一张地图:

由于一张地图最多只能容纳 128 x 128 像素的图像,因此 ReColorfulMap 会自动将你的图像拆分为多个图块。
无需担心处理这些图块,ReColorfulMap 会告诉你需要放置多少个物品框来展示这张图像,并自动将它们按正确的顺序摆放。
对于上面显示的这张图像,它显示为 8 x 13,这意味着你需要准备一个宽度为 8、高度为 13 的物品框矩阵来放置这张图像。
-
将地图放置在物品框矩阵的左下角,随后对应的地图将自动放置到墙上剩余的物品框中。

-
如果图片太大或太小,你可以在命令后添加一个缩放参数,
例如 /tomap <你刚获取的URL> 0.3 表示以原始大小的 30% 进行渲染。
如果你希望填充图片且在所有地图的边缘不留任何空白,
你需要确保你的图片分辨率是 128 的倍数。

服务器管理员
命令与权限
以下命令中的尖括号 <> 表示必填参数,方括号 [] 表示可选参数。
| 功能 |
命令 |
权限节点 |
默认值 |
| 生成 |
/tomap <image-url> [缩放比例] |
recolorfulmap.tomap |
true |
| 重载 |
/reloadColorfulMap |
recolorfulmap.admin |
op |
| 清理缓存 |
/cleanColorfulMap |
recolorfulmap.admin |
op |
注意:不要频繁运行 /cleanColorfulMap,它会删除所有已生成但未放置的图片。
配置参考
# 请勿修改此值。
version: 2
# 物品展示框矩阵的最大尺寸。
# 32 x 18 表示图像尺寸不能超过 4096 x 2304 像素。
# 不要将此值设置得过大,否则可能导致卡顿。
max-frame-x: 32
max-frame-y: 18
# 插件语言,其他语言请参阅 plugins/FurnitureCore/languages 文件夹。
language: en_us
# 启用经济系统。(需要 Vault 和经济类插件支持)
# 如果为 true,玩家每次创建地图都需要付费。
# 这可以防止玩家滥用该插件的功能。
economy:
enable: false
cost-per-map: 100.0
# 图片 URL 地址白名单,用于防止玩家使用不恰当的图片。
# 留空则允许所有地址。
address-white-list:
- ''
# 调试模式,报告 Bug 时请开启此选项。
debug: true
支持
邮箱:zhangyuheng@lunadeer.cn
GitHub:Issues
QQ群:309428300
bStats
ReColorfulMap
Description
ReColorfulMap is a plugin that converts images into image maps, which can be hung on item frames to add decoration.
This is a remake of the original ColorfulMap plugin. The original plugin leaves a lot of images cache in plugins folder,
and need to reload them every time the server starts. Which also increases the server startup time and management
difficulty.
Both ColorfulMap and ReColorfulMap's idea are from ImageFrame
and ImageMaps.
You can think it is a simplified version of ImageFrame and a high version remake of ImageMaps. Thanks for their great
work.
Features
- Convert images into image maps;
- Image scaling;
- Automatic placement to item frame matrix;
- Support for consuming money to generate map paintings (requires Vault dependency);
- Automatic get back maps from item matrix (new feature);
Version Support
Usage
-
First, you need to upload the image you want to convert to the image bed,
so that this plugin can read the image content from the network. After uploading,
you will get an url of the image, copy this address.
-
In the game, enter the command: /tomap <url-you-just-got> to get a map:

Because one map can only hold an image at the most of 128 x 128 pixels, so ReColorfulMap will split your image into
tiles automatically.
Don't worry about handling the tiles, ReColorfulMap will tell you how many item frames you need to place this image
maps
and place them in the correct order automatically too.
For this image shown above, it shows 8 x 13, which means you prepare a matrix of item frames 8 in width and 13 in
height to place this image.
-
Place the map in the bottom-left corner of the item frame matrix, then the corresponding maps will be placed in
the remaining item frames on the wall automatically.

-
If the image is too large or too small, you can try to add a scaling parameter after the command,
for example, /tomap <url-you-just-got> 0.3 means rendering at 30% of the original size.
If you want to fill the image without leaving any white space at the edges of all the maps,
you need to ensure that the resolution of your image is a multiple of 128.

For Server Owners
Commands & Permissions
The angle brackets <> in the following commands indicate required parameters, and the square brackets [] indicate
optional parameters.
| Function |
Command |
Permission Node |
Default |
| Generate |
/tomap <image-url> [scalling] |
recolorfulmap.tomap |
true |
| Reload |
/reloadColorfulMap |
recolorfulmap.admin |
op |
| Clean Cache |
/cleanColorfulMap |
recolorfulmap.admin |
op |
NOTICE: Don't run /cleanColorfulMap frequently, it will delete all the images generated but not placed.
Configuration Reference
# Do not modify this value.
version: 2
# The maximum size of item frame matrix.
# 32 x 18 means image can not be larger than 4096 x 2304 pixels.
# Don't set this value too large, it may cause lag.
max-frame-x: 32
max-frame-y: 18
# Language of the plugin, see others in the plugins/FurnitureCore/languages folder.
language: en_us
# Enable economy system. (Require Vault and an economy plugin)
# If true, players need to pay for each map they create.
# This may prevent players from abusing usage of the plugin.
economy:
enable: false
cost-per-map: 100.0
# The whitelist of image url address, use this to prevent players from using inappropriate images.
# Leave it empty to allow all addresses.
address-white-list:
- ''
# Debug mode, if report bugs turn this on.
debug: true
Support
Mail: zhangyuheng@lunadeer.cn
GitHub: Issues
QQ群:309428300
bStats
评论 0
登录后参与评分
还没有评论,来抢沙发吧