在线相框

Frames — Hytale 的动态图片相框

Frames 为游戏添加了可显示来自任意 URL 的全分辨率图片的相框。无需客户端模组修改——通过游戏内界面上传或应用图片，图片将以你提供的精确像素分辨率渲染（按所选方块尺寸缩放）。

亮点

• 全分辨率图片渲染：支持以图片原始像素尺寸保存并显示，随后按要求的方块尺寸缩放，同时保持宽高比。
• 动态资源：上传图片时，模组会自动生成专属物品、方块模型和纹理。
• 尺寸灵活：你可以选择任意尺寸的图片！只需指定宽度（以方块为单位），高度会自动按比例调整。
• 每个实例的元数据：每个放置的相框实例都会记录在对应物品的元数据中（mods/BoffmediaFrames/Frames/<itemId>.json），包含坐标和方块尺寸。
• 全局索引：通过 mods/BoffmediaFrames/FramesIndex.json 实现快速坐标与物品的查找，便于界面预填充和管理任务。
• 管理员界面和工具：/listframes 管理员命令附带列表界面，并提供干净删除生成资源的选项。

工作原理

1. 放置一个相框并与之交互。
2. 在游戏界面中粘贴图片 URL 并点击Upload（上传），或粘贴已生成的 Boff_Frame_<名称> ID 并点击Apply（应用）。
3. 模组下载图片，创建纹理、方块模型和物品 JSON，写入物品元数据，更新全局索引，然后在短暂延迟后替换方块，使新物品出现在游戏世界中。

安装

1. 将模组放入你的 mods 文件夹。
2. 启动服务器，允许模组将默认资源复制到 mods/BoffmediaFrames（首次运行时可能需要重启服务器或保存世界）。

要求

• 服务器重启/保存：首次安装时，你可能需要重启或保存一次服务器，以便模组初始化并复制默认资源。
• 实验性：此模组为实验性模组，利用了服务器的资源系统——加载时机会影响生成资源立即可用的时间。

权限

要允许玩家上传图片（创建新的相框物品），请向玩家账户授予以下权限：

/perm user add [UUID] boffmedia.frames.upload

要限制谁能打开相框界面，请使用 boffmedia.frames.open 权限。默认情况下，所有玩家均可使用该界面；使用否定权限可拒绝特定用户的访问（例如 -boffmedia.frames.open）。

对齐

相框界面支持对齐选项，用于控制当图片与相框方块尺寸不完全匹配时，图片在相框内的放置方式。可用对齐值包括：CENTERED（居中）、BOTTOM_LEFT（左下）、BOTTOM_CENTER（底部居中）、BOTTOM_RIGHT（右下）、TOP_LEFT（左上）、TOP_CENTER（顶部居中）和 TOP_RIGHT（右上）。

鸣谢与源码

源码和技术细节：https://github.com/luisca343/Frames

自豪地合作方：