我的相框

My Pictures Frames: 原生与超优化 是一个完全从零构建的高性能、轻量级实用系统，能够原样将外部网络图像投射到你的Minecraft世界中。它严格遵循零外部依赖并着眼于多人游戏效率，完全消除了基于实体的卡顿画框，为服务器管理员、创作者和地图制作者提供了绝对的创作控制权。

🌐 支持的语言 / Idiomas Soportados:

EN | ES (es, cl, ar, mx) | PT (br)

🚀 主要特性

• 原生的现代性能： 原生构建于 Minecraft 1.21.1 和 Java 21。使用轻量级原版代码独立编译，支持 Fabric 和 NeoForge。
• 零库依赖： 即拖即用。无需像 CreativeCore 或 Architectury 这样的重配置 API。它利用游戏内置的 JOML 库进行高速矩阵计算。
• 无物品展示框： 图像通过高度优化的 BlockEntityRenderer 布局直接投射到方块上，完全消除了传统实体导致的客户端 FPS 下降。

🧱 合成配方与游戏内预览

My Pictures Frames 合成配方：

🎨 高级渲染与 GUI 自定义

对你的画布拥有绝对控制权。右键点击画框会打开一个拥有像素级精度的全面用户界面，包含高级变换工具：

📐 布局与格式	🔧 变换
* 现代格式： 支持静态 .webp、.png、.jpg 和 .jpeg 文件，并带有完整原生透明度和 Alpha 通道。 * 动态 GIF： 完整流畅的 .gif 资产回放系统。 * 动态缩放： 精确滑块，可将画布拉伸和调整大小，从 1x1 到最大 32x32 方块。 * 宽高比锁定： 智能比例开关。根据图像的原始像素尺寸自动调整高度，防止失真。	* 轴镜像： 原生按钮，可立即在水平 (X) 轴和垂直 (Y) 轴上镜像图像。 * 自由旋转： 将图像围绕其中心点按固定的 90°、180° 和 270° 角度旋转。 * 融合与隐形模式： 让边界方块完全隐形，使图像流畅悬浮，或将其平整地融合到任何相邻的墙壁布局中。

🚀 性能与极致优化

该模组直接面向企业级服务器环境构建，运行一系列先进的客户端微优化：

• 异步线程： 网络 HTTP 下载和复杂的 GIF 帧解码完全独立于Minecraft的主循环运行，保持你的帧率丝滑流畅。
• 距离与遮挡剔除： 当玩家移动超过最大配置距离或进入实心遮挡墙后方时，自动卸载并停止处理图像或动画帧。
• 预解码 RAM 缓冲： 资产被异步缓存到原生图形内存 (NativeImage) 中，优化 GPU 交互并防止微卡顿。

📂 智能便携缓存系统

再也不必担心链接失效或图像丢失的问题：

• 单人游戏地图： 资产直接保存到你的世界文件中 (saves//mypictureframe_cache/)。非常适合导出自定义地图；其他玩家无需下载网络即可立刻看到你的画框。
• 多人游戏安全性： 根据服务器的IP地址，干净地隔离客户端磁盘缓存。如果某个外部URL离线，模组会自动回退并渲染本地缓存的图像。

💡 夜光滤镜

对于霓虹灯、电影院和赛博装饰来说，这是一个绝对的美学变革。具有多状态选择器：

• 禁用： 正常环境光照。夜晚来临时画框自然变暗。
• 低 / 中 / 高： 可调节亮度值。在高强度下，画布完全忽略世界光照环境，在完全黑暗的环境中发出耀眼的光芒（光照值 15，与末影人眼睛相同）。

🔒 服务器安全与命令

通过集中的 config/mypicturesframes.properties 面板，保持对多人服务器基础设施的全面监督：

• 域名白名单： 立即屏蔽恶意链接。服务器会监控数据包，并丢弃对未明确列入受信任域名列表（例如 imgur.com, discordapp.com）的任何外部站点的连接。
• 持久玩家限制： 利用原生的 SavedData (.dat) 框架，限制每个非OP玩家的画框数量（默认：3）。完全不受区块卸载或意外重启的影响。
• Brigadier 管理员命令： 使用简写别名 /mpf 直接调用统一命令：
  • /mypictureframe setImage <x y z> <url>
  • /mypictureframe setSize <x y z> <width> <height>

🔮 未来路线图与社区投票

我们的实用工具生态系统是与社区成员和支持者积极协作构建的。

🗳️ 塑造生态系统！ 我们所有的主要开发优先事项、后续实用工具以及独家功能目标完全由社区意见驱动。前往我们的 Patreon 页面查看活跃的路线图讨论、项目分解，并投出你的一票！

📦 整合包与社区 你可以完全自由地将 My Pictures Frames 包含在你的任何整合包中！无需明确许可。我们只希望你提供一个指向此官方 CurseForge 项目页面的链接。

如果你遇到任何运行错误或希望分享技术反馈，请通过我们的官方报告渠道提交。祝世界建设愉快！