[信息] [1.16-1.19]Yamipa — 图片放置/轻量/简洁/支持GIF

Yamipa开箱即用。默认情况下，它会在目录下创建以下文件和目录：plugins/YamipaPlugin

cache：包含缓存图像的目录，以加快渲染过程。不应修改其内容。

images：这是您放置要放置在《我的世界》世界中的图像文件的目录。

images.dat：保存服务器中所有放置图像的列表和属性（例如坐标）的文件。不应修改其内容。

您可以通过在插件配置目录中创建一个文件来更改这些文件的默认路径：config.yml

verbose: false         # 设置为“true”以启用更详细的日志记录

animate-images: true   # 设置为“false”以禁用GIF支持

images-path: images    # 图像目录的路径

cache-path: cache      # 缓存目录的路径

data-path: images.dat  # 放置的图像数据库文件的路径

该库使用 bStats 匿名报告安装次数。如果您不喜欢这样，请随时通过添加到 bStats 配置文件来禁用它（没关系，没有难受的感觉）。enabled: false

此插件添加以下命令：

/image clear <x z world> <r> [<placed-by>]：移除原点周围方块半径内的所有置入图像。r
/image describe：显示有关置入图像的详细信息。
/image download <url> <filename>：从 URL 下载图像并将其放置在图像目录中。
/image give <player> <filename> <amount> <w> [<h>] [<flags>]：将以后可以放置的图像物品提供给玩家。
/image list [<page>]：列出映像目录中的所有可用文件。
/image place <filename> <w> [<h>] [<flags>]：放置大小为 x 块的图像。wh
/image remove：从世界中移除置入的图像，而不删除图像文件。
/image top：列出放置图像最多的玩家。

例子
显示帮助
/image
从 URL 下载图像并使用其他名称保存
/image download "https://www.example.com/a/b/c/1234.jpg" imagename.jpg
为“test.jpg”图像（3x5 块）提供 10 个图像项给“TestPlayer”
/image give TestPlayer test.jpg 10 3 5
为“TestPlayer”提供 10 个图像项，这些图像项在删除时不会删除图像项
/image give TestPlayer test.jpg 10 3 5 -DROP
启动对话框以放置宽度为 3 块且自动高度的图像
/image place imagename.jpg 3
启动对话框以放置 3 块宽和 2 块高的图像
/image place imagename.jpg 3 2
启动对话框以放置在黑暗中发光的图像
/image place imagename.jpg 3 2 +GLOW
启动对话框以删除置入的图像，同时保留原始文件
/image remove
删除生成周围 5 个方块半径内的所有放置图像
/image clear 0 0 world 5
删除“EvilPlayer”放置在下界100方块半径内的所有图像
/image clear 50 70 world_nether 100 EvilPlayer
删除所有旧置入的图像（不带“置入者”元数据）
/image clear 0 0 world 9999999 00000000-0000-0000-0000-000000000000

如果您想更精细地控制可以使用一组特定命令的玩家，权限就是您的最佳选择！

yamipa定义了以下权限：

命令                                       权限组                描述: __________
yamipa.command.clear             管理员 使用命令/image clear
yamipa.command.describe        管理员 使用命令/image describe
yamipa.command.download      管理员 使用命令/image download
yamipa.command.give              管理员 使用下载/image give
yamipa.command.list                管理员 使用命令/image listyamipa.command.place             管理员 使用命令/image place
yamipa.command.remove          管理员 使用命令/image remove
yamipa.command.remove.own   管理员 与之前相同，但仅适用于同一播放器放置的图像
yamipa.command.top                管理员 使用命令/image top
yamipa.item.place                     所有玩家        置入图像项
yamipa.item.remove                  所有玩家        删除图像项（具有标志）REMO
yamipa.item.remove.own           所有玩家        与之前相同，但仅适用于同一播放器放置的图像
请注意，权限用作树。这意味着，如果您授予权限，默认情况下也会授予其子级。例如，您可以使用 授予对所有命令的访问权限。同样，如果您授予 ，也将授予该权限。yamipa.command.*          yamipa.command.remove      yamipa.command.remove.own

您可以使用权限插件（例如 LuckPerms 或 GroupManager）更改授予这些命令的角色或玩家。这两个插件都经过测试可以与 Yamipa 配合使用，尽管任何类似的插件都应该可以正常工作。

在大型服务器中，让玩家在他们想要的任何位置放置和删除图像可能不是最明智的主意。对于这些情况，Yamipa与其他Bukkit插件兼容，这些插件允许创建和管理世界区域。如果您有一个或多个此类插件，Yamipa 将自动相应地应用权限，并且只允许玩家在可以放置或删除块的位置放置或删除图像，无需额外配置。

支持的插件包括：WorldGuard  GriefPrevention

来自此插件的图像具有一组称为“标志”的Boolean属性，可以修改其行为。可能的值为：

ANIM（可动画）：图像是否应该动画化，当您不想播放 GIF 图像时很有用。
REMO（可移动）：任何玩家是否可以通过左键单击图像来删除图像。
DROP（可丢弃）：图像在被任何玩家删除时是否丢弃图像项目。
GLOW（发光）：图像是否在黑暗中发光（仅适用于 Minecraft 1.17 及更高版本）。
默认情况下，使用“/image place”命令放置的图像只有标志。同样，使用“/image give”命令发出的图像项具有 和标志。ANIMANIMREMODROP

默认标志可以通过“flags”参数修改。要将标志添加到默认标志，请使用“+{FLAG_NAME}”（例如 ），而要删除它，请使用“-{FLAG_NAME}”（例如 ）。您可以修改用逗号分隔它们的多个标志（例如 ）。+GLOW -ANIM +GLOW,-ANIM

您可能已经猜到了，《我的世界》不支持放置图像文件。Yamipa 通过使用两个内置功能（物品框和地图）来渲染自定义图像，从而绕过了此限制。

但是，由于物品框架是实体（这会导致服务器中出现大量滞后），因此 Yamipa 实际上不会在您的世界中创建任何实体。相反，它通过发送构建的网络数据包来欺骗玩家的客户端认为有一个放置的项目框架，而没有。

在动画图像（即GIF）的情况下，Yamipa将所有动画帧发送给播放器（这需要相当多的带宽），然后发送一个小数据包，告诉客户端每隔几毫秒切换到下一个动画步骤（即地图）。

重要！
由于每当玩家靠近图像时，Yamipa 都会在内存中存储图像的缓存副本，以防万一需要在不影响性能的情况下再次发送图像，因此您的服务器需要一点备用 RAM 来处理此问题。

这里的经验法则是每个唯一加载的图像 100K（动画图像为 1MB）。唯一意味着如果多次放置具有相同尺寸的同一图像，则仅计为一个实例。