ImageFrame Fabric Port

ImageFrame（Fabric 移植版）

这是热门 Spigot 插件 ImageFrame by LoohpJames 的高性能通用 Fabric 移植版。将图片和动态 GIF 放到地图和墙上，原生支持高清（HD）！

本项目是一个混合（通用）模组：对原版客户端而言，它完全在服务端运行；而安装在客户端时，则提供原生高清地图渲染、高清 GIF 动画即时同步以及物品栏物品预览提示。

重要免责声明与维护说明

• 支持与维护： 本移植版是为与朋友的私人服务器而创建的。因此，请不要期待定期更新、积极维护或保证修复漏洞。
• 未来更新： 虽然不保证提供支持，但如果我们的个人服务器需要，可能会发布关键漏洞修复或兼容性更新。
• 致原作者的邀请： 如果原作者（LoohpJames）希望改编、使用或将本 Fabric 移植版代码的任何部分合并到官方项目中，我们热烈欢迎并鼓励这样做！
• Fabric 移植版开发者： 由 reyhe66243 为 Fabric 开发和优化。
• 致谢： 非常感谢 LoohpJames 提供的原 Spigot 插件设计、资源加载器和架构。

通用架构与客户端兼容性

请在服务端和客户端使用完全相同的模组 JAR。不要使用原版客户端模组，因为本移植版依赖更新后的、兼容 GIF 的网络架构。

• 原版客户端： 无需安装任何客户端模组即可连接。地图将以标准 Minecraft 分辨率（128×128）流畅显示。
• 模组客户端（安装本模组）： 会自动与服务器进行后台握手，以请求原生高清（HD）图像纹理、高清 GIF 动画帧即时同步以及物品栏悬停提示。

模组兼容性与优化说明

如果你使用 ImmediatelyFast，必须禁用其地图图集优化功能：

• 在 config/immediatelyfast.json 文件中将 "map_atlas_generation": false 设置为对应值。
• 原因： ImmediatelyFast 的 map_atlas_generation 会强制将所有地图纹理放入低分辨率 128×128 图集，从而覆盖并裁剪高清纹理。禁用 map_atlas_generation 可让 ImageFrame 以全高清渲染，同时 ImmediatelyFast 会继续优化你其他 99% 的图形性能（字体、HUD、告示牌、GUI、缓冲区）。
• 本模组包含自动检测逻辑，会尝试在启动时禁用此设置。

配置与权限

Fabric 上的 ImageFrame 具有精简且功能完整的 config/ImageFrame/config.yml，并与原 Spigot 插件保持 1:1 的权限一致性。

关键配置选项

• RequireEmptyMaps： 要求生存模式玩家手持空地图（width * height）才能创建或获取图像地图。
• MaxSize： 限制地图尺寸（以方块为单位）以防止服务器卡顿。
• PlayerCreationLimit： 限制每个玩家或组可创建的地图最大数量。
• RestrictImageUrl： 域名白名单（例如 Imgur、Discord CDN），用于限制玩家可从哪些位置下载图像。
• CombinedByDefault： 运行 /imageframe get <name> 时自动给予合并后的地图物品，而不是分开的地图拼块。
• InvisibleFrame： 配置生存模式下用于隐形物品展示框的药水喷溅转换。

权限与 LuckPerms

通过 fabric-permissions-api-v1 和原生 Minecraft OP 等级兼容 LuckPerms（用户命令默认等级为 0 / 所有玩家）：

| 命令 / 功能 | 权限节点 | 默认权限 |
| :— | :— | :— |
| /imageframe create | imageframe.create | 所有玩家 |
| /imageframe get | imageframe.get | 所有玩家（自己的地图） |
| 管理他人的地图 | imageframe.get.others, imageframe.delete.others | OP 等级 2 |
| /imageframe delete | imageframe.delete | 所有玩家（自己的地图） |
| /imageframe rename | imageframe.rename | 所有玩家（自己的地图） |
| /imageframe refresh | imageframe.refresh | 所有玩家（自己的地图） |
| /imageframe playback | imageframe.playback | 所有玩家 |
| /imageframe select | imageframe.select | 所有玩家 |
| /imageframe list | imageframe.list | 所有玩家（显示自己的地图） |
| 查看服务器上的所有地图 | imageframe.list.others | OP 等级 2 |
| 地图创建限制等级 | imageframe.createlimit.<group> | 配置文件中的自定义等级 |
| 无限创建地图 | imageframe.createlimit.unlimited | OP 等级 2 |
| 完全管理员权限绕过 | imageframe.admin | OP 等级 2 |
| /imageframe reload | imageframe.reload | OP 等级 2 |
| /imageframe language | imageframe.admin | OP 等级 2 |