Minecraft/插件扩展 Yamipa v1.3.2

一个 Minecraft 图像放置插件

Yamipa 是一个 Spigot 插件，允许玩家将图像（甚至是动画！）放置在 Minecraft 服务器的任何表面上，而无需安装任何本地客户端模块。

它在设计时考虑了性能和兼容性，因此即使是最低配置的服务器也应该能够运行它。安装下载最新版本 的 JAR 文件并将其复制到 Minecraft 服务器的“插件”目录中，就像您使用任何其他插件一样。 就是这样！要求 在安装 Yamipa 之前，请确保您满足以下要求：

• CraftBukkit、Spigot 或 PaperMC 1.16 或更高版本
• ProtocolLib v5.3.0 或更高版本

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

• cache：包含缓存图像的目录，用于加快渲染过程。您不应修改其内容。
• 图像：这是您放置想要放置在 Minecraft 世界中的图像文件的目录。
• images.dat：保存了您服务器中所有已放置图像的列表和属性（例如坐标）的文件。您不应修改其内容。

您可以通过在插件配置目录中创建 config.yml 文件来更改这些文件的路径。如果您不指定它们，则以下是默认配置值：

verbose：false # 设置为“true”以启用更详细的日志记录
animate-images：true # 设置为“false”以禁用 GIF 支持
images-path：images # 图像目录的路径
cache-path：cache # 缓存目录的路径
data-path：images.dat # 放置图像数据库文件的路径
allowed-paths：null # 设置为 RegExp 以限制玩家可访问的图像
max-image-dimension：30 # 图像中允许的最大宽度或高度（以块为单位）

有关如何为每个玩家设置不同的allowed-paths 或max-image-dimension 值的更多信息，请参阅玩家变量部分。

允许的路径
变量allowed-paths 是一个正则表达式，它确定是否允许玩家查看或下载图像文件。如果相对于图像目录的所需路径与此表达式匹配，则允许玩家继续。

如果 allowed-paths 为空字符串 ("") 或 null，则播放器可以读取任何图像文件或将其下载到图像目录内的任何路径。

此正则表达式必须遵循Java 使用的语法。您可以使用regex101等在线工具预先测试您的表达式。此外，您还可以使用以下特殊标记：

• #player#：玩家姓名
• #uuid#：玩家 UUID（带连字符）

例如，如果您希望服务器中的每个玩家都有自己的子目录来存储只有他们才能访问的文件，再加上一个共享的公共目录，则可以使用以下允许路径值：

^(private/#player#|public)/

这样，玩家“john”可以看到“private/john/something.jpg”处的图像文件，但“jane”看不到。

重要！
请注意，这些限制也适用于其他实体，如 NPC、命令块或服务器控制台。但是，特殊令牌在非玩家上下文中始终匹配（例如，“#player#”将被解释为“.+”）。

bStats
此库使用 bStats 匿名报告安装数量。如果您不喜欢这样，可以随时通过在bStats 配置文件中添加 enabled: false 来禁用它（没关系，没有恶意）。

用法
此插件添加了以下命令：

• /image clear <xz world> <r> [<placed-by>]：删除以原点为中心半径 r 块内的所有放置的图像。
• /image describe：显示放置图像的详细信息。
• /image download <url> <filename>：从 URL 下载图像并将其放在图像目录中。
• /image give <玩家> <文件名> <数量> <w> [<h>] [<标志>]：给予玩家可稍后放置的图像物品。
• /image list [<page>]: 列出图像目录中所有可用的文件。
• /image place <filename> <w> [<h>] [<标志>]：放置一个大小为 wxh 块的图像。
• /image remove：从世界中移除放置的图像而不删除图像文件。
• /image top：列出放置图片最多的玩家。

示例

• 显示帮助
  /图片
• 从 URL 下载图像并使用其他名称保存
  /image download " www.example.com " imagename.jpg
• 将 10 个图像项目交给“TestPlayer”，以获取“test.jpg”图像（3x5 块）
  /image give TestPlayer test.jpg 10 3 5
• 将 10 个图像项提供给“TestPlayer”，移除时不会掉落图像项
  /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
• 启动对话框以删除放置的图像，同时保留原始文件
  /图像删除
• 移除出生点周围 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-00000000000

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