PaintedPixels

插件

· 作者 avaliberty

一个适用于 Paper/Spigot 的 Minecraft 插件,允许玩家通过 URL 中的图片来创作地图艺术。

0 本站下载 0 关注 更新于 1 年前

最新 1.0.0 · 1.20.6 · Paper / Spigot

一键开服(送7天)

PaintedPixels

一款适用于 Paper/Spigot 的 Minecraft 插件,允许玩家通过 URL 将图片转换为地图艺术。

描述

PaintedPixels 使玩家能够通过在线 URL 上传图片,并获得复制该图像的 Minecraft 地图艺术。插件会自动转换图像颜色以匹配 Minecraft 的地图调色板,从而实现近乎 1:1 的还原。

功能

  • URL 转地图艺术:将任何图片 URL 转换为 Minecraft 地图艺术
  • 自动调整大小:图像在保持宽高比的同时自动调整大小
  • 多地图支持:大图像会自动分割到多个地图上
  • 色彩匹配:高级颜色转换以匹配 Minecraft 的地图调色板
  • 异步处理:异步下载和处理图像以防止服务器卡顿
  • 队列系统:地图存储在队列中以防止地面杂乱(新增!)
  • 基于权限:完整的权限控制系统
  • 可配置:自定义最大尺寸、交付方式及其他设置

命令

命令 描述 权限 别名
/paint <url> 从图片 URL 创建地图艺术 paintedpixels.use /mapimage, /imagemap, /paintpixels
/paint next 获取队列中的下一张地图 paintedpixels.use -
/paint all 获取队列中剩余的所有地图 paintedpixels.use -
/paint status 检查有多少地图正在等待 paintedpixels.use /paint queue
/paint help 显示帮助信息 paintedpixels.use -

权限

权限 描述 默认值
paintedpixels.use 允许使用 /paint 命令 true
paintedpixels.admin 管理员权限 op

配置

config.yml 文件允许你自定义以下内容:

# 最大图像尺寸(以像素为单位)
max-width: 512
max-height: 512

# 创建地图的交付方式
# 选项:queue, immediate
delivery-method: queue

# 启用调试日志
debug: false

# 缓存设置
cache:
  clear-on-restart: true
  max-cached-images: 100

交付方式:

  • queue(默认)- 地图存储在队列中,使用 /paint next 或 /paint all 检索
  • immediate - 直接给予地图

使用示例

  1. 找到一张图片的 URL(例如来自 Imgur、Discord 等)
  2. 运行命令:/paint https://example.com/image.png
  3. 等待插件下载并处理图像
  4. 地图会添加到你的队列中——使用 /paint next 一次获取一张!

注意:大图像将被分割成多张地图。例如,一张 256x256 的图像将创建 4 张地图(2x2 网格)。

  • /paint next - 一次获取一张地图
  • /paint all - 一次性获取所有地图
  • /paint status - 检查有多少地图正在等待
  • /paint all - 一次性获取所有地图
  • /paint status - 检查有多少地图正在等待

支持的图像格式

  • PNG(推荐)
  • JPEG/JPG
  • GIF(仅第一帧)
  • BMP
  • Java ImageIO 支持的任何格式

技术细节

地图颜色:

Minecraft 地图使用基于方块颜色的有限调色板。插件使用 MapPalette API 尽可能匹配颜色。在转换过程中可能会丢失一些颜色信息,这是正常且预期的现象。

地图尺寸:

  • 每张 Minecraft 地图为 128x128 像素
  • 大于 128x128 的图像会被分割成多张地图
  • 最大可配置尺寸为 512x512(16 张地图)

性能:

  • 图像下载是异步进行的,以防止服务器卡顿
  • 处理也是异步的,直到最终创建地图
  • 地图创建在主线程上完成(Bukkit API 要求)
  • 图像缓存到 plugins/PaintedPixels/cache/ 目录

限制

  • 最大文件大小:10 MB(出于安全考虑硬编码)
  • 下载超时时间:10 秒
  • 调色板仅限于 Minecraft 的地图颜色
  • 动画图像(如 GIF 等)将仅使用第一帧

故障排除

“下载图像失败”:

  • 检查 URL 是否有效且公开可访问
  • 确保 URL 直接指向图像文件
  • 检查服务器的防火墙设置

“你的背包已满”:

  • 地图将被掉落至你的位置
  • 捡起它或整理背包空间

地图显示为空/空白:

  • 这可能是客户端问题
  • 尝试重新登录或重载资源包

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源