ImageCanvas
只需一条命令,即可将任何图片转化为精美的 Minecraft 地图艺术!
ImageCanvas 是一款功能强大的 Paper 插件,允许你直接将来自 URL 的图片显示在 Minecraft 地图上。创建令人惊叹的画廊、像素艺术作品展示或自定义装饰,支持最大 15x15 的多地图网格。
功能特性
简易图片导入
只需粘贴图片 URL,ImageCanvas 便会处理其余工作。插件会自动下载、处理并将你的图片转换为 Minecraft 的地图调色板。
多地图网格
创建跨越多个地图的大型展示!支持最大 15x15 张地图的网格(即 1920x1920 像素的显示空间)。非常适合大型艺术品、服务器 Logo 或精细的建筑作品。
自动放置
不再需要繁琐的手动放置地图!使用 -auto 标志,只需在物品展示框中放置一张地图,然后看着 ImageCanvas 自动用正确的图块填充所有周围的展示框。支持任何方向——水平、垂直,甚至地板和天花板。
HD 高清模式
启用 -HD 模式,使用 Floyd-Steinberg 抖动算法获得更优的图片质量。与标准转换相比,这种高级算法能产生更平滑的渐变和更准确的色彩。
Web 上传支持
在使用 Minefort 或 Aternos 等共享主机的服务器上游玩?没问题!使用 /imagemap upload 获取我们 Web 上传器的安全链接。直接从浏览器上传图片,无需服务器文件访问权限。
持久化存储
所有的图片地图都会保存并在服务器重启后保持存在。当服务器重新上线时,地图会自动恢复其图片。
命令
| 命令 |
描述 |
/imagemap create <name> <url> <WxH> [-auto] [-HD] |
创建新的图片地图 |
/imagemap get <name> |
获取已保存图片地图的副本 |
/imagemap list |
列出所有已保存的图片地图 |
/imagemap delete <name> |
删除已保存的图片地图 |
/imagemap upload |
获取安全的上传链接 |
示例
/imagemap create logo https://example.com/logo.png 3x3 -auto -HD
/imagemap create banner 5x1 -auto
/imagemap get logo
工作原理
- 下载 - ImageCanvas 从提供的 URL 获取你的图片
- 处理 - 图片被调整大小以适配你指定的网格尺寸
- 转换 - 每个像素都被映射到 Minecraft 的地图颜色调色板
- 渲染 - 自定义地图渲染器在游戏中显示你的图片
- 放置 - 手动将地图放入物品展示框,或使用自动放置功能
配置
# 最大网格尺寸(以地图数量计)
max-width: 15
max-height: 15
# 下载超时时间(秒)
download-timeout: 30
# 最大文件大小(MB)
max-file-size: 10
# 限制特定的图片主机
allowed-domains: []
# 内置 Web 服务器(适用于自托管服务器)
web-server:
enabled: false
port: 8080
权限
| 权限 |
描述 |
默认值 |
imagecanvas.create |
创建图片地图 |
op |
imagecanvas.get |
获取已保存的图片地图 |
op |
imagecanvas.list |
列出图片地图 |
op |
imagecanvas.delete |
删除图片地图 |
op |
imagecanvas.upload |
使用 Web 上传器 |
op |
要求
- Paper 1.21.11 或兼容分支
- Java 21 或更高版本
技巧与窍门
- 最佳尺寸:根据图片的宽高比规划网格尺寸。16:9 的图片作为 4x2 或 8x4 的效果很好。
- 展示框准备:对于自动放置,在放置地图之前,请先以网格图案放置空的物品展示框。
- HD 模式:用于照片和复杂图像时使用 HD 模式。标准模式对于 Logo 和像素艺术已经足够。
- 大型展示:对于非常大的网格,考虑使用隐形物品展示框以获得更整洁的外观。
支持
发现错误或有任何建议?请在我们的 GitHub 仓库 上提交 Issue!
用 ImageCanvas 将你的 Minecraft 世界转变为艺术画廊!
ImageCanvas
Transform any image into stunning Minecraft map art with a single command!
ImageCanvas is a powerful Paper plugin that lets you display images from URLs directly onto Minecraft maps. Create breathtaking galleries, pixel art displays, or custom decorations using multi-map grids up to 15x15 in size.
Features
Easy Image Import
Simply paste an image URL and ImageCanvas handles the rest. The plugin downloads, processes, and converts your image to Minecraft's map color palette automatically.
Multi-Map Grids
Create massive displays spanning multiple maps! Support for grids up to 15x15 maps (that's 1920x1920 pixels of display space). Perfect for large artwork, server logos, or detailed builds.
Auto-Placement
No more tedious manual map placement! With the -auto flag, simply place one map on an item frame and watch as ImageCanvas automatically fills all surrounding frames with the correct tiles. Works in any direction - horizontal, vertical, or even on floors and ceilings.
HD Quality Mode
Enable -HD mode for superior image quality using Floyd-Steinberg dithering. This advanced algorithm produces smoother gradients and more accurate colors compared to standard conversion.
Web Upload Support
Playing on a shared host like Minefort or Aternos? No problem! Use /imagemap upload to get a secure link to our web uploader. Upload images directly from your browser without needing server file access.
Persistent Storage
All your image maps are saved and persist through server restarts. Maps automatically restore their images when the server comes back online.
Commands
| Command |
Description |
/imagemap create <name> <url> <WxH> [-auto] [-HD] |
Create a new image map |
/imagemap get <name> |
Get copies of a saved image map |
/imagemap list |
List all saved image maps |
/imagemap delete <name> |
Delete a saved image map |
/imagemap upload |
Get a secure upload link |
Examples
/imagemap create logo https://example.com/logo.png 3x3 -auto -HD
/imagemap create banner 5x1 -auto
/imagemap get logo
How It Works
- Download - ImageCanvas fetches your image from the provided URL
- Process - The image is resized to fit your specified grid dimensions
- Convert - Each pixel is mapped to Minecraft's map color palette
- Render - Custom map renderers display your image in-game
- Place - Put maps in item frames manually or use auto-placement
Configuration
# Maximum grid dimensions (in maps)
max-width: 15
max-height: 15
# Download timeout (seconds)
download-timeout: 30
# Maximum file size (MB)
max-file-size: 10
# Restrict to specific image hosts
allowed-domains: []
# Built-in web server (for self-hosted servers)
web-server:
enabled: false
port: 8080
Permissions
| Permission |
Description |
Default |
imagecanvas.create |
Create image maps |
op |
imagecanvas.get |
Get saved image maps |
op |
imagecanvas.list |
List image maps |
op |
imagecanvas.delete |
Delete image maps |
op |
imagecanvas.upload |
Use web uploader |
op |
Requirements
- Paper 1.21.11 or compatible fork
- Java 21 or higher
Tips & Tricks
- Optimal Sizing: Plan your grid size based on your image's aspect ratio. A 16:9 image works great as 4x2 or 8x4.
- Frame Preparation: For auto-placement, place empty item frames in a grid pattern before placing the map.
- HD Mode: Use HD mode for photographs and complex images. Standard mode works fine for logos and pixel art.
- Large Displays: For very large grids, consider using invisible item frames for a cleaner look.
Support
Found a bug or have a suggestion? Open an issue on our GitHub repository!
Transform your Minecraft world into an art gallery with ImageCanvas!
评论 0
登录后参与评分
还没有评论,来抢沙发吧