图像框架ImageFrame

插件

· 作者 LOOHP

将图片放置在地图和墙壁上!

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

最新 2026.1.5 · 26.3 · Folia / Paper

一键开服(送7天)

尚未支持你使用的语言?如果你愿意,欢迎在 Crowdin 上为我们贡献翻译!


关于

想在你的服务器中以炫酷的方式展示信息吗?
或者你想在主基地里放置一个漂亮的动态电视屏幕?
那么这款插件正是为你量身打造的!

想要高清且全彩的图片显示效果?
请查看 ImageFrame Client,这是 ImageFrame 的 配套模组!

视频演示

想看实际操作演示吗?这里有一些由优秀玩家制作的视频!
ServerMiner 提供的英文版本:

KasaiSora 提供的英文版本:

功能特性

1. 将图片加载到地图和物品展示框中

  • 支持从 URL 加载图片!
  • 支持 PNG、JPEG、WEBP 和 GIF 格式!
  • 可以生成地图形式或 直接 放置在物品展示框上!(使用智能选择工具选择你的物品展示框!)
  • 自动适配图片尺寸,确保图片不会被拉伸变形!

2. 完美支持动态 GIF!

  • 如果是 GIF 图片,将会以动画形式播放!
  • 动画帧率最高可达每秒 1/20 秒!
  • 动画渲染任务在异步线程中运行

3. 自定义宽度和高度

  • 让你的图片跨越多个地图显示
  • 自动适配功能同样适用于所有尺寸!
  • 非常适合在物品展示框上展示!

^ 这些地铁站台标志看起来很棒,不是吗?它们是由 ImageFrame 和隐形发光物品展示框组合而成的!

4. 为原版地图添加覆盖层!

  • 手持原版地图即可创建带有图像覆盖层的地图
  • 或者通过选中多个物品展示框来跨越多张地图进行设置!

^ 注意地图顶部带有蓝色背景的那行额外文字了吗?

5. 合并式 ImageMap 便于快速放置!

  • 将整个多部分的 ImageMap 作为一个合并后的物品获取!
  • 自动搜索空间,将 ImageMap 放置在物品展示框墙壁(或地板/天花板)上
  • 如果有足够空间,点击的物品展示框将被视为左上角起点
  • 当被破坏时,整个合并地图会被移除,并返还一个合并后的地图物品!
  • 尊重其他插件对物品展示框的保护机制!(通过调用 Bukkit 事件实现)

^ 爱心粒子效果来自 另一个插件,该插件监听了 EntityDamageEvent
^ 内置隐形物品展示框系统

6. 轻松刷新地图!

  • 只需一条简单命令,即可刷新源自同一 URL 的所有相同图像地图副本!
  • 非常适合用于展示那些需要偶尔更新的全服信息,无需逐一替换每张地图

^ 我已在源 URL 处上传并用草方块替换了 TNT 方块,同时我手中拿着 4 张地图中的一张

7. 为你的图片添加地图标记!

  • 可使用任意地图图标!例如原版制图师地图中的宅邸和神殿图标!
  • 它们下方还可以附加一行可选的文字说明
  • 可配置每张地图的最大标记数量
  • 非常适合在自定义图像地图上标记位置!

8. 生存模式友好

  • 要求 生存模式 下的玩家在库存中拥有空白地图才能创建图像地图(使用玩家指令)
  • 即使在物品展示框上直接创建图片或获取合并式 ImageMap 物品时也有效!
  • 可在配置文件中调整

9. 易于追踪和管理

  • 提供多种命令帮助你和管理员管理你自己或全服玩家创建的图像地图
  • 可以向其他玩家授予 ImageMaps 的使用权限!
  • 可为不同玩家设置不同的权限级别
  • 例如列出某玩家的所有地图、重命名等
  • 可设置每个玩家的图片创建上限(可为每个玩家单独设置!)
  • 可设置单个物品展示框的最大尺寸!(始终可自定义)
  • 支持从 ImageMap、ImageOnMap 和 DrMap 迁移数据(如需更多插件支持请求,请联系我)

10. 隐形物品展示框

  • 内置对生存模式友好的隐形物品展示框的支持!
  • 使用隐身药水喷洒物品展示框即可获得隐形效果。
  • 可在配置文件中进行调整。

11. 多语言支持

  • 所有面向玩家的提示信息会根据玩家客户端的语言自动翻译成相应语言。
  • 如果尚未支持你所使用的语言,请在 Crowdin 上贡献翻译,让我们一起打造更好的插件!

12. 配套模组

  • 查看此 配套模组,它能让玩家以高清、全彩等方式查看图片!

13. 多服务器支持

  • 借助 MySQL 存储支持,你可以在服务器网络中的多台服务器上共享相同的地图!(无需在 Bungeecord/Velocity 代理端安装此插件)

依赖项

  • 无!

安装方法

  1. 将 ImageFrame.jar 放入 plugins 文件夹,并包含所需的依赖项
  2. 启动服务器
  3. 编辑配置文件(如有需要)
  4. 重启服务器(如果在第 3 步中修改了配置文件)

开发版本

Jenkins

展示服务器

想看看插件的实际效果吗?

IP: mc.loohpjames.com

命令

说明:
对于命令 "<name>" / "<image_name>" 的参数,
如果你拥有权限,
可以通过以下语法访问其他玩家的地图:
"<player>:<name>"

例如:/if get LOOHP:map combined

管理命令:

/imageframe reload - 重新加载插件
/imageframe update - 检查更新
/imageframe storagemigrate - 存储类型迁移

玩家命令:

/imageframe select - 选择物品展示框以放置图像地图
/imageframe create <name> <url> <width> <height> - 创建新的图像地图
/imageframe create <name> <url> selection - 创建新的图像地图并直接放置在选定的物品展示框中
/imageframe create <name> <url> <width> <height> combined - 创建新的图像地图并获取其组合式 ImageMap 物品
/imageframe overlay <name> <url> - 创建一个新图像地图,在你手持的 Minecraft 原版地图上叠加一层覆盖层
/imageframe overlay <name> <url> selection - 创建一个新图像地图,在你选定的物品展示框中的 Minecraft 原版地图上叠加一层覆盖层
/imageframe clone <name> <new_name> - 创建一个具有与原图像地图相同属性的新图像地图
/imageframe clone <name> <new_name> selection - 创建一个具有与原图像地图相同属性的新图像地图,并直接放置在选定的物品展示框中
/imageframe clone <name> <new_name> combined - 创建一个具有与原图像地图相同属性的新图像地图,并获取其组合式 ImageMap 物品
/imageframe playback <name> pause - 切换动画图像地图的暂停状态
/imageframe playback <name> jumpto <seconds> - 跳转到动画图像地图的指定秒数
/imageframe refresh [optional:image_name] [optional:new_url] - 刷新你从源 URL 创建的地图
/imageframe info - 获取你手持的图像地图的相关信息
/imageframe get <name> - 获取一个已存在的自定义图像地图
/imageframe get <name> selection - 将一个已存在的自定义图像地图直接放置在选定的物品展示框中
/imageframe get <name> combined - 以组合式 ImageMap 形式获取一个已存在的自定义图像地图

/imageframe delete <name> - 删除一个已创建的预存图像地图 /imageframe rename <name> <new_name> - 重命名一个已创建的预存图像地图 /imageframe list - 列出所有已创建的预存图像地图 /imageframe marker add <image_name> <marker_name> direction:0-15 <marker_type> [可选:caption] - 向你的地图添加标记 /imageframe marker remove <image_name> <marker_name> - 从你的地图移除标记 /imageframe marker clear <image_name> - 清除你地图上的所有标记 /imageframe setaccess <name> <player> <permission> - 设置其他玩家对你地图的访问权限

管理员命令:

/imageframe list <玩家> - 列出某玩家已有的图像地图
/imageframe giveinvisibleframe <发光/普通> [数量] [玩家] - 给予不可见的物品展示框
/imageframe adminsetcreator <图像ID> <玩家> - 更改图像地图的创建者
/imageframe adminmigrate <ImageMap/DrMap/ImageOnMap> - 从选定的受支持的第三方插件迁移数据

权限

permissions:
  imageframe.create:
    default: op
    description: 允许玩家创建新的图像地图
  imageframe.create.animated:
    default: op
    description: 允许玩家创建新的动态图像地图
  imageframe.create.others:
    default: op
    description: 允许玩家为其他玩家创建图像地图,适用于叠加和克隆,绕过拥有数量限制
  imageframe.overlay:
    default: op
    description: 允许玩家在原版地图上叠加图像
  imageframe.clone:
    default: op
    description: 允许玩家对自己拥有的图像地图进行深度复制
  imageframe.playback:
    default: op
    description: 允许玩家暂停或设置其自身动态图像地图的播放位置
  imageframe.select:
    default: op
    description: 允许玩家选择物品展示框
  imageframe.marker:
    default: op
    description: 允许玩家在图像地图上添加和移除标记
  imageframe.marker.unlimited:
    default: op
    description: 允许玩家在图像地图上添加无限制的标记
  imageframe.refresh:
    default: op
    description: 允许玩家刷新图像地图
  imageframe.rename:
    default: op
    description: 允许玩家重命名图像地图
  imageframe.info:
    default: true
    description: 允许玩家查看图像地图数据
  imageframe.list:
    default: true
    description: 允许玩家列出他们创建的所有图像地图
  imageframe.list.others:
    default: op
    description: 允许玩家列出某位玩家创建的所有图像地图
  imageframe.delete:
    default: op
    description: 允许玩家删除他们创建的图像地图
  imageframe.purge:
    default: false
    description: 允许玩家清除特定玩家创建的所有图像地图
  imageframe.purge.all:
    default: false
    description: 允许玩家一次性清除所有图像地图
  imageframe.get:
    default: op
    description: 允许玩家获取他们创建的图像地图
  imageframe.setaccess:
    default: op
    description: 允许玩家更改其图像地图的访问权限
  imageframe.adminbypass:
    default: op
    description: 绕过所有访问限制,允许用户使用和修改任何图像地图
  imageframe.adminsetcreator:
    default: op
    description: 允许玩家通过图像地图 ID 更改任何图像地图的创建者
  imageframe.admindelete:
    default: op
    description: 允许玩家通过图像地图 ID 删除任何图像地图
  imageframe.adminmigrate:
    default: op
    description: 允许玩家将来自支持插件的数据迁移到 ImageFrame
  imageframe.preference:
    default: true
    description: 允许玩家更新其个人偏好设置
  imageframe.preference.others:
    default: op
    description: 允许玩家更新其他玩家的个人偏好设置
  imageframe.giveinvisibleframe:
    default: op
    description: 允许玩家给予不可见的物品展示框
  imageframe.reload:
    default: op
    description: 允许你重新加载配置文件
  imageframe.resync:
    default: op
    description: 允许你强制从存储中同步更改
  imageframe.storagemigrate:
    default: op
    description: 允许你将数据传输到不同的存储类型
  imageframe.update:
    default: op
    description: 允许你接收更新消息

默认配置

带有描述的最新版配置

数据使用

在 上的使用统计数据将对公众可见,你的服务器将被包含在统计中。不会发送你服务器的任何私人信息。
版本检查也通过 进行,以便在新版本发布时通知你。不会发送你服务器的任何私人信息。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源