ImageOnMap - 游戏地图图片插件

你是否想过在游戏内的地图上查看图片？ImageOnMap 让你实现这个愿望！（灵感来源于 ImgMap）

💡功能特性

ImageOnMap 允许你从互联网加载图片到 Minecraft 地图上。

• 支持从 URL 加载 PNG、JPEG 和 GIF 格式的图片到地图上。
• 图片会保存在服务器中，并在重启后自动重新加载。
• 大图片会自动分割成多个部分！例如，一张 1024x1024 的图片会被分割成 16 张地图。
• 图片会自动居中显示。
• 你可以将地图放入物品展示框中。

本插件是遵循 GNU 通用公共许可证（版本 3 或更高）发布的自由软件。源代码已发布在 GitHub。你也可以在此处获取不稳定的开发构建版本。

> 版本兼容性提示：

> - 最新版本仅兼容 Minecraft 1.17+。

> - 对于 Minecraft 1.14 至 1.16，请使用 4.1 版本。

> - 对于 Minecraft 1.13 和 1.14，请使用 4.0-pre1 版本。

> - 对于更旧的版本，请使用 ImageOnMap 3.1。

❓支持与反馈

如果你需要关于 ImageOnMap 的帮助，首选方式是通过我们的 Discord 服务器联系我们（我们使用英语和法语）。你也可以使用 Spigot 论坛帖子，但我们的回复时间会慢得多。

在任何情况下，请先阅读 FAQ！

如果你想报告错误或建议新功能，对我们而言最佳的选择是使用 GitHub Issues，请尽可能使用此方式。如果你实在无法使用 GitHub，再使用上述支持选项。

我们是 ImageOnMap（及其他插件）背后的团队，Spigot 的私信只能被一个人看到。因此，你不应通过 Spigot 私信发送帮助请求、建议或错误报告。2020年6月28日之后收到的任何包含此类主题的私信都将被忽略。

🔧快速指南

• 确保你的物品栏有一个空位，因为 ImageOnMap 会给你一张地图。
• 输入 /tomap URL，其中 URL 是你想要渲染的图片链接（详见下文）。
• 欣赏你的图片！如果需要，你可以将其放入物品展示框来制作精美的海报。

视频教程：

• 德语用户，可以观看此视频（感谢 StarlessMiner）。
• 英语用户，可以观看此视频（感谢 bebosny），或另一个教程（感谢 ltjim007）。

🎮命令与权限

/tomap `<url>`

将图片渲染到地图上，并将地图给予玩家。

• 此命令只能由玩家使用。
• 链接必须完整，请注意聊天栏有 240 个字符的限制。你可以使用 tinyURL 或 bitly 等网址缩短服务。
• 如果你希望图片只显示在一张地图上，请在链接后输入 resize。
• 如果你希望将图片调整到特定数量的地图上，请在 resize 后添加宽度和高度，例如：/tomap url resize 2 4。
• 你可以通过将 /tomap 命令中的 resize 关键字替换为以下选项来更改缩放方法：

- `resize-stretched`：拉伸图片以填满整个表面（图片可能会变形）。

- `resize-covered`：确保图片覆盖整个表面（图片永远不会变形，但边缘部分可能会被裁剪）。

• 权限： imageonmap.new（或旧版 imageonmap.userender，插件将保留此权限）。

/maps

打开一个 GUI 来查看、取回和管理用户的地图。

• 此命令只能由玩家使用。
• 打开一个分页显示的 GUI，列出所有地图。同时会显示一本书，用于查看一些使用统计（创建的地图数量、配额）。
• 用户可以通过左键单击取回地图，或通过右键单击进行管理。
• 地图可以重命名（用于整理）、删除（但之后将无法在游戏中渲染！）或部分取回（针对包含多张地图的海报地图）。
• 权限： imageonmap.list，以及在 GUI 内操作所需的 imageonmap.get、imageonmap.rename 和 imageonmap.delete。

/maptool `<new|list|get|delete|explore|migrate>`

管理地图的主要命令。在日常使用中较少用到。

• 命令名称的含义相当直观。
• /maptool new 是 /tomap 的别名。
• /maptool explore 是 /maps 的别名。
• /maptool migrate 用于在从 IoM <= 2.7 升级到 IoM 3.0 时迁移旧地图。在进行此类迁移时，你必须执行此命令才能取回所有地图。
• 权限：

- `imageonmap.new` 用于 `/maptool new`。

- `imageonmap.list` 用于 `/maptool list` 和 `/maptool explore`。

- `imageonmap.get` 用于 `/maptool get`。

- `imageonmap.delete` 用于 `/maptool delete`。

- `imageonmap.administrative` 用于 `/maptool migrate`。

关于权限

默认情况下，除 imageonmap.administrative 外，所有权限都授予所有人。我们认为在大多数情况下，服务器管理员希望允许每个玩家创建地图图片。

如果你想将此功能限制给特定用户组，请使用权限管理插件来取消（negate）相应权限。

你可以授予用户 imageonmap.* 权限，这是所有用户权限（不包括 imageonmap.administrative）的快捷方式。

⭐配置

# 插件语言。留空：使用系统语言。
# 可用：en_US（默认，回退语言）和 fr_FR。
lang:

# 允许收集关于插件环境和使用的匿名统计信息
# 统计信息可在此公开查看：http://mcstats.org/plugin/ImageOnMap
collect-data: true

# 在地图上渲染的图片会消耗 Minecraft 地图 ID，而地图 ID 只有 32,767 个。
# 你可以限制单个玩家或整个服务器使用 ImageOnMap 的最大地图数量。
# 0 表示无限制。
map-global-limit: 0
map-player-limit: 0

✨更新日志摘要

3.0 版本

这是一个基于 QuartzLib 的完全重写版本，增加了许多功能并修复了许多错误。与旧版本不兼容，旧地图不会加载。需要运行 /maptool migrate 命令来取回它们。

新功能包括：

• 新的 Splatter maps，可一键轻松部署和移除大型海报！
• 地图放入物品展示框后不再有物品标签！
• 国际化支持（目前仅支持法语和英语；欢迎贡献翻译）。
• 地图配额（针对玩家和整个服务器）。
• 新的地图管理器（基于库存界面），用于列出、重命名、获取和删除地图。
• 命令系统改进（集成了帮助和自动补全）。
• 异步地图渲染（渲染大地图时服务器不再卡顿，并且可以排队渲染多个地图！）。
• UUID 管理（需要运行 /maptool migrate）。

3.1 版本

通过为插件的每个操作添加完整的权限集，修复了权限支持。

4.0 预发布 1

• 增加了 1.13.2 和 1.14 兼容性。
• 放弃了对 1.12 及更低版本的兼容性。
• 改进了部分用户界面。
• 增加了将图片调整到特定尺寸的支持：例如 /tomap https://url/image.png resize 2 2 可获得 2×2 展示框的图片。
• 状态消息现在通过行动栏发送，而非聊天栏。
• 重新加入了统计功能（可在 plugins/bStats/config.yml 中退出）。
• 增加了更新检查器。

4.0 预发布 2

• 1.15 兼容性（现在构建于兼容 1.15 的 zLib 版本）。
• 此版本仅兼容 Minecraft 1.15 及更高版本——对于更旧的 Minecraft 版本，请使用 4.0-pre1 或更旧版本。
• 改进了法语的部分翻译（感谢 Gabriel C.）。

4.0 “细微舒适”版本

• 现在可以将地图放置在地面或天花板上。
• 修复了 UTF-8 编码错误，现在能正确显示非英文字符的语言。
• Splatter maps 放置时不再抛出异常。
• 当玩家放置 splatter map 时，同一区域的其他玩家可以看到完整的地图，包括左下角。
• 增加了俄语和德语翻译（感谢 Danechek 和 squeezer）。

4.2.0 “权限与悬念”更新 · 第一部分

• 支持 1.17。
• 现在可以通过权限限制使用/拥有的地图/图片数量（权限 imageonmap.mapLimit.XX 和 imageonmap.imageLimit.XX，其中 XX 是整数，用于定义允许玩家的限制）。
• 增加了受信任图片托管网站的白名单。在 config.yml 中添加 images-hostnames-whitelist 列表，并写入你想要允许的每个 URL 前缀。如果你想允许所有内容，请完全删除或清空 images-hostnames-whitelist 列表。还有一个权限可以绕过白名单：imageonmap.bypasswhitelist。

    images-hostnames-whitelist:
      - i.imgur.com
      - cdn.discord.com

• 图片现在受到保护，防止非玩家交互。（再见了，曾经破坏艺术品的狡猾骷髅！）
• 现在默认情况下，部署地图时物品展示框会变为隐形，移除地图时会恢复可见（有一个权限允许此行为：imageonmap.placeinvisiblesplattermap）。
• 错误修复和优化。
• 移除了迁移器（重新加载或有时加载服务器时不再出错）。
• 修复了使用 resize 0 0 调整大小时的问题。
• 修复了地图加载问题（如果地图不在玩家物品栏中，则完全不会渲染）。
• 为 Paper 端增加了地图加载修复（在 Paper 上地图无法完全渲染的问题）。

4.2.1 “权限与悬念”更新 · 第二部分

• 支持 1.18。
• 修复了由 4.2.0 版本地图加载更改引起的卡顿问题。
• 修复了地图部件无法正常工作的问题。
• 修复了生存模式中消耗地图数量不正确的问题。
• 修复了图片地图文件夹未创建导致的问题。

❓数据收集

我们使用 bStats 来收集关于此插件使用情况的基本数据*。这可以在 plugins/bStats/config.yml 文件中禁用。

• 有关收集内容的完整列表，请参见统计信息页面。