图像框架 织物端口

ImageFrame（Fabric 移植版）

这是一个基于 Fabric 的高性能纯服务端移植版，移植自广受欢迎的 Spigot 插件 LoohpJames 的 ImageFrame。让你可以将图片和动态 GIF 放置在地图和墙上！

此移植版已针对 Minecraft 1.21+（Fabric）进行了现代化和优化，同时保持与 Spigot 地图 100% 的数据兼容性。

---

重要声明与维护说明

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

---

功能与优化

此 Fabric 移植版被设计为极其轻量且服务器安全，完全在服务端运行，无需客户端模组：

1. 动态地图颜色引擎：
   • 使用像素级完美的 Mojang NMS 颜色匹配系统，动态地将图片 RGB 颜色映射到 Minecraft 内置的地图颜色。
   • 无需硬编码的调色板文件，也不会有不准确的颜色。颜色匹配绝对精确。
2. 网络可见性缓存：
   • 针对大型多人服务器优化！地图和动画帧仅发送给持有地图或在活跃地图框架 32 格范围内的玩家。
   • 这消除了网络数据包开销，显著降低了带宽使用，并防止客户端因屏幕外的动画更新而卡顿。
3. 隐形物品框架：
   • 支持将地图放置在隐形框架上。
   • 与隐身喷溅药水或包含隐身效果的区域效果云无缝集成。将药水扔到物品框架上会使框架隐形，而破坏或修改框架则会正确更新状态。
4. 无需客户端模组：
   • 完全在服务端运行！原版客户端可以连接并享受自定义地图绘画。

---

📄 许可与原始作品

本项目是 LoohpJames 的 ImageFrame 的衍生作品。为遵守原始项目的许可协议，此移植版采用 GNU 通用公共许可证 v3（GPLv3） 授权。

• 你可以自由使用、修改和重新分发本软件。
• 任何衍生作品也必须在 GPLv3 许可证下开源。