ColorfulMap/README.md

ColorfulMap

开源地址 | 文档地址

下载页面

统计页面 | Hangar

简介

用于将图片转换为地图画，悬挂在展示框上增添装饰。

说明

本插件大约相当于 ImageFrame的简版以及 ImageMaps 的高版本重制版。前者功能丰富，不过可能由于项目体量较大，对于新版本的兼容较慢，后者在1.18 开始就停止了更新，且不支持 Folia 核心。

功能介绍

• 将图片转换为地图画；
• 图片缩放；
• 自动放置；
• 支持消耗金钱生成地图画（需要 Vault 前置）；

支持版本

• 1.20.1+ (Paper、Folia)

安装方法

1. 将插件放入服务器的 plugins 目录下
2. 重启服务器
3. 在 plugins/ColorfulMap/config.yml 中配置
4. 重启服务器

玩家使用方法

1. 首先需要将你想要转换的图片上传到 图床 ，便于本插件从网络读取图片内容。上传完成后会得到一个图片的网络地址，复制此地址。

2. 在游戏中输入指令：/tomap <图片地址> 即可获得一张地图

   

   地图的lore中记录了此地图画的大小，下图中的 8x10 表明此地图画需要长8格、高10格的展示框阵列才能放置。

   

3. 对着展示框阵列的左下角展示框摆放此地图，则会自动在墙上的剩余展示框内放置对应的地图。

4. 如果图片太大或太小可以尝试在指令后加入缩放倍率，例如 /tomap <图片地址> 0.5 表示将以原图的50%大小渲染。如果你希望将图片填满所有地图边缘处没有留白，那么你需要保证你的图片的长宽分辨率均为128的倍数，因为在MC中一张地图的分辨率为128x128。

管理员指南

指令 & 权限节点

以下指令中尖括号 <> 表示必填，方括号 [] 表示选填。

功能	指令	权限节点	默认
生成地图画	/tomap <图片地址> [缩放倍率]	colorfulmap.tomap	true
重载配置	/reloadColorfulMap	colorfulmap.reload	op

如何查图

2.0版本开始地图画会保存一份玩家获取图片的原图，路径为 plugins/ColorfulMap/maps/{图片uuid}/raw.png ，方便服主快速查阅图片内容。

当玩家放置地图后还会同时保存一份元数据文件，plugins/ColorfulMap/maps/{图片uuid}/meta.txt，此文件记录了放置地图的玩家、放置时间、地图画的位置等信息。

配置文件参考

# 地图画阵列的最大尺寸 宽
MaxFrameX: 32

# 地图画阵列的最大尺寸 高
MaxFrameY: 18

# 是否启用经济系统 消耗玩家金钱生成地图画
Economy:
   Enable: false
   CostPerMap: 100.0  # 每张地图画的单价 - 3*3的地图画需要9张地图画 也就是 9*100 = 900

# 图床地址白名单，不在白名单中的图床将无法使用，留空表示不启用地址白名单
AddressWhiteList: []

CheckUpdate: true

Debug: false

建议与反馈

Mail: zhangyuheng@lunadeer.cn

QQ群：309428300

统计