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

![](https://266787837-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FboMbJARK6mMvr7qs63rq%2Fuploads%2FckLvLcrDhIJ8XQxm1kvb%2Fimage.png?alt=media\&token=ba4c719a-0e8e-4633-a34d-20c84917cd3f)

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

![](https://266787837-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FboMbJARK6mMvr7qs63rq%2Fuploads%2FPsDg0DMg6wDWniYAqPuM%2Fimage.png?alt=media\&token=c4a81793-5208-422a-8cba-ec0e01315f11)

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

![](https://266787837-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FboMbJARK6mMvr7qs63rq%2Fuploads%2FNBWvmShFLnQCEgdCc64y%2Fimage.png?alt=media\&token=a40e39c9-c5bd-4d1c-88bc-e80e6e100c1a)

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

![](https://266787837-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FboMbJARK6mMvr7qs63rq%2Fuploads%2FJvBqK7h3MTZVo4K0nXch%2Fc6d4d11d0813ffe0c5df4a3d25ac57afd9184699.gif?alt=media\&token=61b01909-e658-4ee2-9600-6ab0f3048320)

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