Frameify
Frameify 可将任意图像转换为可挂在物品展示框墙上的多区块地图,范围从单个 1x1 地图到可配置的 64x64 网格。像素数据直接烘焙进原版 map_<id>.dat 文件中,因此即使移除插件或将世界迁移至其他服务器,你的地图仍能正常工作。仅在使用 Frameify 创建地图以及查看动画地图(GIF)时需要该插件;若未安装 Frameify,GIF 将呈现为静态图像。
直接从 URL 加载图像(支持直链、Discord CDN 以及带有查询字符串的 klipy 风格链接),系统会自动下载、缩放、抖动处理,并按所需数量分割至相应的物品展示框中。
特性
- 支持静态与动画图像:PNG、JPG、BMP、GIF(动画)和 WebP(动画)。
- 数据烘焙入原版地图文件,确保在插件卸载或世界迁移后地图依然可用。
- 缩放模式:适配(带黑边)、拉伸或裁剪。
- 采用 Floyd-Steinberg 抖动算法实现平滑渐变。
- 支持隐形物品展示框。
- 在行动栏显示实时下载进度条。
- 内置宽高比计算器,可导出网格线预览图或布局示意图。
- 提供游戏内管理对话框以管理地图。
- 动画仅在玩家观看时渲染。
命令
别名:
/fmap
/frameify create <name> <url> <width> <height> [scale=fit|stretch|crop] [dither=true|false] [deliver=individual|fill|none]
下载图像并将其烘焙至指定宽 x 高的物品展示框网格中。
deliver=individual 返回独立的图块(默认值),fill 自动将其放置在你所注视的墙上,none 仅进行烘焙而不分发任何物品。
/frameify get <name> [individual|fill]
获取已存在的地图:作为物品获取,或使用 fill 自动将其放置于墙上。
/frameify place <name>
自动填充你所注视的物品展示框墙(左上角 = 你瞄准的那个展示框)。
/frameify calc <url> [export]
下载图像并显示其尺寸、宽高比及最接近的网格尺寸。
若提供导出名称,则将带有框架线条的真实图像预览保存为 PNG 文件至服务器的桌面目录。
/frameify calc <width> <height> [export]
计算网格的宽高比及最接近的可构建网格尺寸。
若提供导出名称,则将带有标签的布局示意图保存下来。
/frameify if [amount]
获取隐形物品展示框(放置后不可见,仅显示地图内容)。
/frameify manage
打开管理对话框。此外还可使用:manage list 和 manage delete <name>。
/frameify reload
重新加载 config.toml。
权限(默认均为 op)
frameify.create, frameify.get, frameify.place, frameify.calc,
frameify.invisibleframe, frameify.manage, frameify.delete, frameify.admin
兼容性
- 服务端:Paper 和 Purpur(Paper 分支)。不支持 Spigot。
- Minecraft 版本:26.1.2 和 26.2。
- Java 25+。
- 仅限服务端。
配置
插件配置文件位于 plugins/frameify/config.toml
具体说明请查阅 config.toml 文件。
致谢
- 插件图标基于 Tabler Icons (MIT) -
Frameify
Frameify turns any image into a multiblock map you can hang on a wall of item
frames, from a single 1x1 map up to a configurable 64x64 grid. The pixel data is
baked directly into the vanilla map_<id>.dat files, so your maps keep working
even if you remove the plugin or move the world to another server. Frameify is
only needed to CREATE the maps and to view animated maps (GIFs), if frameify is not present, gifs will be static.
Load an image straight from a URL (direct links, Discord CDN and klipy-style
links with query strings all work), and it is downloaded, scaled, dithered and
split across the right number of item frames automatically.
Features
- Static and animated support: PNG, JPG, BMP, GIF (animated) and WebP (animated).
- Baked into vanilla map data, so maps survive plugin removal and world moves.
- Scale modes: fit (letterbox), stretch, or crop.
- Floyd-Steinberg dithering for smooth gradients
- Invisible item frames
- Live download progress bar in your action bar.
- Aspect-ratio calculator that can export a gridline preview or layout diagram.
- Clickable in-game management dialog to manage maps
- Animations only render while a player is viewing them.
Commands
Alias:
/fmap
/frameify create <name> <url> <width> <height> [scale=fit|stretch|crop] [dither=true|false] [deliver=individual|fill|none]
Download an image and bake it onto a width x height grid of item frames.
deliver=individual gives you the tiles (default), fill auto-places them on
the wall you are looking at, none just bakes without handing anything out.
/frameify get <name> [individual|fill]
Receive an existing map: as items, or fill to auto-place it on a wall.
/frameify place <name>
Auto-fill the wall of item frames you are looking at (top-left = the frame
you target).
/frameify calc <url> [export]
Download an image and show its size, aspect ratio and closest grid sizes.
With an export name, save a gridline preview PNG (the real image with frame
lines) to the server's desktop.
/frameify calc <width> <height> [export]
Aspect ratio and closest buildable grid sizes for a grid. With an export
name, save a labelled layout diagram.
/frameify if [amount]
Get invisible item frames (they place invisibly, so only the map shows).
/frameify manage
Open the management dialog. Also: manage list, and manage delete <name>.
/frameify reload
Reload config.toml.
Permissions (all default to op)
frameify.create, frameify.get, frameify.place, frameify.calc,
frameify.invisibleframe, frameify.manage, frameify.delete, frameify.admin
Compatibility
- Server: Paper and Purpur (Paper forks). No Spigot.
- Minecraft: 26.1.2 and 26.2.
- Java 25+.
- Server-side only.
Configuration
The plugin's config is found at plugins/frameify/config.toml
Explanations are found in the config.toml file.
Credits
- Plugin icon based on Tabler Icons (MIT) -
评论 0
登录后参与评分
还没有评论,来抢沙发吧