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

Go to file

ZhangYuheng e5e2d065a4 尝试添加purge功能		2024-10-08 17:26:56 +08:00
.gitea/workflows	更新了下载提示信息	2024-05-01 10:07:27 +08:00
.github/workflows	加入CI-CD脚本	2024-02-20 23:27:40 +08:00
src/main	尝试添加purge功能	2024-10-08 17:26:56 +08:00
.gitignore	实现了基本功能	2024-02-20 23:25:31 +08:00
pom.xml	尝试添加purge功能	2024-10-08 17:26:56 +08:00
README.md	更新 README.md	2024-08-20 20:48:17 +08:00

README.md

ColorfulMap

开源地址 | 文档地址

下载页面

统计页面 | Hangar

简介

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

说明

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

功能介绍

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

支持版本

1.20.1+ (Paper、Folia)

安装方法

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

玩家使用方法

首先需要将你想要转换的图片上传到图床，便于本插件从网络读取图片内容。上传完成后会得到一个图片的网络地址，复制此地址。
在游戏中输入指令：/tomap <图片地址> 即可获得一张地图

地图的lore中记录了此地图画的大小，下图中的 8x10 表明此地图画需要长8格、高10格的展示框阵列才能放置。
对着展示框阵列的左下角展示框摆放此地图，则会自动在墙上的剩余展示框内放置对应的地图。
如果图片太大或太小可以尝试在指令后加入缩放倍率，例如 /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

README.md Unescape Escape