Custom Images - 自定义图片加载器

💡简介

你是否想过在 Minecraft 中展示自己的图片？CustomImages 正是为此而生。这个插件最初只是一个随性的项目，但因其独特的功能而广受欢迎。现在，它已完全重写，原生支持 1.8 及以上所有版本，并采用基于数据包的全新实体渲染方式，带来前所未有的图像展示体验。

💡核心功能

• 加载任意图片：支持加载任何尺寸的图片（需合理控制大小）。所有图像块均以 128x128 像素为单位渲染。
• 智能适配：图片会自动调整大小以适配显示。虽然 128 像素倍数的图片效果更佳，但并非强制要求。
• 多种格式：支持所有 Java 可识别的图像格式（如 PNG、JPG/JPEG）。但非 PNG/JPG 格式可能无法在列表命令中显示。
• 便捷放置：手持物品时，在空中右键即可将图片放置在你面前，无需点击方块。
• 横向支持：在 1.13+ 版本中支持横向图片的显示。

注意事项

• 图片尺寸过大会消耗大量方块并可能导致客户端卡顿。
• 建议将图片放置在 plugins/Images/ 文件夹内以便管理。

🎮安装与配置

安装步骤

• 下载 images-2.x.x.jar 文件。
• 将其放入服务器的 plugins 文件夹。
• 启动服务器以生成配置文件和文件夹，然后关闭服务器。
• 将你的图片文件放入生成的 plugins/Images/ 文件夹中。
• 根据需要编辑 plugins/Images/config.yml 配置文件。
• 重启服务器，即可开始使用。

数据库配置

在 config.yml 中，你可以配置三种数据库类型：

• SQLite（默认）

- 无需额外数据库，适合大多数用户。保持默认设置即可。

• MySQL

- 如果你已有 MySQL 数据库，可将类型设置为 `MYSQL` 并填写相应的登录凭据。

- **高级用户提示**：如果数据库用户没有建表权限，请在配置中将 `database.initialize` 设为 `false`，并联系作者获取表结构信息。

• 原始数据文件

- 一种简单的原始字节文件存储方式。速度较慢，但空间效率略高（无表结构开销）。仅当磁盘空间极其紧张时才考虑使用。

🔧命令列表

• /image create <图片名称|URL> [缩放百分比]

- 创建并开始粘贴一张新的自定义图片。支持 Tab 键自动补全文件名。

• /image delete

- 通过点击来删除一个已存在的图片。

• /image delete near <范围>

- 删除指定范围内的所有图片。

• /image list

- 显示可添加的图片列表。

• /image import

- 将旧版格式的图片导入到新格式。

• /image transfer

- 将图片数据转移到一个新的数据库。

图片缩放

在创建命令后添加百分比参数可以缩放图片。

例如：/image create myImage.png 200

这会将图片创建为原始大小的 200%。任何大于 0 的百分比都是可接受的。

⭐权限节点

• images.command.create
• images.command.delete
• images.command.delete.near
• images.command.list
• images.command.import
• images.command.transfer

❓故障排除

图片删除问题

如果无法删除图片，请尝试以下方法

• 在图片的不同位置以及方块中心多次右键点击。
• 确保客户端与服务器使用相同的 Minecraft 版本（例如，服务端为 Spigot 1.14.4，客户端也应使用 1.14.4）。
• 安装 ProtocolLib（可能有助于改善情况）。
• 使用 /image delete near <范围> 命令进行范围删除。

常见错误与解决

• 错误提示：java.lang.IllegalStateException: unknown world with ID deletedWorldName

- **原因与解决**：这意味着你删除某个世界时，其中仍有图片未清除。请重新创建该世界，使用 `/image delete near` 命令删除所有图片后，再移除该世界。

• 错误提示：java.awt.AWTError: Assistive Technology not found... 或 java.lang.NoClassDefFoundError: Could not initialize class sun.awt.X11.XToolkit

- **原因与解决**：很可能是 Java 版本问题。请确保至少使用 **Java 8**（Oracle 或 OpenJDK）。Java 11 有时也可能出现问题，如果其他方法无效，可以尝试更换 JDK 版本。

版本建议

请始终使用 Spigot 或 Paper 每个主要版本中最新的小版本。例如：

• 使用 1.13，则应运行 1.13.2。
• 使用 1.8，则应运行 1.8.8。

✨报告问题与支持

请注意，请不要通过撰写评论来寻求帮助或报告错误，作者不会以此方式提供支持。

• 自助排查：在报告问题前，请务必仔细阅读本文档，尤其是“故障排除”和“命令列表”部分，确认不是操作失误。
• 查看日志：如果遇到问题，请检查服务器控制台在运行相关命令或启动时的错误信息。错误行通常为红色和/或有缩进，这对解决问题至关重要。
• 正确反馈：请通过讨论区发帖或直接联系作者，清晰描述问题，并提供相关的截图和找到的错误信息。

作者会在有时间时尽快提供帮助。如果你愿意支持插件的开发，可以通过下方的链接进行捐赠，任何支持都深表感谢。