ChatImage

插件

· 作者 ChickenSaysBak

在聊天中发送图片和 GIF。— 支持 DiscordSRV 和 PlaceholderAPI

0 本站下载 0 关注 更新于 1 年前

最新 3.0.0 · 1.21.11 · BungeeCord / Paper

一键开服(送7天)

ChatImage

在 Minecraft 中发送图片和 GIF!


功能特性

DiscordSRV 和 EssentialsDiscord 支持

从 Discord 发送的图片和 GIF 将在 Minecraft 聊天窗口中渲染显示!


悬浮图片

发送不会占用聊天空间位置的图片!玩家可以输入 /hideimages,或者在配置文件中将其设为默认开启。


渲染选项

平滑渲染效果几乎适用于所有图片,但对于具有简单色板的扁平化设计,简单渲染的效果可能更好。这两种选项在速度上没有明显差异。


部分透明度支持

发送带有混合透明度级别的图片!


PlaceholderAPI 支持

使用 %chatimage_image% 占位符在任何位置插入图片和 GIF!这可用于将图片放置在物品描述(lore)中。 详情请见下方的 占位符用法。


NSFW 内容过滤

你可以过滤掉任何包含露骨内容的图片和 GIF!此功能默认关闭,但只需在配置中启用即可使用。重复的内容会在插件内部进行缓存,以提高处理速度。


BungeeCord 和 Velocity 支持

本插件在 Spigot、BungeeCord 和 Velocity 上的表现完全一致!唯一的例外是 Velocity 目前不支持 GIF(当 Velocity API 支持对话框时将改变这一情况)。

注意: 仅在你的服务器拥有某种形式的全球聊天时,才将此插件安装在 BungeeCord/Velocity 上。否则,请将该插件安装到每个 Spigot 服务器上。


配置文件

# ============================================= #
#            ChatImage 配置                     #
#              By: ChickenSaysBak               #
#                                               #
# 重载配置请使用 /chatimage reload              #
#                                               #
# 权限:                                        #
# - chatimage.use (用于渲染图片)              #
# - chatimage.admin (用于使用 /chatimage)     #
# ============================================= #

# 冷却时间设置 #

# 设置用户在发送另一张图片或 GIF 之前必须等待的时间(以秒为单位)。
cooldown: 3

# 如果发送的是图片 URL(而不是图片本身渲染时),冷却时间将从 0 开始计算。
# 如果启用此项,当用户反复发送 URL 时,冷却时间会延长。这有助于防止频繁刷屏者。
strict_cooldown: false

# 图片设置 #

# 在渲染图片和 GIF 时使用平滑效果。
# 对于照片级真实的图片效果最佳,但对于扁平图形,简单渲染可能看起来更好。
# 其速度几乎与简单渲染一样快。
smooth_render: true

# 去除图片边缘多余的空白区域。
# 不适用于 GIF。
trim_transparency: true

# 聊天中图片的最大尺寸。Minecraft 默认聊天设置下的最大值为 35 x 20。
# 参见 HIDDEN IMAGE SETTINGS 以更改隐藏图片的尺寸。
# 参见 GIF SETTINGS 以更改 GIF 的尺寸。
max_width: 35
max_height: 20

# 隐藏图片设置 #

# 当玩家运行 /hideimages 时,聊天中发送的图片会被最小化,并通过鼠标悬停查看。
# 宽大的图片在隐藏时会比正常状态下显得更小。
hidden_images:

  # 默认隐藏图片。玩家可以单独使用 /showimages 覆盖此设置。
  # 如果启用此项,建议减少冷却时间,因为此选项已经减少了行刷屏。
  auto_hide: false

  # 仅针对隐藏图片的最大尺寸。
  # 如果你增加宽度,请注意风险:可能会为使用较小窗口大小或较大 GUI 缩放比例的用户造成图片损坏。
  # 相反,在较小的 GUI 缩放比例下,你可以渲染更大的图片,但你无法知道谁在使用何种缩放比例。
  # 对于标准 854 x 480 或更大的窗口,23 x 24 是一个安全的默认值。
  # 如果你不介意可能为某些全屏用户破坏图片,可以将其增加到 26 x 27 以适配全屏用户。
  max_width: 23
  max_height: 24

# GIF 设置 #

gifs:

  # 仅针对 GIF 的最大尺寸。Minecraft 默认设置下的最大值为 22 x 22。
  max_width: 22
  max_height: 22

# 过滤设置 #

explicit_content:

  # 如果发现露骨内容,则阻止图片渲染。不适用于 '/chatimage send'
  # 这将影响速度,增加几秒延迟。重复的内容会在插件内部进行缓存以提高速度。
  # 功能提供自:https://api4.ai/apis/nsfw
  enabled: false

  # 如果图片包含露骨内容,包含链接的整条消息将不会被发送。
  # 注意:这包括没有渲染图片权限的人发送的消息。
  # Velocity 注意事项:你需要像 SignedVelocity 这样的插件才能在 Velocity 服务器上正确工作。
  remove_message: false

# 常规设置 #

# 如果玩家的客户端语言不受支持,则使用的默认语言。
# 你可以在 messages 文件夹中添加语言。请考虑在插件的 GitHub 或 SpigotMC 页面上分享这些语言包!
# 添加语言时,请使用有效的游戏内语言代码命名文件:https://minecraft.wiki/w/Language#Languages
language_default: en_us

# 向控制台打印额外消息以帮助查找问题来源。
debug: false


权限

chatimage.use
这是使用 URL 发送图片和 GIF 所必需的权限。它可以作为一个不错的捐赠者特权!


chatimage.admin
这是使用 /chatimage 命令所必需的权限。详见下方 ↓


命令

/hideimages
所有玩家均可使用。启用后,图片将被最小化,玩家需要将鼠标悬停在上方才能查看图片。


/showimages
反转 /hideimages 的效果。


/chatimage reload
在对配置文件进行任何更改后输入此命令以重新加载配置。


/chatimage send <player>|all <url> [smooth] [trim] [width] [height] [text]
向特定玩家或所有玩家发送图片和 GIF。如果未指定末尾的选项,则使用配置文件中的默认值。Trim(裁剪)选项不适用于 GIF。

此外,您可以在图片或 GIF 的右侧/上方附加显示的文本。这支持颜色标签、换行符 <br> 以及 PlaceholderAPI 提供的占位符。该命令具有多种创意用途!

使用的命令
/chatimage send ChickenSaysBak https://images.vexels.com/media/users/3/220947/isolated/preview/e22f7e6fdc024de159849b35e2a82c7a-skull-mouth-open-illustration.png true true 35 20 <br><br><br><br><br><br><br><br><br> <reset> <reset> <reset> <reset> <reset> <reset> <reset> <dark_red><b>YOU<br> <reset> <reset> <reset> <reset> <reset> <reset> <dark_red><b>DIED!!

/chatimage save <name> <url> [smooth] [trim] [width] [height]
与上述命令类似,但会将文本图像保存到插件文件夹中以便日后使用。


/chatimage delete <name>
删除已保存的图片。


/chatimage send <player>|all <name> [text]
向特定玩家或所有玩家发送已保存的图片。文本可以像上面的其他 send 子命令一样附加在末尾。发送已保存的图片比从 URL 发送要快得多,因为通过互联网检索图像是整个过程中耗时最长的步骤。


占位符用法

PlaceholderAPI 用法

ChatImage 为 PlaceholderAPI 提供了一个自定义占位符,用于在任何位置插入图片。您只需安装 PlaceholderAPI 插件和 ChatImage 即可使用该功能。使用方法如下所示:

%chatimage_image: <name> [text]% %chatimage_image: <url> [smooth] [trim] [width] [height] [text]%

参数与 /chatimage send 命令完全相同。您可以在 text 参数中使用其他占位符,但由于占位符嵌套在另一个占位符内部,因此必须使用花括号而不是百分号。例如: %chatimage_image: heart n Your Health n {player_health}%

注意: 建议为占位符使用已保存的图片而不是 URL,因为从互联网检索图像会导致 PlaceholderAPI 插件及使用该占位符的任何插件出现卡顿。


开发者 API

API 用法

要使用此 API,请将相应的依赖项添加到您的项目中:

Maven

<dependency>
    <groupId>io.github.chickensaysbak</groupId>
    <artifactId>chatimage-api</artifactId>
    <version>3.0.0-1</version>
</dependency>

Gradle

implementation 'io.github.chickensaysbak:chatimage-api:3.0.0-1'

别忘了将 "ChatImage" 添加到 plugin.yml 的 depend 或 softdepend 部分。


创建图片

Component image = ChatImageAPI.createMediaFromURL("http://url.com/example.png");

您还可以使用其他可选参数。未指定的参数将使用配置文件中的默认值。

createMediaFromURL(String url, String text, boolean smooth, boolean trim, int width, int height)

发送图片

Paper & Velocity

player.sendMessage(media);

Spigot(需要依赖 adventure-platform-bungeecord)

player.spigot().sendMessage(BungeeComponentSerializer.get().serialize(media));

BungeeCord(需要依赖 adventure-platform-bungeecord)

player.sendMessage(BungeeComponentSerializer.get().serialize(media));

检查玩家是否隐藏了图片

if (ChatImageAPI.isHidingImages(player.getUniqueId())) {
    // 玩家正在隐藏图片
}



提示

如果您在发送特定图片时遇到问题,请尝试将其上传到 Imgur、Imgbb、Gyazo 甚至 Discord。只需确保复制以 .png、.jpg、.gif 等结尾的直接图片链接即可。


如果您有任何问题、错误或建议,请随时联系我!

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源