|
| 1 | +<div align="center"> |
| 2 | + |
| 3 | +# ReColorfulMap |
| 4 | + |
| 5 | +<img src="https://ssl.lunadeer.cn:14437/i/2024/02/21/65d5e0d10b7d5.png" alt="" width="70%"> |
| 6 | + |
| 7 | +[](https://github.com/ColdeZhang/ReColorfulMap) |
| 8 | +[](https://bstats.org/plugin/bukkit/ColorfulMap/21443) |
| 9 | +[](https://github.com/ColdeZhang/ReColorfulMap/releases/latest) |
| 10 | + |
| 11 | +[](https://hangar.papermc.io/zhangyuheng/ReColorfulMap) |
| 12 | +[](https://modrinth.com/project/recolorfulmap) |
| 13 | + |
| 14 | +</div> |
| 15 | + |
| 16 | +## 简介 |
| 17 | + |
| 18 | +ReColorfulMap 可以将图片自动转换为地图画阵列,用以方便地悬挂公告、装饰画、地图等。 |
| 19 | + |
| 20 | +该插件是 ColorfulMap 的重制版,旧版本会在插件文件夹下产生大量的缓存图片。每次服务器启动都需要重新加载这些图片,并且难以区分哪些图片是有用的 |
| 21 | +哪些图片是废弃的,十分难以管理。 |
| 22 | + |
| 23 | +不论是 ColorfulMap 还是 ReColorfulMap 它们的实现方式均源自于 [ImageFrame](https://github.com/LOOHP/ImageFrame) |
| 24 | +和 [ImageMaps](https://github.com/SydMontague/ImageMaps). 你可以认为这是简化版的 ImageFrame 或者 ImageMaps 的高版本重置。 |
| 25 | + |
| 26 | +## 功能 |
| 27 | + |
| 28 | +- 自动将图片转换为地图画阵列; |
| 29 | +- 图片缩放; |
| 30 | +- 自动放置到展示框阵列; |
| 31 | +- 支持消耗金钱生成地图画 (需要 Vault 依赖); |
| 32 | +- 一键取回地图画 **(主要新增功能)**; |
| 33 | + |
| 34 | +## 支持版本 |
| 35 | + |
| 36 | +- 1.20.1+ (Paper、Folia) |
| 37 | + |
| 38 | +## 使用方法 |
| 39 | + |
| 40 | +1. 首先需要将你准备的图片上传到 [图床](https://ssl.lunadeer.cn:14437/)(这是我的自建图床,仅供测试使用)这样插件才能通过网络获取到图片内容。上传完成后复制得到的图片地址。 |
| 41 | + |
| 42 | +2. 在游戏中使用指令:`/tomap <图片地址>` 获得地图: |
| 43 | + |
| 44 | +  |
| 45 | + |
| 46 | + 由于 Minecraft 中的一张地图只能容纳最大 128 x 128 像素的图片,所以 ReColorfulMap 会自动将你的图片自动分片。 |
| 47 | + 无需担心分片后的图片顺序等问题,你实际上只会拿到一张缩略图,ReColorfulMap 会告诉你需要多少个展示框来放置完整的图片, |
| 48 | + 并在你放置的时候自动放置图片分片。 |
| 49 | + |
| 50 | + 例如上面这张图片, ReColorfulMap 会告诉你需要 8 x 13 个展示框来放置这张图片。 |
| 51 | + |
| 52 | +3. 准备好展示框后,将地图放置在展示框阵列的 **左下角**,插件会自动放置其他地图画: |
| 53 | + |
| 54 | +  |
| 55 | + |
| 56 | +4. 如果图片过大或者过小,你可以在指令后添加一个缩放参数,例如 `/tomap <url-you-just-got> 0.3` 表示渲染为原图的 30% 大小。 |
| 57 | + 如果你希望填满所有展示框边缘而不留下任何白边,你需要确保你的图片分辨率是 **128** 的倍数。 |
| 58 | + |
| 59 | +  |
| 60 | + |
| 61 | +## 管理员手册 |
| 62 | + |
| 63 | +### 指令与权限节点 |
| 64 | + |
| 65 | +> 以下指令中的尖括号 `<>` 表示必选参数,方括号 `[]` 表示可选参数。 |
| 66 | +
|
| 67 | +| Function | Command | Permission Node | Default | |
| 68 | +|----------|---------------------------------|---------------------|---------| |
| 69 | +| 生成地图画 | `/tomap <image-url> [scalling]` | recolorfulmap.tomap | true | |
| 70 | +| 重载配置 | `/reloadColorfulMap` | recolorfulmap.admin | op | |
| 71 | +| 清理缓存 | `/cleanColorfulMap` | recolorfulmap.admin | op | |
| 72 | + |
| 73 | +请注意:不要频繁运行 `/cleanColorfulMap`,它会删除所有已生成但未放置的图片。 |
| 74 | + |
| 75 | +### 配置文件参考 |
| 76 | + |
| 77 | +```yaml |
| 78 | +# 严禁修改此字段 |
| 79 | +version: 2 |
| 80 | +# 最大展示框阵列大小 |
| 81 | +# 32 x 18 表示图片不能大于 4096 x 2304 像素 |
| 82 | +# 不要将此值设置过大,可能会导致卡顿 |
| 83 | +max-frame-x: 32 |
| 84 | +max-frame-y: 18 |
| 85 | +# 语言文件,查看 plugins/FurnitureCore/languages 文件夹中的其他语言文件 |
| 86 | +language: en_us |
| 87 | +# 经济系统 (需要 Vault 和经济插件) |
| 88 | +# 如果为 true,玩家需要为每个地图付费 |
| 89 | +# 此功能可有效防止玩家滥用插件 |
| 90 | +economy: |
| 91 | + enable: false |
| 92 | + cost-per-map: 100.0 |
| 93 | +# 图床地址白名单,你可以指定玩家只能使用白名单中的图床地址 |
| 94 | +# 借助图床的过滤功能,可以有效防止玩家使用不当图片 |
| 95 | +# 留空表示不启用白名单 |
| 96 | +address-white-list: |
| 97 | + - '' |
| 98 | +# 调试模式,如果报告错误请打开此选项 |
| 99 | +debug: true |
| 100 | +``` |
| 101 | +
|
| 102 | +## 获取帮助 |
| 103 | +
|
| 104 | +Mail: [zhangyuheng@lunadeer.cn](mailto:zhangyuheng@lunadeer.cn) |
| 105 | +
|
| 106 | +GitHub: [Issues](https://github.com/ColdeZhang/ReColorfulMap/issues) |
| 107 | +
|
| 108 | +QQ群:309428300 |
| 109 | +
|
| 110 | +## 统计数据 |
| 111 | +
|
| 112 | + |
| 113 | +
|
0 commit comments