> 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

The following article has information related to the two Image Map related perks - standard and animated. Standard image maps can be purchased from the [store](https://shop.unitedlands.net/category/250289) at a cost of €10, and animated image maps can be purchased as an addon to the standard perk for an additional €5. 

## Standard Image Maps

Image maps allow you to place any\* image you want onto a map and have it displayed on the server. Useful for players who want to add the most amount of detail to their build or that just want a bit of fun.

### Features 

* Can define a custom height and width of the image map up to 10x10.
* Can overlay a transparent image on to existing vanilla maps.
* Large, multi-image maps can be used as a single item.
* If you have the invisible item frames upgrade, image maps with a transparent background can be used.

### Restrictions and Specifications

* PNG, JPEG, and WEBP are supported.

## Animated Image Maps

These are special image maps that are animated.

### Features

* Everything mentioned previously but can also be animated!

### Restrictions and Specifications

* PNG, JPEG, WEBP, and GIFs are supported.
* All GIFs are limited to 20fps.

## 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`. 

\
Where:

* \[Map Name] is the name of the image map.
* \[Image Link] is the direct image or gif URL.
* \[Width] is the desired width of the image map, in blocks.
* \[Height] is the desired height of the image map, in blocks.
* *Optional*, add the word 'combined' at the end of the command if you have a multi-image map and would like it to act as one item.

If the image link is valid, and you have entered the command correctly - you will receive a map item. Now simply put it into an empty item frame and have your map displayed! If you are using a combined map, use the **top-left** item frame to place the whole thing. Creating an image map will cost one empty map per item frames used. 

![](/files/UXgfKHLRLyaBZ6azk58v)

> Right click the desired image and select 'copy image address'.

![](/files/bH9nfEqUcVUY48nyTAzF)

> Example command of making a 3x3 combined map titled 'United Lands'. 

![](/files/x7sWVLTVWcPYkC8RI8b1)

> Example of a combined image map on invisible item frames.

![](/files/pZWMzghd7CpD19j2CtLt)

> Example of an animated image map. (Image credit to LOOHP on Spigot)

## 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 maps are not allowed**.
2. You may distribute maps freely to members of your town and other players with the same perk. You may **not** give them to players without the perk.
3. You may not sell maps to any players in any capacity - they must all be gifts.

## Commands

* `/if select` - Select the item frames to put an image map on.
* `/if create [Name] [Image Link] [Width] [Height]` - Create a new image map.
* `/if create [Name] [Image Link] selection` - Create a new image map and put it directly onto selected item frames.
* `/if create [Name] [Image Link] [Width] [Height] combined` - Create a new combined image map.
* `/if overlay [Name] [Image Link]` - Create a new image map as an overlay on a held vanilla map.
* `/if overlay [Name] [Image Link] selection` - Create a new image map as an overlay on a vanilla map in the selected frames.
* `/if clone [Existing Name] [New Name]` - Create a copy of an existing image map under a new name.
* `/if clone [Existing Name] [New Name] selection` - Create a copy of an existing image map and put it directly into selected item frames.
* `/if clone [Existing Name] [New Name] combined` - Create a copy of an existing image map as a combined map.
* `/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.
* `/if get [Name] combined` - Get a copy of an existing image map 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.