Image Display

插件

· 作者 cosmo-jar

在您的服务器上显示图片——无需资源包!

0 本站下载 0 关注 更新于 2 个月前

最新 1.1.0 · 26.3 · Paper / Purpur

一键开服(送7天)

logo

它可以用在哪里?

将任意图片转换为由 MineSkin 支持的头部纹理网格,然后在聊天、TAB 页眉/页脚、前缀/后缀、姓名板、全息图、标题、计分板等地方使用。 Image Display 非常适合用于服务器 Logo、图标、装饰、职级视觉特效、全息艺术、大厅品牌展示以及其他无需强制安装资源包的视觉 UI 元素。

功能

  • 无需资源包即可显示图片
  • 自动将 PNG/JPG/JPEG/WEBP 图片转换为玩家头部组件。你不需要手动裁剪图片——插件会自动为你处理!
  • 无需摆弄资源捆绑包或寻找字形,只需上传图片并使用一个占位符即可!
  • 使用简单的占位符来显示图片,例如:
%imagedisplay_<image_name>%
  • 通过 ProtocolLib 组件替换在任何聊天中工作
  • 生成后使用本地 JSON 图片缓存
  • 使用权限控制
  • 为不支持的客户端提供备用文本
  • 多 API Key 池:支持配置中最多 10 个 MineSkin 密钥,具备自动平衡和 --apikey 选择功能
  • 实时 BossBar,包含百分比、瓦片计数器和 Mojang 队列状态
  • 通过 /imagedisplay cancel 即时取消正在运行的任务
  • 带有自动重试功能的 Mojang 速率限制保护
剧透

1.21.9 版本之前的客户端无法看到此类图片。对于它们,你可以在配置中指定备用文本

玩家列表中的示例

如何添加和使用任意图片?

1. 上传图片

将你的图片放入:

plugins/ImageDisplay/pictures/

⚠️ 确保图片尺寸是 8 像素的倍数。

示例:

40x8(推荐用于捐赠者职级)
16x16
32x32
64x8
64x64
80x8
96x8
128x64
128x128
256x128
  • 高度规则:对于单行文本(聊天、前缀、TAB),请使用 8 像素 的高度,因为 Minecraft 字体字符的高度为 8px。更高的图片将在多行中渲染。
  • 提示:以 1:1 像素画 风格绘制高度为 8px 的图片,以确保图标清晰、像素完美且无模糊!

2. 在插件配置中指定你的 MineSkin API 密钥 它是免费的:你可以在此处获取

将你的密钥粘贴到 config.yml 中。你可以添加多个密钥,以便在不触发 Mojang 速率限制的情况下同时生成多张图片:

ImageDisplay:
  mineskin-api-keys:
    1: "your_primary_api_key"
    2: "optional_second_api_key"

3. 生成图片数据

运行命令:

/imagedisplay generate <image.png> [可选自定义ID] [--apikey <槽位>]

4. 监控或取消生成

查看显示进度和队列状态的实时 BossBar。如有需要,你可以随时取消正在进行的生成任务:

/imagedisplay cancel <id>
/imagedisplay cancel all

5. 使用占位符

在支持的任何位置使用生成的占位符:

%imagedisplay_your_image_name%

权限

每个生成的图片都拥有独立的权限节点:

imagedisplay_<id>

示例:

%imagedisplay_logo%

需要:

imagedisplay_logo

此权限检查仅在玩家尝试在聊天中使用 Image Display 占位符时生效。我计划在未来扩展权限功能。

所需插件

Image Display 需要:

可选:

工作原理?

Image Display 会获取一张图片,将其分割为 8x8 像素的图块,将这些图块发送给 MineSkin,并接收带有签名的玩家头颅纹理。

插件随后将结果存储在本地 JSON 缓存文件中。生成完成后,服务器无需再次处理原始图片。占位符仅渲染缓存的头颅组件。Image Display 旨在确保在服务器正常运行期间保持轻量级。

已测试并兼容的插件:

  • TAB
  • Chatty
  • ChatEx
  • Citizens
  • FancyNPC
  • DeluxeHub
  • LuckPerms
  • EssentialsX
  • EssentialsX Chat
  • FancyHolograms
  • LPC-Minimessage
  • DecentHolograms

以及更多……

注意事项

  • 如果你使用 TAB 插件,则默认启用了 MiniMessage 支持以处理组件——此时前缀/后缀中的图片渲染将无法工作。请在 TAB 配置中禁用它:
components:
  minimessage-support: false

然后运行该命令

/tab reload
  • 支持多种本地化语言
  • 推荐字体:Minecraftia、Press Start 2P,或任何像素艺术风格的位图字体/默认字体。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源