Mapify
Mapify is a plugin that is used to convert your images into Minecraft maps that can be placed in item frames or held in hand.
To install the plugin, you need to add it into your plugins/ folder
and start the server. This will generate a config.yml that you
can change and then reload with /mapify reload.
For support, join my Discord: https://discord.gg/qsUP2t5VpW
Original photo is "brown and black mountain under white clouds" by Tetiana Grypachevska
Commands
There are two commands: /mapify and /refreshmaps.
/mapify
Usage: /mapify <url> [dimensions]
This will take a url and convert it into a set of maps, depending on the dimensions.
Dimensions are provided using the format WIDTHxHEIGHT (in terms of blocks).
Your images will be stretched to fit into the desired size.
/mapify reload
Reload config file
/refreshmaps [radius]
Refresh the maps in your inventory or in item frames within a given radius.
Config
- Configurable whitelist using raw strings or regular expressions.
- Regular Expressions are in the form of
REGEXP:.*\.example\.com - Whitelist can be treated as a blacklist with the
whitelist-is-blacklistfield.
- Regular Expressions are in the form of
- Configurable cooldown
- Https only toggle
Permissions
mapify.command.mapify- Permission to use the/mapifycommand - Default: OPmapify.command.mapify.reload- Permission to use the/mapify reloadcommand - Default: OPmapify.command.refreshmaps- Permission to use the/refreshmapscommand - Default: OPmapify.operator- Permission to determine whether mapify should treat a player as an operator - Default: OP
FAQ
Error message of "This is not a valid domain..."
By default, the whitelist in the config.yml needs to have
every domain from which a map should be allowed to be loaded. If you're
a server admin, you can run /mapify config whitelist add <domain> as
suggested in the command.
This is to help with security on your server as having untrusted domains
can allow users to download malicious software on your server. If you
don't want this protection, set whitelist-disabled to true in the
configuration.
Error message of "An internal error occurred while attempting to perform this command"
Please join my Discord and give me the following information:
- The large error message that was printed in the server console
- The output of
/version - The version of Mapify that you are using
- Add Non-Op whitelist config option (gives
/mapifyto all players) - Add config option to disable the whitelist
- Fix tab completion of
/mapify - Add tab completion for the
/mapify configsubcommand - Let the user know the error when failing to fetch an image
- Add grid to map lore to show placement within the grid
- Add command to whitelist a site and errors to use it
- Periodically save the plugin data (every 5 minutes if changed)
- Log a better error when the URL is invalid
- Updates to the caching
- A touch more efficient
- No more error when the cache is cleared
- Add cooldown for the
/mapifycommand - This can be modified in the config using
cooldownandop-cooldown. - Add
max-sizefor the/mapifycommand - This can be modified in the config using
max-size. - Add
mapify.operatorpermission which is used to control whether the player's cooldown is theop-cooldownor thecooldown. - Add
/mapify reloadto reload the config - Uses the
mapify.command.mapify.reloadpermission
- Add the ability to save images to disk (off by default)
- This allows one to save from a temporary url
- Note: This can use a more storage than before
- Clears the image cache every hour, making it more memory efficient.
- Add
debug-loggingconfig option to remove the extraneous logs that were present (off by default)
