ImageMaps 插件

ImageMaps 是一个适用于 Bukkit Minecraft 服务器的插件，它允许您通过将自定义图像渲染到地图上并将其放置在物品框中来在您的世界中放置自定义图像。

这可以用于创建信息图表、自定义画作甚至自定义纹理的外观。

安装

您需要一个实现 Bukkit 1.13 或更新版本的服务器。某些功能仅在较新的版本中可用。在报告问题之前，请确保使用服务器软件的最新版本。

将插件放入服务器的 plugins 文件夹并启动它。插件的文件夹将自动创建。您可以将图像放置在其中的 images 文件夹中。

升级

从版本 < 1.0.0 升级时，插件应自动转换您的 maps.yml 文件。它会尝试在执行此操作之前创建备份，但也建议手动进行备份。

使用

要放置图像，它们必须存在于 images 文件夹中。您可以通过 FTP 或直接复制，或使用插件的下载命令将它们放在那里，从而可以从互联网访问图像。

要放置图像，请运行 /imagemap place 命令并右键单击应该是图像左上角的方块（基于您的视角）。

图像默认会分割成 128x128 像素的子图像以适应地图。可以通过命令参数缩放图像，但建议准备正确缩放的图像。

Minecraft 地图的颜色调色板非常有限，需要插件/Bukkit 转换输入图像。这将导致您的图像在游戏中看起来与源图像不同。可用的颜色表可以在此处找到：颜色表链接

隐形和固定物品框属性仅在 1.16+ 中可用。您可以通过使用可配置的（默认为木锄）物品修改任何物品框的这些属性。右键单击以切换可见性，Shift+右键单击以切换固定状态。

命令

• /imagemap place <filename> [frameInvisible] [frameFixed] [frameGlowing] [size]：开始放置过程，frameInvisible 和 frameFixed 仅在 1.16+ 中可用，frameGlowing 仅在 1.17+ 中可用。
• /imagemap download <filename> <sourceURL>：从给定的 URL 下载图像到 images 文件夹。
• /imagemap delete <filename>：从 images 文件夹中删除图像。
• /imagemap info <filename>：打印信息，如分辨率和预期大小。
• /imagemap reload <filename>：重新加载图像，用于图像文件更改时。
• /imagemap list [page]：列出 images 文件夹中的所有图像。
• /imagemap help [command]：打印命令的帮助。

权限

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

所有权限默认对 OPs 为真。

Maven

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

ImageMaps 插件
ImageMaps 是一个适用于 Bukkit Minecraft 服务器的插件，它允许您通过将自定义图像渲染到地图上并将其放置在物品框中来在您的世界中放置自定义图像。
这可以用于创建信息图表、自定义画作甚至自定义纹理的外观。

安装
您需要一个实现 Bukkit 1.13 或更新版本的服务器。某些功能仅在较新的版本中可用。在报告问题之前，请确保使用服务器软件的最新版本。
将插件放入服务器的 plugins 文件夹并启动它。插件的文件夹将自动创建。您可以将图像放置在其中的 images 文件夹中。

升级
从版本 < 1.0.0 升级时，插件应自动转换您的 maps.yml 文件。它会尝试在执行此操作之前创建备份，但也建议手动进行备份。

使用
要放置图像，它们必须存在于 images 文件夹中。您可以通过 FTP 或直接复制，或使用插件的下载命令将它们放在那里，从而可以从互联网访问图像。
要放置图像，请运行 /imagemap place 命令并右键单击应该是图像左上角的方块（基于您的视角）。
图像默认会分割成 128x128 像素的子图像以适应地图。可以通过命令参数缩放图像，但建议准备正确缩放的图像。
Minecraft 地图的颜色调色板非常有限，需要插件/Bukkit 转换输入图像。这将导致您的图像在游戏中看起来与源图像不同。可用的颜色表可以在此处找到：颜色表链接
隐形和固定物品框属性仅在 1.16+ 中可用。您可以通过使用可配置的（默认为木锄）物品修改任何物品框的这些属性。右键单击以切换可见性，Shift+右键单击以切换固定状态。

命令

  
/imagemap place <filename> [frameInvisible] [frameFixed] [frameGlowing] [size]：开始放置过程，frameInvisible 和 frameFixed 仅在 1.16+ 中可用，frameGlowing 仅在 1.17+ 中可用。
  
/imagemap download <filename> <sourceURL>：从给定的 URL 下载图像到 images 文件夹。
  
/imagemap delete <filename>：从 images 文件夹中删除图像。
  
/imagemap info <filename>：打印信息，如分辨率和预期大小。
  
/imagemap reload <filename>：重新加载图像，用于图像文件更改时。
  
/imagemap list [page]：列出 images 文件夹中的所有图像。
  
/imagemap help [command]：打印命令的帮助。


权限

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

所有权限默认对 OPs 为真。

Maven
您需要配置您的环境以访问 GitHub 仓库。
<dependency>
  <groupId>net.craftcitizen</groupId>
  <artifactId>imagemaps</artifactId>
  <version>1.0.1</version>
</dependency>