> For the complete documentation index, see [llms.txt](https://info.unitedlands.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://info.unitedlands.net/sponsor-mechanics/image-maps.md).
# Image Maps
Find out what image maps are and how to use them.
This perk and relevant add-ons can be purchased on the store
***
## Description
The image map perk allows you to take an image from the internet and create a custom map art item out of it. These can be placed around your town to add further depth of detail to any build - the possibilities are endless!
If you want to add even further customisation, we have an animated add-on perk that allows you to **utilise GIFs that are animated in-game!**
Billboards, posters, art, carpets, and more are all within your grasp with this perk.
💾 Supported File Types
**Standard** image maps can be made using the following file types:
* PNG, JPEG, and WEBP.
**Animated** image maps use:
* GIF (limited to 20fps).
🖼️Size and Placement
* Define a custom heigh and width (in blocks) of the image map, up to 10x10.
* Images that cover multiple blocks can be combined into one placeable item, or kept as separate pieces.
* Images placed onto invisible item frames will have transparent backgrounds, if the original image has one.
* If you select an item frame with `/if select`, you can run many image map related commands directly onto the selected frame.
🗺️ Cost
Creating an image map will cost 1 empty map item per block covered.
* For example, a 1x1 image will cost 1 empty map, and a 3x3 will cost 9.
🖥️ Commands
* `/if create [Name] [Image Link] [Width] [Height]` - Create a new image map.
* Add 'combined' at the end to create a combined map.
* Add 'selection' at the end to run the command on the selected frame.
* `/if select` - Select the item frames to run commands on.
* `/if overlay [Name] [Image Link]` - Create a new image map as an overlay on a held vanilla map.
* Add 'selection' at the end to run the command on the selected frame.
* `/if clone [Existing Name] [New Name]` - Create a copy of an existing image map under a new name.
* Add 'combined' at the end to create a combined cloned map.
* Add 'selection' at the end to run the command on the selected frame.
* `/if playback [Name] pause` - Toggle pause on or off for an animated image map.
* `/if playback [Name] jumpto [Seconds]` - Jump to a specific second in an animated image map.
* `/if info` - Get information about the image map you are holding.
* `/if get [Name]` - Get a copy of an existing image map.
* Add 'combined' to get the selection as a combined version.
* `/if delete [Name]` - Delete an image map.
* `/if rename [Existing Name] [New Name]` - Rename an existing image map.
* `/if list` - List all of your image maps and their names.
***
## Tutorial
To create your first image map, first get a **direct image link**. This can be done by right-clicking the desired image and selecting *copy image address*. Then, run the command `/if create [Map Name] [Image Link] [Width] [Height] combined`.
Follow this tutorial to create high-quality image maps ready to be displayed in-game!
{% stepper %}
{% step %}
### Get a Direct Image Link
Find the image you want to make in-game and right-click it, select **copy image address**.
{% endstep %}
{% step %}
### Run the Creation Command In-Game
`/if create [Map Name] [Image Link] [Width] [Height] [Combined]`
* \[Map Name] is the saved name of the map for use ingame, if you want to edit, retrieve, or delete.
* \[Image Link] is the direct file URL made in step 1.
* \[Width] and \[Height] are the desired dimensions of the image, in blocks.
* \[Combined] is the combined flag, if you wish for a multi-block image to act as one item. Add the word 'combined' for yes, or leave blank for no.
{% endstep %}
{% step %}
### Place!
If the image link is valid, and you entered the command correctly, you will receive a map item.
Image maps must be placed into item frames, visible or invisible.
For larger, multi-block maps, ensure you have enough frames to cover the desired dimensions and place in the **top-left**.
{% endstep %}
{% endstepper %}
***
## Rules
Though this is a sponsor perk, there are still rules and restrictions you must follow when using the feature. Breaching any of these may result in punishments - including **removal of the perk entirely**. There are no refunds so ensure you understand these **before** buying.
1. Follow server-wide rules regarding content - **inappropriate uses are not allowed**.
2. You may use image maps freely within your town and with other players that have same perk. You may **not** give them to players without the perk.
3. You may not sell or donate image maps services or items to any players in any capacity.
.gif?alt=media&token=9ab3ea52-392c-4560-9d77-0cd8e10624d8){kind=link}