ImageFrame - 图片地图插件

想在你的服务器上以炫酷的方式展示信息吗？或者想在基地里放一个漂亮的动态电视屏幕？那么这款插件就是为你准备的！

想要高清全彩图像？请查看 ImageFrame Client，这是 ImageFrame 的配套模组！

💡关于

ImageFrame 允许你将图片加载到地图和物品展示框中，支持 PNG、JPEG、WEBP 和 GIF 格式，并能创建跨越多张地图的大型图像或动态展示。

✨主要特性

图像加载与展示

• 从 URL 加载图片到地图或物品展示框上。
• 支持 PNG、JPEG、WEBP 及 GIF 格式（GIF 可实现动画效果）。
• 自动适配图像比例，避免拉伸变形。
• 可自定义图像的宽度和高度，以跨越多张地图展示。

动态图像与叠加

• 支持 GIF 动画，异步更新任务确保流畅播放。
• 可在原版地图上添加图像叠加层。
• 提供“组合图像地图”功能，将多部分图像合并为单个物品，便于在物品展示框墙面上自动放置和整体移除。

地图标记与管理

• 可在自定义图像地图上添加任何地图标记图标（如林地府邸、神庙图标等）。
• 标记可附带一行说明文字。
• 可配置每张地图的标记数量上限，适合用于位置标记。

生存模式友好与权限管理

• 生存模式玩家需要空地图才能创建图像地图（可配置）。
• 完善的命令和权限系统，方便管理个人或所有人的图像地图。
• 可以与其他玩家共享地图访问权限，并设置不同的权限等级。
• 支持设置每位玩家的图像创建数量上限和单个图像的最大尺寸。

其他实用功能

• 内置生存友好的“隐形物品展示框”系统（通过喷溅隐身药水获得）。
• 支持多语言，玩家界面信息会根据客户端语言自动切换。
• 支持 MySQL 存储，可在服务器网络中的多个服务器间同步地图数据。
• 提供从 ImageMap、DrMap 和 ImageOnMap 等插件迁移数据的功能。

🎮安装与依赖

依赖

• 无！插件无需任何依赖即可运行。

安装步骤

• 将 ImageFrame.jar 放入服务器的 plugins 文件夹。
• 启动服务器。
• 如有需要，编辑配置文件 (config.yml)。
• 若修改了配置，请重启服务器使更改生效。

🔧命令列表

命令参数说明

对于使用 <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 - 创建新图像地图并获得其“组合图像地图”物品。
• /imageframe overlay <name> <url> - 为手中持有的原版地图创建图像叠加层。
• /imageframe overlay <name> <url> selection - 为已选中物品展示框内的原版地图创建图像叠加层。
• /imageframe clone <name> <new_name> - 克隆一个具有相同属性的新图像地图。
• /imageframe clone <name> <new_name> selection - 克隆地图并直接放入已选中的物品展示框。
• /imageframe clone <name> <new_name> combined - 克隆地图并获得其“组合图像地图”物品。
• /imageframe playback <name> pause - 暂停/播放动态图像地图。
• /imageframe playback <name> jumpto <seconds> - 跳转到动态图像地图的指定秒数位置。
• /imageframe refresh [图像名称] [新URL] - 从源 URL 刷新你创建的地图。
• /imageframe info - 获取手中持有的图像地图信息。
• /imageframe get <name> - 获取一个你之前创建的图像地图。
• /imageframe get <name> selection - 将之前创建的地图直接放入已选中的物品展示框。
• /imageframe get <name> combined - 获取之前创建的地图的“组合图像地图”物品形式。
• /imageframe delete <name> - 删除一个你创建的图像地图。
• /imageframe rename <name> <new_name> - 重命名你创建的图像地图。
• /imageframe list - 列出你创建的所有图像地图。
• /imageframe marker add <image_name> <marker_name> <方向:0-15> <标记类型> [说明文字] - 为地图添加标记。
• /imageframe marker remove <image_name> <marker_name> - 从地图移除标记。
• /imageframe marker clear <image_name> - 清除地图上的所有标记。
• /imageframe setaccess <name> <player> <permission> - 设置其他玩家对你地图的访问权限。

管理命令

• /imageframe list <player> - 列出指定玩家创建的所有图像地图。
• /imageframe giveinvisibleframe <glowing/regular> [数量] [玩家] - 给予隐形物品展示框物品。
• /imageframe adminsetcreator <image_id> <player> - 更改图像地图的创建者。
• /imageframe adminmigrate <ImageMap/DrMap/ImageOnMap> - 从支持的第三方插件迁移数据。

⭐权限节点

以下是插件的主要权限节点（默认配置）

• imageframe.create (默认: op) - 允许创建新图像地图。
• imageframe.create.animated (默认: op) - 允许创建新的动态图像地图。
• imageframe.overlay (默认: op) - 允许在原版地图上叠加图像。
• imageframe.select (默认: op) - 允许选择物品展示框。
• imageframe.marker (默认: op) - 允许在地图上添加和移除标记。
• imageframe.refresh (默认: op) - 允许刷新图像地图。
• imageframe.info (默认: true) - 允许查看图像地图数据。
• imageframe.list (默认: true) - 允许列出自己创建的所有地图。
• imageframe.list.others (默认: op) - 允许列出指定玩家创建的所有地图。
• imageframe.get (默认: op) - 允许获取自己创建的地图。
• imageframe.adminbypass (默认: op) - 绕过所有访问限制，允许使用和修改任何图像地图。
• imageframe.giveinvisibleframe (默认: op) - 允许给予隐形物品展示框。
• imageframe.reload (默认: op) - 允许重载配置文件。

（完整权限列表请参考插件生成的 plugin.yml 文件或相关文档。）

❓注意事项与支持

版本兼容性

• 开发者主要保证插件在最新版本的 Spigot 和 Paper 上功能完整且运行完美。
• 旧版本 Minecraft 仅提供“支持”，可能缺少部分功能或钩子，但通常可以正常工作。建议自行测试。

问题反馈

• 如遇到问题，请在 Discord 服务器（推荐）或插件讨论区中报告，请不要在评论中提交问题。

扩展与贡献

• 想要高清、全彩显示？请使用配套模组 ImageFrame Client。
• 如果你的语言尚未得到支持，欢迎在 Crowdin 上协助翻译，共同完善插件。

展示服务器

想亲眼看看插件的效果吗？可以访问展示服务器

• IP: mc.loohpjames.com

---

附言：开发与维护免费插件需要付出大量时间与精力。如果你觉得这个插件很棒，请考虑通过捐赠或使用我们的 BisectHosting 托管推荐链接（可享首月 25% 折扣）来支持开发者。这能帮助插件持续更新并保持免费！感谢你的支持。