Skip to content

Latest commit

 

History

History
105 lines (61 loc) · 3.77 KB

README.md

File metadata and controls

105 lines (61 loc) · 3.77 KB
Raw

简介

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

说明

本插件大约相当于 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: [email protected]

QQ群：309428300

统计

bstats