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

View Now

---

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!

1

Get a Direct Image Link

Find the image you want to make in-game and right-click it, select copy image address.

2

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.

3

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.

---

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.