ImageMaps - 图片地图渲染

ImageMaps 是一款适用于 Bukkit Minecraft 服务器的插件，它允许你将自定义图片渲染到地图上，并放入物品展示框中，从而在游戏世界中放置图像。这可用于创建信息图、自定义画作，甚至模拟自定义纹理的外观。

💡安装

• 你需要一个运行 Bukkit 1.13 或更新版本 的服务器。部分功能仅在更新的服务端版本中可用。在报告问题前，请确保你使用的是最新的服务端软件。
• 将插件放入服务器的 plugins 文件夹并启动服务器。插件的配置文件夹将自动创建。
• 你可以将图片放入插件文件夹内的 images 文件夹中。

从 1.0.0 以下版本升级

插件应能自动转换你的 maps.yml 文件。转换前它会尝试创建备份，但仍建议你手动备份一次。

🔧使用方法

准备图片

• 要放置图片，图片必须存在于 images 文件夹中。
• 你可以通过 FTP 或直接复制文件的方式放入图片，也可以使用插件的下载命令从互联网获取图片。

放置图片

• 运行 /imagemap place 命令，然后右键点击你希望作为图像左上角（基于你的视角）的方块。
• 默认情况下，图片会被分割成 128x128 像素的子图像以适应地图尺寸。
• 可以通过命令参数缩放图像，但建议预先准备好正确尺寸的图片。

颜色与显示说明

• Minecraft 地图的调色板非常有限，插件/Bukkit 需要转换输入图像。这会导致游戏内的图像效果与源文件不同。
• 可用的颜色表可在此处查看：https://minecraft.gamepedia.com/Map_item_format#Color_table

物品展示框属性（1.16+）

• 隐形和固定的物品展示框属性仅在 1.16+ 版本中可用。
• 你可以使用一个可配置的物品（默认为木锄）来修改任何物品展示框的属性。
• 右键点击可切换可见性，Shift+右键点击可切换固定状态。

🎮命令

所有命令均以 /imagemap 或简写 /im 开头。

• /imagemap place [frameInvisible] [frameFixed] [frameGlowing] [size]

开始放置过程。

• frameInvisible 和 frameFixed 仅在 1.16+ 可用。
• frameGlowing 仅在 1.17+ 可用。
• /imagemap download

从给定的 URL 下载图片到 images 文件夹。

• /imagemap delete

从 images 文件夹中删除图片。

• /imagemap info

打印图片信息，如分辨率和预期大小。

• /imagemap reload

重新加载图片文件，适用于图片文件已更改的情况。

• /imagemap list [页码]

列出 images 文件夹中的所有图片。

• /imagemap help [命令]

打印命令帮助信息。

✨权限

• **imagemaps.*** - 授予所有权限。
• imagemaps.place - 允许使用 /imagemap place 命令。
• imagemaps.download - 允许使用 /imagemap download 命令。
• imagemaps.delete - 允许使用 /imagemap delete 命令。
• imagemaps.info - 允许使用 /imagemap info 命令。
• imagemaps.list - 允许使用 /imagemap list 命令。
• imagemaps.reload - 允许使用 /imagemap reload 命令。
• imagemaps.help - 允许使用 /imagemap help 命令。
• imagemaps.toggleFixed - 允许使用木锄切换物品展示框的“固定”状态。
• imagemaps.toggleVisible - 允许使用木锄切换物品展示框的“可见”状态。

注意： 所有权限默认对 OP 玩家开启。

⭐Maven 依赖

你需要配置你的环境以访问 GitHub 仓库。

net.craftcitizen 
imagemaps 
1.0.1 

---

此插件最初为 CraftCitizen 生存 Minecraft 服务器开发。