你是否曾想在游戏内的地图上查看图片?ImageOnMap 让你实现这一愿望!(灵感来源于 ImgMap)
功能特性
ImageOnMap 允许你将来自互联网的图片加载到 Minecraft 地图中。
- 从 URL 将图片加载到地图上。支持 PNG、JPEG 和 GIF 格式。
- 这些图片将保存在你的服务器上,并在重启后重新加载。
- 大图会自动切割成多个部分!例如,一张 1024x1024 的图片会被切割成 16 张地图。
- 你的图片会自动居中显示。
- 你可以将地图放入物品展示框中。
本插件是免费软件,遵循 GNU 通用公共许可证(第 3 版或更高版本)。源代码发布在 GitHub 上.
最新版本仅兼容 Minecraft 1.15 及以上版本。
- 对于 Minecraft 1.13 和 1.14,请使用 4.0-pre1。
- 对于更早的版本,请使用 ImageOnMap 3.1(警告:未经 BukkitDev 工作人员审核——如果你不确定,请使用 BukkitDev 这里的 3.0 版本,它是一样的,只是没有权限控制)。
支持与错误报告
如果你需要关于 ImageOnMap 的帮助,首选方式是加入我们的 Discord 服务器。我们提供英语和法语支持。你应该先阅读常见问题解答 (FAQ)!
如果你想报告错误或建议新功能,对我们来说最好的选择是通过 GitHub Issues,请尽可能使用此渠道。如果你绝对无法使用 GitHub,请使用上述支持选项。
我们是 ImageOnMap(及其他项目)背后的团队,Spigot 上的私信只能由一个人阅读。因此请不要通过 Spigot 或 BukkitDev 私信发送求助、建议或错误报告。2020 年 6 月 28 日之后收到的任何包含此类主题的私信都将被忽略。
快速指南
- 确保你的背包中有一个空槽位,因为 ImageOnMap 会给你一张地图。
- 输入 /tomap URL,其中 URL 是你想要渲染的图片链接(见下文章节)。
- 享受你的图片吧!如果需要,你可以将其放置在物品展示框中以制作漂亮的海报。
德语用户,可以观看此视频(感谢 StarlessMiner)
英语用户?(感谢 Arma)
命令与权限
/tomap <url>
渲染图像并将带有该图像的地图给予玩家。
- 此命令只能由玩家使用。
- 链接必须是完整的,不要忘记聊天限制为 240 个字符。
- 你可以使用像 tinyURL 或 bitly 这样的 URL 缩短器。
- 如果你希望图片在一整张地图上显示,请在链接后输入 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.*,因为这是一个快捷方式,代表所有 user 类权限(不包括 imageonmap.administrative)。
配置
# 插件语言。留空表示使用系统语言。
# 可用选项:en_US(默认,备用)和 fr_FR。
lang:
# 允许收集关于插件环境和使用的匿名统计数据
# 统计数据在此公开可见:
collect-data: true
# 渲染到地图上的图片会消耗 Minecraft 地图 ID,而总共只有 32,767 个 ID。
# 你可以限制单个玩家或整个服务器使用 ImageOnMap 的最大地图数量。
# 0 表示无限制。
map-global-limit: 0
map-player-limit: 0
更新日志
3.0
3.0 版本是对原始 ImageOnMap 插件的全面重写,现在基于 zLib,增加了许多新功能并修复了许多漏洞。
新版本与旧版本不兼容,因此你的旧地图将无法加载。请运行 /maptool migrate 命令(作为 op 或在控制台中)以便在新版本中找回这些地图。
新功能包括:
- 新的 Splatter maps,让你只需点击一次即可轻松部署和移除大型海报!
- 不再需要在将地图放入物品展示框时添加物品标签!
- 国际化支持(目前仅支持法语和英语;欢迎贡献翻译)
- 地图配额(针对玩家和整个服务器)
- 全新的地图管理器(基于库存界面),用于列出、重命名、获取和删除你的地图
- 命令系统的改进(集成帮助和自动补全)
- 异步地图渲染(渲染大地图时服务器不会再卡死,并且你可以排队多个地图渲染任务!)
- UUID 管理(这需要运行 /maptool migrate)
3.1
- 通过为插件的每个操作添加完整的权限集,修复了权限支持问题。
4.0 预发布版本 1
- 添加了 1.13.2 和 1.14 兼容性
- 放弃了对 1.12 及更低版本的兼容
- 改进了部分用户界面
- 添加了支持将图片调整至特定大小的功能:你可以执行 /tomap 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 编码错误)。
- 放置泼溅地图时不再抛出异常。
- 当玩家放置泼溅地图时,同一区域内的其他玩家可以看到完整的地图,包括左下角区域。
- 添加了俄语和德语翻译(感谢 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。
代码 (YAML):
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 文件中禁用此项。
Have you ever wanted to view an image on a map ingame? ImageOnMap allows you to do it! (Inspired by ImgMap)
Features
ImageOnMap allows you to load a picture from the Internet to a Minecraft map.
- Loads an image from a URL onto a map. PNG, JPEG and GIF are supported.
- These images will be saved on your server and reloaded at restart.
- Big pictures will be cut automatically into several parts! As example, a 1024x1024 picture will be cut in 16 maps.
- Your image will be centered.
- You can put your map in an item frame.
This plugin is a free software lisensed under the GNU General Public License (version 3 or above). The source code is published on GitHub.
The latest version is only compatible with Minecraft 1.15+.
- For Minecraft 1.13 and 1.14, use 4.0-pre1.
- For older versions, please use ImageOnMap 3.1 (warning: unchecked by the BukkitDev staff—if you're unsure, use 3.0 here in BukkitDev, it's the same but without permissions).
Support and bug requests
If you need help with ImageOnMap, the preferred way is our Discord server. We speak English and French. You should read the FAQ first!
If you want to report a bug or suggest features, by far the best option for us is GitHub issues, which you should use whenever possible. If you absolutely can't use GitHub, use the support options above.
We're a team behind ImageOnMap (and others), and private messages from Spigot can only be read by one person. So you should not send help requests, suggestions or bug reports using Spigot or BukkitDev PMs. Any PM received after June 28, 2020 with any of these topics will be ignored.
Quick guide
- Ensure that you have a free slot in your inventory, as ImageOnMap will give you a map.
- Type /tomap URL, where URL is a link to the picture you want to render (see the section below).
- Enjoy your picture! You can place it in an item frame to make a nice poster if you want.
German speakers, you can watch this video (thanks to StarlessMiner)
English speakers? (thanks to Arma)
Commands and Permissions
/tomap <url>
Renders an image and gives a map to the player with it.
- This command can only be used by a player.
- The link must be complete, do not forget that the chat limit is 240 characters.
- You can use an URL shortener like tinyURL or bitly.
- If you want a picture in one map, type resize after the link.
- If you want to resize to multiple maps, add the witth and height after resize: e.g. /tomap url resize 2 4
- You can change the scaling method by replacing the resize keyword in the /tomap command by:
- resize-stretched to stretch the image to the surface (the image could be distorted); or
- resize-covered to ensure the image covers the whole surface (the image will never be distorted, but some parts may be lost near the borders).
- Permission: imageonmap.new (or imageonmap.userender—legacy, but will be kept in the plugin).
/maps
Opens a GUI to see, retrieve and manage the user's maps.
- This command can only be used by a player.
- Opens a GUI listing all the maps in a paginated view.
- A book is displayed too to see some usage statistics (maps created, quotas).
- A user can retrieve a map by left-clicking it, or manage it by right-clicking.
- Maps can be renamed (for organization), deleted (but they won't render in-game anymore!), or partially retrieved (for posters maps containing more than one map).
- Permission: imageonmap.list, plus imageonmap.get, imageonmap.rename and imageonmap.delete for actions into the GUI.
/maptool <new|list|get|delete|explore|migrate>
Main command to manage the maps. The less used in everyday usage, too.
- The commands names are pretty obvious.
- /maptool new is an alias of /tomap.
- /maptool explore is an alias of /maps.
- /maptool migrate migrates the old maps when you upgrade from IoM <= 2.7 to IoM 3.0. You HAVE TO execute this command to retrieve all maps when you do such a migration.
- Permissions:
- imageonmap.new for /maptool new;
- imageonmap.list for both /maptool list and /maptool explore;
- imageonmap.get for /maptool get;
- imageonmap.delete for /maptool delete;
- imageonmap.administrative for /maptool migrate.
About the permissions
All permissions are by default granted to everyone, with the exception of imageonmap.administrative. We believe that in most cases, servers administrators want to give the availability to create images on maps to every player.
Negate a permission using a plugin manager to remove it, if you want to restrict this possibility to a set of users.
You can grant imageonmap.* to users, as this permission is a shortcut for all user permissions (excluding imageonmap.administrative).
Configuration
# Plugin language. Empty: system language.
# Available: en_US (default, fallback) and fr_FR.
lang:
# Allows collection of anonymous statistics on plugin environment and usage
# The statistics are publicly visible here:
collect-data: true
# Images rendered on maps consume Minecraft maps ID, and there are only 32 767 of them.
# You can limit the maximum number of maps a player, or the whole server, can use with ImageOnMap.
# 0 means unlimited.
map-global-limit: 0
map-player-limit: 0
Changelog
3.0
The 3.0 release is a complete rewrite of the original ImageOnMap plugin, now based on zLib, which adds many features and fixes many bugs.
This new version is not compatible with the older ones, so your older maps will not be loaded. Run the/maptool migrate command (as op or in the console) in order to get them back in this new version.
You will find amongst the new features:
- New Splatter maps, making it easy to deploy and remove big posters in one click!
- No more item tags when maps are put in item frames!
- Internationalization support (only french and English are supported, for now; contributions are welcome)
- Map Quotas (for players and the whole server)
- A new map Manager (based on an inventory interface), to list, rename, get and delete your maps
- Improvements on the commands system (integrated help and autocompletion)
- Asynchronous maps rendering (your server won't freeze anymore when rendering big maps, and you can queue multiple map renderings !)
- UUID management (which requires to run /maptool migrate)
3.1
- Fixed permissions support by adding a full set of permissions for every action of the plugin.
4.0 pre-release 1
- Added 1.13.2 and 1.14 compatibility
- Dropped compatibility with 1.12 and lower
- Improved some UIs
- Added support for images' resize to a specific size: you can do /tomap resize 2 2 to get a 2×2 frames image.
- Status messages are sent in the action bar instead of the chat
- Added back statistics (you can opt-out in plugins/bStats/config.yml)
- Added an update checker
4.0 pre-release 2
- 1.15 compatibility (now building against a 1.15-compatible zLib version).
- This version is only compatible with Minecraft 1.15 and later—for older Minecraft versions, please use 4.0-pre1 or older.
- Improved some translations in French (thanks to Gabriel C.).
4.0
- You can now place a map on the ground or on a ceiling.
- Languages with non-english characters now display correctly (fixed UTF-8 encoding bug).
- Splatter maps no longer throw an exception when placed.
- When a player place a splatter map, other players in the same area see it entirely, including the bottom-left corner.
- Added Russian and German translations (thx to Danechek and squeezer).
4.2.0 The permission and cliffhanger update ⋅ Part I
- 1.17 support.
- Permissions to limit the number of map/image used/owned is now available. (permissions imageonmap.mapLimit.XX and imageonmap.imageLimit.XX where XX is an integer and will define the limit allowed for the player).
- Added a whitelist for trusted image hosting websites. Add an images-hostnames-whitelist list in config.yml, and write every URL prefix you want to allow. If you want to allow everything, remove the images-hostnames-whitelist list entirely, or empty it. There is also a permission to ignore the allow list: imageonmap.bypasswhitelist.
Code (YAML):
images-hostnames-whitelist:
- i.imgur.com
- cdn.discord.com
- Images are now protected against non player based interaction. (Bye bye sneaky skeleton that used to grief art!)
- Now by default when deploying a map the item frame turn invisible and returned to visible hen removing the map from the frame (there is a permission to allow this behavior: imageonmap.placeinvisiblesplattermap).
- Bug fixes & optimizations.
- Dropped migrator (no more error when reloading or when sometimes loading the server).
- Fixed an issue when resizing with resize 0 0.
- Fixed a map loading issue. (map did not render at all if they weren't in a player inventory.
- Added a fix for map loading on paper. (map did not render fully on paper).
4.2.1 The permission and cliffhanger update ⋅ Part II
- 1.18 support.
- Fixed a lag issue caused by the map loading changes of 4.2.0.
- Fixed an issue with map part not working properly.
- Fixed an issue in survival where an incorrect amount of map were consumed.
- Fixed an issue where image map folder was not created and cause issues.
Data collection
We use bStats to collect basic data about the usage of this plugin*. This can be disabled in the plugins/bStats/config.yml file.
评论 0
登录后参与评分
还没有评论,来抢沙发吧